Récupération des interventions

Modalités techniques

Comment récupérer les mises à jour d'intervention ?

Webhook

IntentPlatform met à disposition un mécanisme de webhook (à destination des services d'information des tiers) permettant d'être notifié dès qu'une intervention est transmise ou qu'une mise à jour de la demande a eu lieu.
 Plus d'informations sur le webhook 

Polling

IntentPlatform vous permet de mettre en place un mécanisme de polling afin de récupérer les nouvelles demandes d'intervention et leur mise à jour par interrogation régulière des APIs d'intentPlatform.
Nous recommandons l'utilisation des webhook pour récupérer les demandes d'intervention afin de garantir une expérience la plus temps réel possible et pour de meilleurs performances. Toutefois, il est recommandé de mettre en place un système de polling afin de s'assurer que vous récupérez bien toutes les demandes. Par exemple, un polling toutes les 24h ou 48h, qui contrôle que vous n'êtes pas passé à côté d'une demande ou au cas où le webhook aurait été défaillant.

Le JSON récupéré

Que vous passiez par un webhook ou un polling, vous allez récupérer un JSON avec l'intégralité des informations. Au sein de ce JSON certaines informations sont primordiales :
  • reference : référence de la demande d'intervention (ticket).
  • issuer : entité ayant créé la demande d'intervention (ticket)
  • logs : rubrique regroupant toutes les étapes du ticket.

Qu'est-ce qu'un Log ?

Un log traduit une étape d'une intervention. Toutes les étapes de l'intervention (création, planification, début/fin d'intervention, annulation, clôture, etc.) seront disponibles dans la rubrique logs du json que vous récupérerez.

Les champs essentiels d'un log

  • issuer : entité ayant créé le log
  • reference : référence du ticket où le log est posté.
  • description : commentaire associé au log
  • contacts : contact(s) associé(s) au log
  • location : rattachement patrimonial du log (soit à une référence ou à un adresse)
  • status et event : état du ticket
Vous trouverez tous les événements disponibles dans notre  documentation en ligne .

Status / event essentiels

  • Réception de la demande d'intervention = open/acknowledged
  • Annulation d'une demande d'intervention = denied / canceled
  • Planification de la demande = open/planned
  • Démarrage de l'intervention = pending/start
  • Fin de l'intervention = pending/end
  • Clôture de l'intervention = closed/done
Vous trouverez tous les événements disponibles dans notre  documentation en ligne .

Déroulé fonctionnel


https://slite.com/api/files/dH78IG1MJ1p7Tq/diagrammes%20de%20se%CC%81quence%20interventions%20(20).jpg?apiToken=eyJhbGciOiJIUzI1NiIsImtpZCI6IjIwMjMtMDUtMDQifQ.eyJzY29wZSI6Im5vdGUtZXhwb3J0IiwibmlkIjoiUHVaYm4tb1FsWnhQXzIiLCJpYXQiOjE3MjkwOTIzODMsImlzcyI6Imh0dHBzOi8vc2xpdGUuY29tIiwianRpIjoiUllWNnBmRVlPMjNSTUgiLCJleHAiOjE3MzE2ODQzODN9.3s0Xpb7A5BN6G9TnV6WXwqKNCSkjCUmaGBqcV3YCoyw
Création de la demande (1)
Une demande d'intervention est créée sur intentPlatform ou sur un outil connecté à intentPlatform.

Réception de la demande
Le prestataire reçoit la demande d'intervention, il publie sur Intent un accusé de réception de la demande

Interventions (3-4-5-6)
Le prestataire la planification et l'intervention en transmettant chacune des étapes sur intentPlatform.

Clôture (7)
La demande est clôturée et l'intervention validée