Webhooks sortants

Vos systèmes sont prévenus à l’instant où ça se produit

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

  • 31 événements
  • Signature HMAC-SHA256
  • Nouvelles tentatives espacées

Dernière mise à jour:

Tous les événements auxquels vous pouvez vous abonner

Abonnez chaque endpoint aux seuls événements qui le concernent, au lieu de tout recevoir et de filtrer de votre côté.

Contacts et pipeline

4
  • contact.created
  • contact.updated
  • contact.deleted
  • pipeline.stage_changed

Messagerie

3
  • message.sent
  • message.received
  • sequence.completed

Séquences de prospection

4
  • outreach.step.sent
  • outreach.replied
  • outreach.completed
  • outreach.unsubscribed

Affaires

5
  • deal.created
  • deal.updated
  • deal.stage_changed
  • deal.won
  • deal.lost

Tâches

2
  • task.created
  • task.completed

Finances

4
  • invoice.created
  • invoice.paid
  • finance.transaction.created
  • subscription.changed

Service d’assistance

4
  • support.ticket.created
  • support.ticket.updated
  • support.ticket.resolved
  • support.ticket.breached

Comptes publicitaires

5
  • ads.ad.disapproved
  • ads.budget.exhausted
  • ads.spend.anomaly
  • ads.billing.problem
  • ads.campaign.status_changed

Les détails de fiabilité, peu glamour, qui décident de votre confiance

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.

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.

Nouvelles tentatives espacées

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.

Un journal des envois lisible

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.

Abonnement par événement

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.

Plusieurs endpoints

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.

Testez avant de vous y fier

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.

Les dépassements de SLA inclus

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.

Toute l’activité, pas seulement les contacts

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.

Associés à l’API REST

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.

À quoi servent les webhooks sortants

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.

Vérifier qu’un envoi vient bien de nous

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.

Ce qui se passe quand votre endpoint est hors service

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.

Quelle offre il vous faut

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.

Questions fréquentes

Trente et un, qui couvrent les contacts et les étapes de pipeline, la messagerie, les séquences de prospection, les affaires, les tâches, les factures et transactions, les abonnements, les tickets du service d’assistance dont les dépassements de SLA, et les alertes des comptes publicitaires comme une publicité refusée ou un budget épuisé.
Chaque envoi est signé en HMAC-SHA256 avec le secret de votre endpoint. Recalculez la signature à partir du corps brut et comparez-la en temps constant ; rejetez tout ce qui ne correspond pas.
Les envois en échec sont retentés à intervalles croissants au lieu d’être abandonnés, et le journal des envois affiche chaque tentative avec la réponse de votre endpoint. À cause de ces nouvelles tentatives, votre gestionnaire doit être idempotent.
Oui, jusqu’à vingt, chacun avec son propre secret et ses propres abonnements aux événements : chaque système reçoit son propre flux.
Non. Les webhooks sortants sont une fonctionnalité de l’offre Business, avec les clés API et l’API REST publique. Le serveur MCP est disponible dans toutes les offres. Les prix actuels figurent sur la page des tarifs.
Utilisez les intégrations Zapier ou n8n. Elles consomment les mêmes événements et vous permettent de les acheminer vers d’autres applications sans rien écrire ni héberger.

Prêt à l’emploi

Arrêtez d’interroger pour détecter les changements

Les webhooks et l’API REST sont inclus dans l’offre Business.

Offre Free gratuite à vie · Conçu pour le RGPD · Sans carte bancaire