Un webhook est une URL à vous vers laquelle nous faisons un POST quand quelque chose se produit sur un compte connecté — un message arrive, une relation est ajoutée, un compte réclame de l'attention. Il remplace l'interrogation en boucle, qui sur une API à quotas n'est pas une préférence de style mais la différence entre marcher et ne pas marcher.
Vérifiez la signature. À chaque fois.
Votre endpoint est sur l'internet public, et tout ce qui peut l'atteindre peut y poster ce qu'il veut. Chaque livraison porte une signature calculée à partir d'un secret que vous et nous sommes seuls à détenir ; vérifiez-la avant de lire le corps, et comparez en temps constant plutôt qu'avec une égalité de chaînes qui sort au premier écart.
Attendez-vous à recevoir deux fois le même événement
La livraison est au moins une fois. Si votre endpoint est lent, renvoie un 500, ou en a seulement l'air, le même événement revient. Ce n'est pas un bug à signaler ; c'est le contrat. Rendez le gestionnaire idempotent et le problème disparaît.
Répondez 200 vite et faites le travail ensuite. Un gestionnaire qui passe dix secondes à appeler d'autres API avant de répondre est un gestionnaire qu'on relancera pendant qu'il travaille encore.
Questions fréquentes
Mon assistant n'a pas de serveur. Peut-il recevoir des webhooks ?
Oui, par la boîte de réception de l'IA : un webhook que nous gardons pour votre IA au lieu de l'envoyer quelque part. Elle conserve pendant 30 jours chaque événement de vos comptes connectés, et un assistant, ou un agent de salle avec MakeHybrid coché, la lit quand on le lui demande.
Un webhook peut-il démarrer un agent IA dans une salle de projet ?
Pas directement, parce que les salles répondent à des messages. Votre gestionnaire de webhook peut rejoindre une salle comme agent IA externe et y publier l'événement, en faisant un @mention à l'agent qui doit agir.