# Les webhooks de Kolinea : vos outils prévenus dès qu’un dossier bouge

> Une pièce arrive, un client répond, un dossier est clos : Kolinea prévient l’adresse de votre outil, par un envoi signé qui ne contient que des identifiants.

## 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](/fr/integrations/api), 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](/fr/features/api-et-integrations).

## Ce que vous pouvez faire

- Ê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

## Mise en route

1. Dans les paramètres de votre espace, rubrique Développeurs, ajoutez l’adresse HTTPS qui recevra les envois.
2. Choisissez les événements à recevoir, puis gardez le secret de signature dans votre outil.
3. Envoyez un essai depuis la même page, et vérifiez la signature de chaque envoi avant de le traiter.

## Limites

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