Aller au contenu

🔌 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

  1. Dans le bloc « 1. Une clé d'API pour relier un autre logiciel », cliquez sur + Créer une clé d'API.
  2. 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 »).
  3. 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

  1. 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/…).
  2. 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.
  3. Copiez le secret de signature affiché (une seule fois — voir « Signature » plus bas).
  4. 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éé ».

  1. Webhooks → Custom webhook (l'adresse ajoutée dans Epsylon).
  2. Filtre : type = customer.created.
  3. Le module de votre CRM qui crée un contact : nom = data.firstname data.lastname (ou data.company pour un professionnel), e-mail = data.email, téléphone = data.phone.
  4. (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 /customers avec external_id. Si la fiche existe déjà, Epsylon répond 409 avec duplicate_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 »).

  1. Quand une affaire de votre CRM arrive à l'étape « Devis », un scénario crée le devis brouillon dans Epsylon : POST /quotes avec le client, les lignes, et external_id = l'identifiant de l'affaire (crm-affaire-{{id}}). Le vendeur le complète et l'envoie depuis Epsylon.
  2. Quand le client accepte le devis depuis le lien reçu par e-mail, Epsylon envoie quote.accepted : filtre type = quote.accepted, puis le module de votre CRM qui met à jour une affaire (identifiant tiré de data.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 ».

  1. Webhooks → Custom webhook, filtre type = invoice.paid.
  2. 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.
  3. Le PDF est disponible à l'adresse data.pdf_url, en GET avec 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 : 401 clé absente ou invalide · 403 permission manquante · 409 doublon (avec duplicate_id) · 422 même Idempotency-Key réutilisée pour une autre requête · 429 limite 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.