Un Webhook envoie les détails d'un événement de votre compte ActiveTrail, comme l'ajout d'un contact à un groupe ou une nouvelle commande, à une URL de votre serveur dès qu'il se produit.
Configurer un Webhook
-
Allez dans Intégrations → Webhooks.
-
Choisissez un type d'événement.
-
Saisissez un nom et l'URL qui reçoit le Webhook.
-
Choisissez le format : JSON ou FromUrlEncoded.
-
Facultatif : cliquez sur Paramètres pour ajouter vos propres en-têtes ou champs (voir Les paramètres des Webhooks).
-
Cliquez sur Test pour envoyer des données d'exemple à l'URL, puis sur Ajouter.
Vos Webhooks sont listés sous Vos Webhooks, par type d'événement. Utilisez l'interrupteur pour activer ou désactiver un Webhook, Test pour envoyer des données d'exemple et Supprimer pour le supprimer.
Webhooks depuis une automation : les Webhooks de type Étape de l'automation sont envoyés depuis l'étape Notifier quelqu'un d'une automation. Cochez Utiliser le webhook suivant et choisissez le Webhook (ou Créer nouveau).
Types d'événements
| Type d'événement | type dans les données |
|---|---|
| Changements contact | contact updated
|
| Changements manuels contact | contact updated
|
| Contact mis à jour | contact updated
|
| Étape de l'automation | automation step
|
| Contact ajouté au groupe | contact joined a group
|
| Contact retiré du groupe | contact removed from a group
|
| Contact désinscrit | contact unsubscribed
|
| Inscription sur une landing page | landing page sign-up
|
| Formulaire d'inscription | form sign-up
|
| Le contact a rejoint une liste de diffusion | contact joined a mailing list
|
| Le contact a été retiré d'une liste de diffusion | contact removed from a mailing list
|
| Commande créée / Commande mise à jour | order created / order updated
|
| Prospect créé / Prospect mis à jour | lead created / lead updated
|
| Opportunité créée / Opportunité mise à jour | opportunity created / opportunity updated
|
| Réponse WhatsApp reçue | whatsapp reply
|
| Réponse SMS reçue | (aucun) |
La requête
-
ActiveTrail envoie une requête POST avec l'en-tête
User-Agent: ActiveTrail/1.3. -
JSON :
Content-Type: application/json. Le corps est une liste (tableau) avec un objet par événement. -
FromUrlEncoded :
Content-Type: application/x-www-form-urlencoded. Le corps a un seul champ,data, dont la valeur est l'objet de l'événement en JSON. -
Test envoie des valeurs d'exemple. Pour les commandes, les prospects et les opportunités, le test envoie les noms des champs avec des valeurs vides.
Événements contact
Tous les événements contact envoient les mêmes champs. Exemple (Inscription sur une landing page, champs personnalisés abrégés) :
[{"type":"landing page sign-up","externalId":"LP_2d904901-b0a1-4b0d-a3cd-203c1c886055","externalName":"LP_43160","contactId":229988056,
"contactFields":{"state":"Active","email_status_date":"2026-10-31T08:35:39","sms_state":"Active","sms_status_date":"2026-10-31T08:35:39",
"email":"jane@example.com","sms":"","firstName":"Jane","lastName":"Doe","fax":"","zipcode":"","phone1":"","phone2":"","street":"","city":"",
"ext1":"","ext2":"", … ,"ext25":""}}]
-
type: l'événement (voir le tableau). -
externalId,externalName: l'ID externe et le nom externe du contact. Pour les inscriptions sur une page de destination :LP_<number>etLP_<page ID>. -
contactId: l'ID du contact dans ActiveTrail. -
contactFields:stateetsms_statesont le statut e-mail et le statut SMS, par exempleActive,DoNotMail(Non opt-in) ouUnsubscribed;email_status_dateetsms_status_dateindiquent quand chaque statut a été défini. Viennent ensuite les champs du contact (e-mail, SMS, nom, adresse, téléphones) et les champs personnalisésext1àext25.
Étape de l'automation
Les mêmes champs que les événements contact, plus automationId, automationName et lastStepResults (une description de la dernière étape du contact).
Commandes, prospects et opportunités
Exemple (Commande créée) :
[{"type":"order created","orderId":"1002","orderName":"Order 1002","externalId":"cust-1","externalName":"my-store",
"firstName":"Jane","lastName":"Doe","email":"jane@example.com","mobile":null,"netAmount":100.0,"tax":17.0,"coupon":"SAVE10",
"quantity":1,"totalAmount":117.0,"address":"1 Main Street","city":"Tel Aviv",
"products":[{"id":"MUG-01","name":"Mug","quantity":1,"unitprice":100.0,"totalprice":100.0,"category":"Home","brand":"Demo", …}],
"purchaseDate":"2026-10-31T06:15:39.00Z","lastUpdate":"2026-10-31T06:15:40.59Z","purchaseType":"Online","status":"Completed",
"storeId":0,"locationType":"Unknown","ext1":null, … ,"num1":null, … ,"date1":null, …}]
Les prospects et les opportunités envoient les mêmes champs, avec leadId/leadName ou opportunityId/opportunityName à la place de l'ID et du nom de la commande, et expectedPurchaseDate à la place de purchaseDate. Les champs correspondent à ceux de l'API commerce et sales lifecycle.
Réponses WhatsApp et SMS
-
Réponse WhatsApp reçue :
type,campaignId,crmUserId(l'ID du contact),mobile,firstName,lastName,email,replyetdate. -
Réponse SMS reçue :
campaignId,crmUserId,mobile,reply,dateetcustomUserField.