Webhooks

Les événements sont classés par groupes : Contacts, Conversations, Messages, Transferts à votre équipe, AI agent, Réservations, Rappels, Commandes, Produits, Appels, Campagnes, Formulaires, Compte et canaux, et Paramètres de l’espace de travail. Ouvrez un groupe et cochez des événements individuels, ou cliquez sur Tout sélectionner pour prendre tout le groupe. Vous ne savez pas où se trouve quelque chose ? Tapez dans le champ de recherche, par exemple « booking » ou « tag ». Touchez n’importe quel événement pour voir un exemple exact de ce qu’Entagl enverra. Certains événements vous permettent aussi de choisir leur source, afin que vous puissiez recevoir uniquement les réservations créées par votre AI et ignorer celles que votre équipe a saisies dans le calendrier.

Message entrant et Message sortant se déclenchent pour chaque message. Sur un compte actif, cela peut représenter des milliers de messages par jour. C’est pourquoi Tout sélectionner les ignore : vous devez les cocher vous-même, un par un, à côté d’un avertissement. Activez-les uniquement si l’outil en face peut gérer un tel volume. Si vous voulez seulement savoir quand une conversation commence ou se termine, Conversation ouverte et Conversation fermée sont beaucoup moins fréquents.

Deux interrupteurs déterminent la quantité d’informations client qui sort d’Entagl. Inclure le contenu des messages ajoute ce que les clients ont écrit : messages, notes et résumés d’appel. Inclure les coordonnées ajoute le nom, le numéro de téléphone et l’email du client. Les deux sont désactivés par défaut. Vous recevez quand même chaque événement sans eux, avec un ID de contact à la place des détails. Seul le propriétaire de l’espace de travail ou un admin peut les activer, et uniquement si l’outil de destination est autorisé à stocker des données client. Sur un espace de travail HIPAA, aucune donnée client n’est jamais envoyée, quels que soient les interrupteurs.

Les outils et les développeurs peuvent enregistrer leurs propres webhooks via l’API Entagl, et ils apparaissent tout seuls dans Applications connectées. Pour chacun, vous voyez combien d’événements il écoute et quand il en a reçu le dernier. Vous pouvez ouvrir ses Envois récents, le Suspendre et le Reprendre, ou le Supprimer. Les scenarios Make ont leur propre page : Canaux → Make.

Cliquez sur Envois récents pour voir les 50 derniers événements qu’Entagl a tenté d’envoyer, du plus récent au plus ancien. Pour chacun, vous voyez s’il est arrivé, la réponse renvoyée par votre outil (comme 200 ou 500), le nombre de tentatives nécessaires, et quand la prochaine tentative est prévue. Lorsqu’une livraison a définitivement échoué, corrigez le problème de votre côté puis cliquez sur Renvoyer. Entagl l’envoie en quelques secondes.

Si votre outil est indisponible ou renvoie une erreur, Entagl réessaie après 30 secondes, 2 minutes, 10 minutes, 1 heure, 6 heures et 24 heures. Cela fait environ 31 heures avant qu’une livraison soit marquée comme échouée. Si une application connectée échoue pendant 3 jours d’affilée, Entagl la met en pause et envoie une notification au propriétaire de l’espace de travail. Corrigez l’outil, puis cliquez sur Reprendre. Si Make signale que le webhook d’un scénario n’existe plus, Entagl cesse immédiatement de lui envoyer des données.

Chaque requête contient une signature dans l’en-tête X-Entagl-Signature, créée avec votre secret de signature. Votre développeur l’utilise pour prouver que la requête vient d’Entagl et que personne ne l’a modifiée en chemin.

• Les applications connectées et les webhooks créés via l’API envoient t=1767225600,v1=5257a869…. La partie t correspond à l’heure d’envoi, en secondes. Chaque v1 est un HMAC-SHA256 du texte timestamp.body (la valeur t, un point, puis le corps brut de la requête), créé avec votre secret. Rejetez toute requête dont le t date de plus de 5 minutes, afin qu’une ancienne requête ne puisse pas être rejouée. Juste après un changement de secret, vous pouvez voir deux valeurs v1 : acceptez la requête si l’une des deux correspond.
• Le webhook que vous configurez sur cette page envoie sha256= suivi d’un HMAC-SHA256 du corps brut de la requête.