Les webhooks permettent de connecter Tomorro à vos outils internes : vous recevez une requête HTTPS à chaque fois que l'événement de votre choix a lieu sur votre organisation.
Les événements disponibles
Un webhook peut être déclenché par les événements suivants :
Un contrat a été créé
Un contrat a été supprimé
Un contrat a été entièrement signé
Un statut de contrat a été modifié
Un rappel automatique a été déclenché
Un webhook ne se déclenche que pour les contrats que le membre qui l'a créé a le droit de lire, y compris pour les rappels de ces contrats.
Configurer un webhook
Les webhooks se gèrent depuis Mon compte (en bas à gauche), puis Intégrations, puis Webhooks. Cette action nécessite un rôle dont la permission Intégrations porte l'action Gérer. Avec les rôles standard, seul le rôle Administrateur en dispose.
Cliquer sur Ajouter un webhook
Renseigner le Nom du webhook, l'URL de destination et le Type d'évènement
Cliquer sur Créer le webhook
Un Secret est généré à la création : conservez-le, il sert à vérifier l'authenticité des requêtes reçues.
Le format des requêtes, la vérification de la signature et la procédure détaillée sont décrits dans la documentation technique :
Documentation webhooks : https://alpha.developer.tomorro.com/webhooks/overview
Pour l'API REST : Documentation API REST