Clôture de la demande

Un utilisateur clôture la demande d'intervention qu'il a réalisé. Il peut réaliser cette action depuis les interfaces web et mobile d'intentPlatform ou depuis son CRM connecté à intentPlatform.

Réception d'un webhook

Lors de la clôture d'une demande par le demandeur, je reçois un webhook avec "type": "operations:intervention:update"
En tant que prestataire, je réceptionne un webhook m'indiquant qu'un tiers à mis à jour une intervention.
[
  {
    "type": "operations:intervention:update",
    "id": "471b155d-09ac-4ec6-a83a-70b3b8695738",
    "event": {
      "type": "operations",
      "body": {
        "id": "6ca801bb-cae3-43a6-978a-a18216f1f7a8",
        "reference": "contract1_201007151812",
        "contractReference": "contract1",
        "type": "intervention",
        "description": "Nous validons le bon traitement de notre demande",
        "status": "closed",
        "event": "solved",
        "serviceCode": "EAU-CP-9",
        "workType": "corrective",
        "criticalLevel": "3",
        "issuer": {
          "entity": {
            "id": "5e78774dfb9f7e3faec804ec",
            "label": "Gestionnaire"
          },
          "user": {
            "id": "371c6829-2b25-40d7-8d2d-8238537ca146",
            "name": "serviceclient+gestionnaire@intent.tech"
          }
        },
        "operation_url": "https://apisandbox.hubintent.com/api/operations/v2/operations/contract1_201007151812?contractReference=contract1"
      }
    }
  }
]

Je récupère l'intégralité de la demande. 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

L'état de l'intervention est "Clôturée par le demandeur" qui se traduit par status=closed et event=solved. Ces informations sont visibles à la fois dans le webhook et dans le corps du ticket récupéré par l'appel API.

Je peux récupérer de plus amples informations (commentaire, photos, date et heure, etc.) sur le détail de la clôture par le demandeur dans le log en question (status=closed et event=solved) dans la rubrique logs .
{
    "_links": {
        "self": {
            "href": "https://apisandbox.hubintent.com/api/operations/v2/operations/contract1_201007151812?contractReference=contract1"
        },
        "documents:list": {
            "href": "https://apisandbox.hubintent.com/api/documents/v1/documents?elementType=intervention&elementReference=contract1_201007151812"
        },
        "actions:reservation:create": {
            "href": "https://apisandbox.hubintent.com/api/operations/v2/reservations/logs"
        }
    },
    "reference": "contract1_201007151812",
    "description": "Demande dépannage pour fuite d’eau dans la salle de bain",
    "criticalLevel": 3,
    "equipmentStatus": "ok",
    "suggestedProvisionalDate": "2020-10-07T13:18:12.000Z",
    "issuer": {
        "entity": {
            "id": "5e78774dfb9f7e3faec804ec",
            "label": "Gestionnaire",
            "logoUrl": "https://image.freepik.com/vecteurs-libre/modele-ligne-logo-abstrait-colore-simple-immobilier_143546-15.jpg"
        },
        "user": {
            "id": "371c6829-2b25-40d7-8d2d-8238537ca146",
            "type": "user",
            "name": "serviceclient+gestionnaire@intent.tech"
        }
    },
    "contract": {
        "reference": "contract1",
        "label": "Maintenance Multitechnique",
        "topic": "Multitechnique",
        "entities": [
            {
                "id": "5e7875e3fb9f7e3faec804eb",
                "label": "MyPrestataire",
                "logoUrl": "https://image.freepik.com/vecteurs-libre/conception-reparation_24908-54569.jpg"
            },
            {
                "id": "5e78774dfb9f7e3faec804ec",
                "label": "Gestionnaire",
                "logoUrl": "https://image.freepik.com/vecteurs-libre/modele-ligne-logo-abstrait-colore-simple-immobilier_143546-15.jpg"
            }
        ]
    },
    "type": "intervention",
    "service": {
        "code": "EAU-CP-9",
        "originalCode": "EAU-CP-9"
    },
    "workType": "corrective",
    "status": "closed",
    "event": "solved",
    "eventDate": "2020-10-08T16:00:00+02:00",
    "logDate": "2020-10-08T16:00:00+02:00",
    "eventHistory": [
        "requested",
        "acknowledged",
        "planned",
        "start",
        "end",
        "done",
        "solved"
    ],
    "location": {
        "assetReference": "LOGEMENT_011"
    },
    "processingDuration": 2700000,
    "responseTime": 64308000,
    "resolutionDuration": 67008000,
    "contacts": [
        "BEGIN:VCARD\r\nVERSION:3\r\nFN;CHARSET=UTF-8:Pierre DURAND\r\nN;CHARSET=UTF-8:DURAND;Pierre;;;\r\nEMAIL;CHARSET=UTF-8;HOME;INTERNET:serviceclient+gestionnaire@intent.tech\r\nTEL;TYPE=WORK,VOICE:0786220276\r\nREV:2020-10-07T15:18:12+02:00\r\nEND:VCARD"
    ],
    "logs": [
        {
            "issuer": {
                "entity": {
                    "id": "5e78774dfb9f7e3faec804ec",
                    "label": "Gestionnaire",
                    "logoUrl": "https://image.freepik.com/vecteurs-libre/modele-ligne-logo-abstrait-colore-simple-immobilier_143546-15.jpg"
                },
                "user": {
                    "id": "371c6829-2b25-40d7-8d2d-8238537ca146",
                    "type": "user",
                    "name": "serviceclient+gestionnaire@intent.tech"
                }
            },
            "reference": "contract1_201007151812",
            "description": "Demande dépannage pour fuite d’eau dans la salle de bain",
            "contractReference": "contract1",
            "documentUrls": [
                "https://apisandbox.hubintent.com/api/documents/v1/documents/2677f677-2024-47c1-a530-e2588431ddcf/download"
            ],
            "contacts": [
                "BEGIN:VCARD\r\nVERSION:3\r\nFN;CHARSET=UTF-8:Pierre DURAND\r\nN;CHARSET=UTF-8:DURAND;Pierre;;;\r\nEMAIL;CHARSET=UTF-8;HOME;INTERNET:serviceclient+gestionnaire@intent.tech\r\nTEL;TYPE=WORK,VOICE:0786220276\r\nREV:2020-10-07T15:18:12+02:00\r\nEND:VCARD"
            ],
            "creationDate": "2020-10-07T15:18:15+02:00",
            "type": "intervention",
            "serviceCode": "EAU-CP-9",
            "workType": "corrective",
            "status": "open",
            "event": "requested",
            "eventDate": "2020-10-07T15:18:12+02:00",
            "logDate": "2020-10-07T15:18:12+02:00",
            "location": {
                "assetReference": "LOGEMENT_011",
                "assetOwner": "gestionnaire.intent"
            },
            "equipmentWorkingOrder": "not_operational",
            "criticalLevel": 3,
            "suggestedProvisionalDate": "2020-10-07T15:18:12+02:00",
            "photos": [
                {
                    "original": "https://apisandbox.hubintent.com/api/photos/v1/photos/4d04427924f1dc1f0226ecc6d5555f311e9e59a2%2F6fdb538a-bef1-46cb-b4ac-ca00f317f7ad?type=operation",
                    "thumbnail": "https://apisandbox.hubintent.com/api/photos/v1/photos/4d04427924f1dc1f0226ecc6d5555f311e9e59a2%2F6fdb538a-bef1-46cb-b4ac-ca00f317f7ad?type=operation&version=thumbnail"
                }
            ]
        },
        {
            "issuer": {
                "entity": {
                    "id": "5e7875e3fb9f7e3faec804eb",
                    "label": "MyPrestataire",
                    "logoUrl": "https://image.freepik.com/vecteurs-libre/conception-reparation_24908-54569.jpg"
                },
                "user": {
                    "id": "418339ad-29fb-4989-9fa4-0436561d9db0",
                    "type": "client",
                    "name": "Connecteur My Prestataire"
                }
            },
            "reference": "contract1_201007151812",
            "description": "Nous accusons bonne réception de votre demande de dépannage",
            "contractReference": "contract1",
            "creationDate": "2020-10-07T15:34:12+02:00",
            "type": "intervention",
            "serviceCode": "EAU-CP-9",
            "workType": "corrective",
            "status": "open",
            "event": "acknowledged",
            "eventDate": "2020-10-07T15:19:00+02:00",
            "logDate": "2020-10-07T15:19:00+02:00",
            "location": {
                "assetReference": "LOGEMENT_011",
                "assetOwner": "gestionnaire.intent"
            },
            "equipmentWorkingOrder": "not_operational",
            "visitAttempt": 1,
            "criticalLevel": 3
        },
        {
            "issuer": {
                "entity": {
                    "id": "5e7875e3fb9f7e3faec804eb",
                    "label": "MyPrestataire",
                    "logoUrl": "https://image.freepik.com/vecteurs-libre/conception-reparation_24908-54569.jpg"
                },
                "user": {
                    "id": "418339ad-29fb-4989-9fa4-0436561d9db0",
                    "type": "client",
                    "name": "Connecteur My Prestataire"
                }
            },
            "reference": "contract1_201007151812",
            "description": "Planification de l'intervention au 08/10/2020 - 9h",
            "contractReference": "contract1",
            "creationDate": "2020-10-07T15:36:09+02:00",
            "type": "intervention",
            "serviceCode": "EAU-CP-9",
            "workType": "corrective",
            "status": "open",
            "event": "planned",
            "eventDate": "2020-10-08T09:00:00+02:00",
            "logDate": "2020-10-07T15:21:00+02:00",
            "location": {
                "assetReference": "LOGEMENT_011",
                "assetOwner": "gestionnaire.intent"
            },
            "equipmentWorkingOrder": "not_operational",
            "visitAttempt": 1,
            "criticalLevel": 3
        },
        {
            "issuer": {
                "entity": {
                    "id": "5e7875e3fb9f7e3faec804eb",
                    "label": "MyPrestataire",
                    "logoUrl": "https://image.freepik.com/vecteurs-libre/conception-reparation_24908-54569.jpg"
                },
                "user": {
                    "id": "418339ad-29fb-4989-9fa4-0436561d9db0",
                    "type": "client",
                    "name": "Connecteur My Prestataire"
                }
            },
            "reference": "contract1_201007151812",
            "contractReference": "contract1",
            "creationDate": "2020-10-07T15:37:31+02:00",
            "type": "intervention",
            "serviceCode": "EAU-CP-9",
            "workType": "corrective",
            "status": "pending",
            "event": "start",
            "eventDate": "2020-10-08T09:10:00+02:00",
            "logDate": "2020-10-08T09:10:00+02:00",
            "location": {
                "assetReference": "LOGEMENT_011",
                "assetOwner": "gestionnaire.intent"
            },
            "equipmentWorkingOrder": "not_operational",
            "visitAttempt": 1,
            "criticalLevel": 3
        },
        {
            "issuer": {
                "entity": {
                    "id": "5e7875e3fb9f7e3faec804eb",
                    "label": "MyPrestataire",
                    "logoUrl": "https://image.freepik.com/vecteurs-libre/conception-reparation_24908-54569.jpg"
                },
                "user": {
                    "id": "418339ad-29fb-4989-9fa4-0436561d9db0",
                    "type": "client",
                    "name": "Connecteur My Prestataire"
                }
            },
            "reference": "contract1_201007151812",
            "contractReference": "contract1",
            "creationDate": "2020-10-07T15:38:31+02:00",
            "type": "intervention",
            "serviceCode": "EAU-CP-9",
            "workType": "corrective",
            "status": "pending",
            "event": "end",
            "eventDate": "2020-10-08T09:50:00+02:00",
            "logDate": "2020-10-08T09:50:00+02:00",
            "location": {
                "assetReference": "LOGEMENT_011",
                "assetOwner": "gestionnaire.intent"
            },
            "equipmentWorkingOrder": "operational",
            "visitAttempt": 1,
            "criticalLevel": 3
        },
        {
            "issuer": {
                "entity": {
                    "id": "5e7875e3fb9f7e3faec804eb",
                    "label": "MyPrestataire",
                    "logoUrl": "https://image.freepik.com/vecteurs-libre/conception-reparation_24908-54569.jpg"
                },
                "user": {
                    "id": "418339ad-29fb-4989-9fa4-0436561d9db0",
                    "type": "client",
                    "name": "Connecteur My Prestataire"
                }
            },
            "reference": "contract1_201007151812",
            "description": "Résolution du problème. Changement du flexible + joints",
            "contractReference": "contract1",
            "creationDate": "2020-10-07T15:39:31+02:00",
            "type": "intervention",
            "serviceCode": "EAU-CP-9",
            "workType": "corrective",
            "status": "closed",
            "event": "done",
            "eventDate": "2020-10-08T09:55:00+02:00",
            "logDate": "2020-10-08T09:55:00+02:00",
            "location": {
                "assetReference": "LOGEMENT_011",
                "assetOwner": "gestionnaire.intent"
            },
            "equipmentWorkingOrder": "operational",
            "equipmentStatus": "ok",
            "visitAttempt": 1,
            "occupantSignature": "ok",
            "criticalLevel": 3
        },
        {
            "issuer": {
                "entity": {
                    "id": "5e78774dfb9f7e3faec804ec",
                    "label": "Gestionnaire",
                    "logoUrl": "https://image.freepik.com/vecteurs-libre/modele-ligne-logo-abstrait-colore-simple-immobilier_143546-15.jpg"
                },
                "user": {
                    "id": "aab631d7-d7cf-478f-b463-55e646762946",
                    "type": "client",
                    "name": "Connecteur Gestionnaire"
                }
            },
            "reference": "contract1_201007151812",
            "description": "Nous validons le bon traitement de notre demande",
            "contractReference": "contract1",
            "creationDate": "2020-10-07T15:41:00+02:00",
            "type": "intervention",
            "serviceCode": "EAU-CP-9",
            "workType": "corrective",
            "status": "closed",
            "event": "solved",
            "eventDate": "2020-10-08T16:00:00+02:00",
            "logDate": "2020-10-08T16:00:00+02:00",
            "location": {
                "assetReference": "LOGEMENT_011",
                "assetOwner": "gestionnaire.intent"
            }
        }
    ],
    "creationDate": "2020-10-07T15:18:15+02:00",
    "lastUpdateDate": "2020-10-07T15:41:02+02:00"
}