Signature HMAC-SHA256
Chaque envoi porte une signature calculée à partir du corps et du secret de votre endpoint : votre récepteur peut vérifier que la requête vient bien de nous avant d’agir.
Webhooks sortants
Trente et un événements, de la création d’un contact à un engagement de support manqué ou une publicité refusée, envoyés à votre endpoint sous forme de requêtes HTTP POST signées, avec nouvelles tentatives automatiques. Avec l’offre Business. Pas de boucle d’interrogation, pas de tâche cron qui demande si quelque chose a changé.
Dernière mise à jour:
Abonnez chaque endpoint aux seuls événements qui le concernent, au lieu de tout recevoir et de filtrer de votre côté.
N’importe qui peut envoyer un corps JSON en POST. Le signer, le renvoyer en cas d’échec et vous montrer ce qui s’est passé, voilà ce qui le rend utilisable en production.
Chaque envoi porte une signature calculée à partir du corps et du secret de votre endpoint : votre récepteur peut vérifier que la requête vient bien de nous avant d’agir.
Un envoi en échec est retenté à intervalles croissants au lieu d’être abandonné : une fenêtre de déploiement ou une brève panne de votre côté ne fait pas disparaître en silence l’événement qui comptait.
Voyez ce qui a été envoyé, quand, ce que votre endpoint a répondu et en combien de temps. Déboguer une intégration ne se résume plus à se demander si l’événement est parti.
Chaque endpoint s’abonne aux événements qu’il veut. Un service de préparation de commandes qui ne s’intéresse qu’à invoice.paid n’a pas à recevoir puis jeter chaque mise à jour de contact.
Jusqu’à vingt endpoints : un logiciel d’entrepôt, un relais Slack interne et un entrepôt de données peuvent chacun recevoir leur propre flux, avec leur propre secret.
Un événement de test vous permet de vérifier l’endpoint, le contrôle de signature et votre gestionnaire avant qu’un vrai deal.won dépende du bon fonctionnement des trois.
support.ticket.breached se déclenche quand un délai de réponse promis est manqué : c’est l’événement que la plupart des équipes veulent voir dans un canal d’astreinte plutôt que dans un tableau de bord que personne n’ouvre.
Contacts, étapes de pipeline, messages, étapes et réponses de prospection, affaires, tâches, factures, transactions, abonnements, tickets de support et alertes des comptes publicitaires émettent tous des événements.
Le webhook vous signale qu’il s’est passé quelque chose ; l’API REST publique vous permet de lire ou de modifier la fiche concernée. Ensemble, ils remplacent complètement l’interrogation périodique.
Un webhook, c’est Pinlyx qui envoie une requête HTTP POST à une URL que vous contrôlez dès que quelque chose se produit, au lieu que votre code nous demande toutes les quelques minutes s’il s’est passé quelque chose. Trente et un événements sont disponibles, chaque envoi est signé, les échecs sont retentés et le journal montre exactement ce que votre endpoint a répondu.
La différence concrète tient à la latence et au coût. Une tâche d’interrogation lancée toutes les cinq minutes a cinq minutes de retard et gaspille la plupart de ses requêtes. Un webhook arrive en moins d’une seconde, et seulement quand il y a quelque chose à dire.
Chaque endpoint a son propre secret. Nous calculons un HMAC-SHA256 du corps de la requête avec ce secret et l’envoyons dans un en-tête de signature ; votre récepteur le recalcule et compare. Une requête sans signature correspondante doit être rejetée.
Comparez en temps constant plutôt qu’avec une égalité de chaînes classique, et traitez le secret comme un mot de passe : c’est la seule chose qui sépare votre endpoint de quiconque devinerait l’URL.
Une réponse autre que 2xx ou un délai dépassé marque l’envoi comme échoué, et il est retenté à intervalles croissants. Cela couvre les cas ordinaires : un déploiement, un redémarrage, un verrou momentané sur la base de données.
Puisque les nouvelles tentatives existent, votre gestionnaire doit être idempotent. Concevez-le pour que recevoir deux fois le même événement donne le même résultat qu’une seule réception, en général en vous appuyant sur l’identifiant de l’événement. C’est vrai pour tous les systèmes de webhooks, et c’est l’erreur qui se traduit le plus souvent par des fiches en double.
Les webhooks sortants sont une fonctionnalité de l’offre Business, avec jusqu’à vingt endpoints, tout comme l’API REST publique qui va avec. Si vous préférez ne pas écrire de récepteur du tout, les intégrations Zapier et n8n consomment les mêmes événements avec la même offre. Les prix actuels figurent sur la page des tarifs.
Lisez et modifiez les fiches auxquelles renvoient les événements.
Laissez un client IA piloter l’espace de travail.
Les mêmes événements, sans récepteur.
Automatisation auto-hébergée sur les mêmes données.
D’où vient l’événement de dépassement de SLA.
Nombre d’endpoints par offre.
Prêt à l’emploi
Les webhooks et l’API REST sont inclus dans l’offre Business.