🔌 API et notifications (Make, Zapier, n8n…)
Epsylon peut se relier à vos autres logiciels — votre logiciel de suivi commercial (CRM), votre outil d'assistance client… — sans programmation, à travers un outil d'automatisation comme Make (make.com), Zapier ou n8n.
Ces outils fonctionnent par scénarios : quand il se passe ceci dans un logiciel, faire cela dans un autre. Epsylon s'y branche de deux façons :
- Epsylon prévient votre outil dès qu'il se passe quelque chose : un client créé, un devis accepté, une facture payée… Ce sont les notifications automatiques (on parle aussi de « webhooks ») ;
- votre outil lit ou écrit dans Epsylon : retrouver un client, créer une fiche, créer un devis brouillon, marquer un devis « perdu ». C'est l'API (la porte d'entrée d'Epsylon pour les autres logiciels), protégée par une clé.
Il n'y a pas d'application « Epsylon » à installer dans Make : on utilise ses modules standards Webhooks (pour recevoir) et HTTP (pour appeler Epsylon).
ℹ️ Tout se règle dans Paramètres → Intégrations → onglet Services → API et notifications (catégorie Automatisation), par le titulaire du compte, pour le magasin sélectionné en haut de l'écran.
Ce que l'API permet, et ce qu'elle ne fait jamais
| Votre outil peut… | Avec la permission |
|---|---|
| lire les fiches clients du magasin (jamais la pièce d'identité, la date de naissance ni les notes) | Lecture des clients |
| créer ou modifier une fiche client | Création et modification de clients |
| lire les devis, factures, factures d'acompte, avoirs, règlements et télécharger le PDF | Lecture des devis et factures |
| créer un devis brouillon et changer son étape de suivi commercial (en cours, envoyé, relancé, gagné, perdu) | Création de devis brouillons |
| lire les réparations (PEC) : numéro, statut, client, véhicule, dates | Lecture des réparations |
Ce que l'API ne fait jamais : émettre une facture, encaisser, annuler, faire un avoir, supprimer, ni accepter un devis à la place du client. Ces gestes restent dans Epsylon.
Seules les pièces réelles sortent : les factures sont visibles une fois numérotées, et les factures reprises d'un ancien logiciel ne sortent pas.
1. Créer une clé d'API
- Dans le bloc « 1. Une clé d'API pour relier un autre logiciel », cliquez sur + Créer une clé d'API.
- Les cinq permissions utiles (clients, devis, factures, réparations) sont déjà cochées : décochez ce dont votre outil n'a pas besoin, puis nommez la clé (par exemple « Make »).
- Copiez la clé et le secret affichés.
⚠️ Le secret n'est affiché qu'une seule fois. Copiez-le immédiatement.
Points à connaître :
- Une clé = un magasin. Elle ne voit et n'écrit que dans le magasin sélectionné. Pour plusieurs magasins, créez une clé par magasin.
- « Accès complet boutique » (la permission des sites de vente en ligne) ne donne pas accès aux clients, devis, factures ni réparations : ces permissions se cochent une par une.
- Les clés créées ici sont listées dans le même bloc, avec Copier la clé, Révoquer (la clé cesse de fonctionner) et Supprimer.
2. Ajouter une adresse de notification
- Dans Make, créez un scénario qui commence par Webhooks → Custom webhook, et copiez l'adresse qu'il fournit (
https://hook.eu1.make.com/…). - Dans Epsylon, bloc « 2. Adresses de notification », cliquez sur + Ajouter une adresse : donnez-lui un nom, collez l'adresse, cochez les événements à envoyer, puis Créer l'adresse.
- Copiez le secret de signature affiché (une seule fois — voir « Signature » plus bas).
- Dans Make, cliquez sur Redetermine data structure du module Webhooks. Puis, dans Epsylon, choisissez l'exemple voulu dans la liste (« Exemple : Facture payée »…) et cliquez sur Envoyer un essai. Make reçoit un exemple fictif de ce message et apprend sa forme : vous pouvez alors choisir ses champs (numéro, montant…) dans la suite du scénario.
Les événements disponibles
| Événement (dans Epsylon) | Nom technique | Quand |
|---|---|---|
| Client créé | customer.created |
une fiche client est créée |
| Client modifié | customer.updated |
une fiche client est modifiée |
| Devis créé | quote.created |
un devis est créé (y compris par copie ou transformation) |
| Devis envoyé au client | quote.sent |
le devis part par e-mail |
| Devis accepté / refusé par le client | quote.accepted · quote.refused |
le client répond depuis sa page d'accord |
| Facture, acompte ou avoir émis | invoice.issued |
la pièce reçoit son numéro |
| Facture payée | invoice.paid |
la facture (ou facture d'acompte) est soldée |
| Règlement reçu ou remboursé | payment.received |
de l'argent est reçu ou rendu |
| Réparation (PEC) créée | repair.created |
une PEC d'un client est créée |
| Statut d'une réparation changé | repair.status_changed |
le statut d'une PEC change (l'ancien statut est joint) |
💡 Un import de fichier (clients en masse, reprise d'un ancien logiciel) n'envoie aucune notification : sinon, un import de 2 000 fiches enverrait 2 000 messages à votre outil.
Chaque message contient type (l'événement), data (l'objet : client, devis, facture…) et un identifiant unique id. Pour une facture, data.pdf_url donne l'adresse de son PDF (à appeler avec la clé d'API). Un message d'essai a pour type test : un scénario qui filtre sur le type d'événement le laisse donc de côté.
Suivre les envois
Chaque adresse affiche son dernier envoi et le nombre de messages en attente, avec ces boutons :
| Bouton | Effet |
|---|---|
| Envoyer un essai | Envoie tout de suite un exemple fictif de l'événement choisi |
| Historique | Liste des envois : Parti, En attente, Nouvel essai prévu, Abandonné — avec Renvoyer sur un message abandonné |
| Désactiver / Réactiver | Met l'adresse en pause (les messages en attente sont abandonnés, Epsylon vous en donne le nombre avant de confirmer) |
| Nouveau secret | Remplace le secret de signature (à recopier dans votre scénario s'il le vérifie) |
| Supprimer | Supprime l'adresse et son historique |
Bon à savoir :
- Délai : un message part en général dans les 15 à 30 secondes qui suivent l'action.
- Si votre outil ne répond pas, Epsylon réessaie après 1 min, 5 min, 30 min, 2 h, 6 h puis 24 h (environ 33 heures en tout), puis abandonne le message.
- Après 50 abandons d'affilée, l'adresse est désactivée et le titulaire du compte est prévenu par e-mail. Réactivez-la une fois le scénario réparé.
- Changer d'adresse : une adresse ne se modifie pas. Ajoutez la nouvelle, puis supprimez l'ancienne.
- Une panne de votre outil n'empêche jamais de travailler dans Epsylon : les messages attendent leur tour.
3. Exemples de scénarios
Un nouveau client Epsylon est créé dans votre CRM
Événement à cocher : « Client créé ».
- Webhooks → Custom webhook (l'adresse ajoutée dans Epsylon).
- Filtre :
type=customer.created. - Le module de votre CRM qui crée un contact : nom =
data.firstnamedata.lastname(oudata.companypour un professionnel), e-mail =data.email, téléphone =data.phone. - (Recommandé) HTTP → Make a request pour noter dans Epsylon l'identifiant du contact dans votre CRM :
PATCH https://app-epsylon.fr/api/public/v1/customers/{{data.id}}avec le corps{ "external_id": "crm-{{id du contact}}" }.
Grâce à cet identifiant, Make retrouvera plus tard la fiche Epsylon d'un contact de votre CRM : GET /customers?external_id=crm-123.
Dans l'autre sens (un contact créé dans votre CRM devient une fiche Epsylon), utilisez
POST /customersavecexternal_id. Si la fiche existe déjà, Epsylon répond 409 avecduplicate_id, le numéro de la fiche existante : le scénario peut alors la mettre à jour au lieu d'en créer une seconde.
Devis accepté dans Epsylon → affaire gagnée dans votre CRM
Événements à cocher : « Devis accepté par le client » (et, si vous voulez, « Devis refusé par le client »).
- Quand une affaire de votre CRM arrive à l'étape « Devis », un scénario crée le devis brouillon dans Epsylon :
POST /quotesavec le client, les lignes, etexternal_id= l'identifiant de l'affaire (crm-affaire-{{id}}). Le vendeur le complète et l'envoie depuis Epsylon. - Quand le client accepte le devis depuis le lien reçu par e-mail, Epsylon envoie
quote.accepted: filtretype=quote.accepted, puis le module de votre CRM qui met à jour une affaire (identifiant tiré dedata.external_id, statut gagné ;quote.refused→ perdu).
Dans l'autre sens — une affaire perdue dans votre CRM : un scénario appelle PATCH https://app-epsylon.fr/api/public/v1/quotes/{{id du devis}}/pipeline avec { "status": "LOST", "lost_reason": "{{motif}}" }. Le devis passe en « Perdu » dans le suivi des devis d'Epsylon (le module Pipeline devis doit être activé). L'accord du devis, lui, reste toujours au client.
Facture payée → note dans votre outil de suivi client
Événement à cocher : « Facture payée ».
- Webhooks → Custom webhook, filtre
type=invoice.paid. - Le module de votre outil qui ajoute une note sur le contact (ou un commentaire sur sa demande d'assistance), avec par exemple :
Facture {{data.number}} payée — {{data.total_ttc}} € TTC. - Le PDF est disponible à l'adresse
data.pdf_url, enGETavec la clé d'API.
4. Pour la personne qui monte les scénarios
Appeler Epsylon (module HTTP → Make a request)
| Réglage | Valeur |
|---|---|
| Adresse de base | https://app-epsylon.fr/api/public/v1 |
| En-têtes | X-API-Key : la clé · X-API-Secret : le secret |
Pour une création (POST) |
en-tête Idempotency-Key obligatoire : une valeur unique par création, par exemple {{executionId}} ou crm-contact-{{id}} |
| Corps | JSON |
L'en-tête Idempotency-Key évite les doublons : si Make renvoie la même requête après une coupure, Epsylon rend l'objet déjà créé au lieu d'en créer un second.
| Appel | Ce qu'il fait |
|---|---|
GET /customers · GET /customers/{id} |
fiches clients ; filtres email, external_id |
POST /customers · PATCH /customers/{id} |
créer / modifier une fiche (seuls les champs envoyés changent) |
GET /quotes · GET /quotes/{id} |
devis (brouillons compris), avec leurs lignes dans le détail |
POST /quotes |
créer un devis brouillon : lignes par référence d'article (sku — libellé, prix et TVA du catalogue) ou ligne libre (description, unit_price_ht, vat_rate) |
PATCH /quotes/{id}/pipeline |
changer l'étape de suivi : PENDING, SENT, FOLLOWED_UP, WON, LOST |
GET /invoices · GET /invoices/{id} · GET /invoices/{id}/pdf |
factures, acomptes et avoirs émis, montant payé, reste à payer, PDF |
GET /payments |
règlements : argent reçu (direction: "in") ou rendu ("out") |
GET /repairs · GET /repairs/{id} |
réparations (PEC) |
Récupérer « ce qui a changé depuis… » : ajoutez ?updated_since=2026-11-01T08:00:00Z (heure avec fuseau, ou date seule), puis enchaînez les pages avec ?cursor=<next_cursor> jusqu'à has_more: false.
À savoir
- Montants : ils arrivent en texte à 2 décimales (
"123.45"), pour qu'aucun outil ne les arrondisse de travers. Comme partout dans Epsylon, une ligne est calculée à partir du prix TTC : un total HT peut différer de quelques centimes d'un calcul fait à partir du HT. - Champ inconnu : il est refusé (erreur 400) plutôt qu'ignoré, pour qu'une faute de frappe dans un scénario ne passe pas inaperçue.
- Prix du catalogue : une ligne de devis par référence prend toujours le prix et la TVA du catalogue, sans remise. Les remises se font dans Epsylon.
- Limites : 300 lectures et 60 écritures par minute par clé ; 30 PDF par minute.
- Codes de réponse :
401clé absente ou invalide ·403permission manquante ·409doublon (avecduplicate_id) ·422mêmeIdempotency-Keyréutilisée pour une autre requête ·429limite atteinte.
Signature des messages
Chaque notification porte l'en-tête X-Epsylon-Signature: t=<horodatage>,v1=<signature>. La signature est un HMAC-SHA256, calculé avec le secret de l'adresse sur le texte <horodatage>.<corps brut du message> — la même méthode que Stripe. Refusez un message dont l'horodatage a plus de 5 minutes.
⚠️ Si votre scénario ne vérifie pas la signature, gardez l'adresse du webhook Make confidentielle : elle suffit à envoyer de faux messages à votre scénario.