Les webhooks de Kolinea : vos outils prévenus dès qu’un dossier bouge
Ce que vous faites depuis les webhooks
Être prévenu quand un dossier est ouvert, modifié, dupliqué, clos ou rouvert
Être prévenu quand un client répond à une demande, donne un bon pour accord, remplit un formulaire ou fait un choix
Être prévenu quand une pièce arrive, est acceptée ou rejetée, et quand un rendez-vous est confirmé
Suivre les demandes : prise en charge déclarée, délai demandé puis accepté ou refusé, échéance changée
Choisir, adresse par adresse, les événements à recevoir
Brancher les webhooks, étape par étape
Dans les paramètres de votre espace, rubrique Développeurs, ajoutez l’adresse HTTPS qui recevra les envois.
Choisissez les événements à recevoir, puis gardez le secret de signature dans votre outil.
Envoyez un essai depuis la même page, et vérifiez la signature de chaque envoi avant de le traiter.
Prévenu au lieu de demander
Un outil qui veut savoir si un client a répondu peut interroger l’API toutes les cinq minutes. C’est lent, et presque chaque appel revient vide. Avec un webhook, c’est Kolinea qui prévient votre outil, au moment où la chose arrive : une pièce reçue, une demande traitée, un dossier clos.
Vous choisissez les événements utiles adresse par adresse. Une adresse peut ne recevoir que les pièces arrivées, une autre tout ce qui touche aux rendez-vous. Chaque adresse a son propre secret de signature : l’outil qui reçoit les envois vérifie qu’ils viennent de Kolinea avant d’agir.
Des envois qui ne transportent rien de sensible
Chaque envoi ne contient que des identifiants et le lien de l’objet concerné. Votre outil relit le détail par l’API de Kolinea, avec sa clé : il ne lit que ce que cette clé a le droit de lire. Un envoi intercepté ne contient ni nom ni message.
Une publication confidentielle ne déclenche aucun envoi, pas plus que la pièce déposée en réponse.
Ce que vos outils peuvent écouter
Les événements suivent la vie du dossier. Côté dossier : ouvert, modifié, confié à un autre responsable, dupliqué, clos ou rouvert. Côté intervenants : ajoutés, retirés, accès changé. Côté demandes : une réponse, un refus, un bon pour accord, un choix, un formulaire rempli, une prise en charge déclarée, un délai demandé puis accepté ou refusé. Côté pièces : reçues, acceptées ou rejetées. Et les rendez-vous confirmés, les jalons atteints, les contacts créés ou modifiés.
Un journal pour chaque adresse
Kolinea garde la trace de chaque envoi : sa date, son résultat, les nouvelles tentatives. Un envoi qui a échoué est retenté avec un délai qui s’allonge, et vous pouvez le rejouer à la main une fois votre outil réparé. Un essai, envoyé depuis la même page, vérifie qu’une nouvelle adresse répond.
Le reste de ce que l’API permet sur un dossier est décrit sur la page API et intégrations.
Ce que l’intégration ne fait pas
Un envoi ne contient que des identifiants, jamais de nom, d’e-mail ni de texte : votre outil relit le détail par l’API, avec sa clé et dans la limite de ses droits.
Une publication confidentielle, et la pièce qui y répond, ne déclenchent aucun envoi.
Un même événement peut arriver plus d’une fois, et les envois n’arrivent pas forcément dans l’ordre : votre outil reconnaît un doublon à son en-tête webhook-id.
Seules les adresses HTTPS sont acceptées.
Les fonctionnalités en jeu
Vos questions avant de brancher
Une autre question ? Contactez-nous
Chaque envoi est signé selon la norme Standard Webhooks : en-têtes webhook-id, webhook-timestamp et webhook-signature, signature HMAC-SHA256 avec le secret de l’adresse. Vous pouvez changer ce secret à tout moment.
Kolinea retente l’envoi, avec un délai qui s’allonge à chaque tentative. Le journal des envois garde chaque essai, et vous pouvez rejouer un envoi depuis ce journal.
Pour des raisons de sécurité, un envoi ne transporte ni nom, ni adresse e-mail, ni texte. Votre outil lit le message par l’API, avec une clé qui en a le droit.
La liste complète, avec le sens de chacun, figure dans la documentation de l’API et dans le formulaire d’ajout d’une adresse.
Les autres intégrations
Votre prochain dossier, sans rien perdre en route
Pas le bon moment ?
Recevez le lien par e-mail et reprenez plus tard, depuis votre ordinateur.
Un seul e-mail, et votre adresse n’est pas conservée.