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

  1. Allez dans Intégrations → Webhooks.

  2. Choisissez un type d'événement.

  3. Saisissez un nom et l'URL qui reçoit le Webhook.

  4. Choisissez le format : JSON ou FromUrlEncoded.

  5. Facultatif : cliquez sur Paramètres pour ajouter vos propres en-têtes ou champs (voir Les paramètres des Webhooks).

  6. Cliquez sur Test pour envoyer des données d'exemple à l'URL, puis sur Ajouter.

Intégrations → Webhooks : la ligne d'un nouveau Webhook (type d'événement, nom, URL, format, Paramètres, Test, Ajouter) et la liste des Webhooks

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).

L'étape Notifier quelqu'un avec Utiliser le webhook suivant coché et un Webhook choisi

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> et LP_<page ID>.

  • contactId : l'ID du contact dans ActiveTrail.

  • contactFields : state et sms_state sont le statut e-mail et le statut SMS, par exemple Active, DoNotMail (Non opt-in) ou Unsubscribed ; email_status_date et sms_status_date indiquent 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és ext1 à 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, reply et date.

  • Réponse SMS reçue : campaignId, crmUserId, mobile, reply, date et customUserField.