IntentPlatform met à disposition un mécanisme de webhook (à destination des services d'information des tiers) permettant d'être notifié dès qu'une demande d'intervention est transmise ou qu'une mise à jour de la demande a eu lieu.
Informations générales
La configuration du webhook se réalise dans la partie administration de votre entité. Vous devez indiquer l'url sur laquelle vous souhaitez qu'intentPlatform vous transmette le webhook.
Un message de type webhook est émis sur l'url configurée dès lors qu'une demande d'intervention est créée sur intentPlatform et qu'elle vous est destinée ainsi que lorsqu'elle est mise à jour.
Solution technique
Au sein du message reçu sur votre url, vous retrouvez certaines informations de la demande. A l'aide du lien HAL operation_url, vous pouvez directement réaliser un appel API GET /operations/{reference} pour récupérer toutes les données caractérisant la demande d'intervention (description, criticité, localisation, contacts, etc.) et ainsi l'intégrer dans votre système.
Une fois le wehbook reçu, lancement des actions suivantes :
Appel API sur le champ operation_url : GET /operations/{reference}
Appel API pour récupérer les photos
Appel API pour récupérer les documents
Attention, le système de webhooks n'est pas un système de communication de données mais bien de notification de mise à disposition de celle ci. Vous devez mettre en place en parallèle un système de polling toutes les 24h pour être sûrs de bien récupérer toutes les interventions