Récupération des relances et commentaires

Récupération des relances et commentaires

Un utilisateur a la possibilité de publier un commentaire sur une intervention pour indiquer une mise à jour ou effectuer une relance.

Récupération des informations

En tant que prestataire, je récupère les nouveaux tickets et ceux qui ont été récemment mis à jour via une requête GET sur l'API Operations v2.
/api/operations/v2/operations?since=2021-06-01T10:00:00&notIssuedByMe=true&fields=logs

Un commentaire sur une intervention se matérialise par la transmission d'un log status=open/pending/hold et event=commented. Pour identifier cette information, je regarde la rubrique logs du json récupéré.

L'état de l'intervention n'est pas modifié mais un log supplémentaire est disponible, commented. Je peux récupérer de plus amples informations sur le log de commentaire (event=commented) dans la rubrique logs.
Le message de commentaire est transmis dans le champ description du log commented.

{
    "_links": {
        "self": {
            "href": "https://api.hubintent.com/api/operations/v2/operations?notIssuedByMe=true&fields=logs&type=intervention&since=2024-02-29T10:50:00"
        }
    },
    "_embedded": {
        "operations": [
            {
                "reference": "INTER-05062024-4",
                "issuer": {
                    "entity": {
                        "id": "5853fdefc2829a04502a073a",
                        "label": "Intent Technologies Tests Internes",
                        "logoUrl": "https://hubintent.com/intent/entities/logos/c74fd223-bc40-46c2-bf42-6748a9cfe146"
                    },
                    "user": {
                        "id": "035aa297-15fe-4cad-8ba3-16451af564d8",
                        "type": "client",
                        "name": "tests api internes"
                    }
                },
                "contract": {
                    "reference": "contractMultiservices",
                    "label": "Multiservices",
                    "topic": "Multiservices",
                    "entities": [
                        {
                            "id": "5853fdefc2829a04502a0734",
                            "label": "Intent Staff",
                            "logoUrl": "https://hubintent.com/intent/entities/logos/fdaf450a-4ae4-4c2b-93cb-5338bd286219"
                        },
                        {
                            "id": "5853fdefc2829a04502a073a",
                            "label": "Intent Technologies Tests Internes",
                            "logoUrl": "https://hubintent.com/intent/entities/logos/c74fd223-bc40-46c2-bf42-6748a9cfe146"
                        }
                    ]
                },
                "service": {
                    "code": "P902",
                    "originalCode": "P902"
                },
                "status": "open",
                "event": "acknowledged",
                "eventDate": "2024-02-17T16:02:00+01:00",
                "logDate": "2024-02-17T16:02:00+01:00",
                "eventHistory": [
                    "requested",
                    "acknowledged",
                    "commented"
                ],
                "logs": [
                    {
                        "issuer": {
                            "entity": {
                                "id": "5853fdefc2829a04502a073a",
                                "label": "Intent Technologies Tests Internes",
                                "logoUrl": "https://hubintent.com/intent/entities/logos/c74fd223-bc40-46c2-bf42-6748a9cfe146"
                            },
                            "user": {
                                "id": "035aa297-15fe-4cad-8ba3-16451af564d8",
                                "type": "client",
                                "name": "tests api internes"
                            }
                        },
                        "reference": "INTER-05062024-4",
                        "description": "La porte d'entrée ne ferme plus",
                        "contractReference": "contractMultiservices",
                        "contacts": [
                            "BEGIN:VCARD\n\nVERSION:3\r\nFN;CHARSET=UTF-8:Pierre DUPONT\r\nN;CHARSET=UTF-8:DUPONT;Pierre\r\nTEL;TYPE=WORK,VOICE:0734220902\r\nTEL;TYPE=HOME,VOICE:0685874445\r\nADR;TYPE=WORK:165 Avenue de Bretagne;59000;LILLE;France\r\nROLE;CHARSET=UTF-8:Locataire\r\nEMAIL;CHARSET=UTF-8;TYPE=WORK,INTERNET:p.dupont@internet.fr\r\nEND:VCARD"
                        ],
                        "creationDate": "2024-02-29T10:56:30+01:00",
                        "type": "intervention",
                        "serviceCode": "P902",
                        "workType": "corrective",
                        "status": "open",
                        "event": "requested",
                        "eventDate": "2024-02-17T16:00:00+01:00",
                        "logDate": "2024-02-17T16:00:00+01:00",
                        "location": {
                            "assetLabel": "RdC, Porte D",
                            "assetAlgoliaId": "65e047ed4794512d751c2d07",
                            "address": {
                                "way": "9 RUE DU PARADIS",
                                "city": "WAMBRECHIES",
                                "zip": "59118",
                                "country": "FRANCE"
                            },
                            "assetReference": "111578",
                            "assetOwner": "demo.intent",
                            "geo": {
                                "longitude": -4.297238,
                                "latitude": 48.377953
                            }
                        },
                        "equipmentWorkingOrder": "not_operational",
                        "visitAttempt": 1,
                        "criticalLevel": 3
                    },
                    {
                        "issuer": {
                            "entity": {
                                "id": "5853fdefc2829a04502a0734",
                                "label": "Intent Staff",
                                "logoUrl": "https://hubintent.com/intent/entities/logos/fdaf450a-4ae4-4c2b-93cb-5338bd286219"
                            },
                            "user": {
                                "id": "dbb63b64-12f4-451e-ace1-47a22a71bfba",
                                "type": "client",
                                "name": "Service client"
                            }
                        },
                        "reference": "INTER-05062024-4",
                        "description": "Nous accusons réception de votre demande d'intervention",
                        "contractReference": "contractMultiservices",
                        "contacts": [
                            "BEGIN:VCARD\n\nVERSION:3\r\nFN;CHARSET=UTF-8:Pierre DUPONT\r\nN;CHARSET=UTF-8:DUPONT;Pierre\r\nTEL;TYPE=WORK,VOICE:0734220902\r\nTEL;TYPE=HOME,VOICE:0685874445\r\nADR;TYPE=WORK:165 Avenue de Bretagne;59000;LILLE;France\r\nROLE;CHARSET=UTF-8:Locataire\r\nEMAIL;CHARSET=UTF-8;TYPE=WORK,INTERNET:p.dupont@internet.fr\r\nEND:VCARD"
                        ],
                        "creationDate": "2024-02-29T10:57:41+01:00",
                        "type": "intervention",
                        "serviceCode": "P902",
                        "workType": "corrective",
                        "status": "open",
                        "event": "acknowledged",
                        "eventDate": "2024-02-17T16:02:00+01:00",
                        "logDate": "2024-02-17T16:02:00+01:00",
                        "location": {
                            "assetLabel": "RdC, Porte D",
                            "assetAlgoliaId": "65e047ed4794512d751c2d07",
                            "address": {
                                "way": "9 RUE DU PARADIS",
                                "city": "WAMBRECHIES",
                                "zip": "59118",
                                "country": "FRANCE"
                            },
                            "assetReference": "111578",
                            "assetOwner": "demo.intent",
                            "geo": {
                                "longitude": -4.297238,
                                "latitude": 48.377953
                            }
                        },
                        "equipmentWorkingOrder": "not_operational",
                        "visitAttempt": 1,
                        "criticalLevel": 3
                    },
                    {
                        "issuer": {
                            "entity": {
                                "id": "5853fdefc2829a04502a073a",
                                "label": "Intent Technologies Tests Internes",
                                "logoUrl": "https://hubintent.com/intent/entities/logos/c74fd223-bc40-46c2-bf42-6748a9cfe146"
                            },
                            "user": {
                                "id": "035aa297-15fe-4cad-8ba3-16451af564d8",
                                "type": "client",
                                "name": "tests api internes"
                            }
                        },
                        "reference": "INTER-05062024-4",
                        "description": "Ajout d'un contact supplémentaire sur l'intervention",
                        "contractReference": "contractMultiservices",
                        "contacts": [
                            "BEGIN:VCARD\n\nVERSION:3\r\nFN;CHARSET=UTF-8:Martin SPAGNOLI\r\nN;CHARSET=UTF-8:SPAGNOLI;Martin\r\nTEL;TYPE=WORK,VOICE:0734220955\r\nTEL;TYPE=HOME,VOICE:0685874400\r\nADR;TYPE=WORK:165 Avenue de Bretagne;59000;LILLE;France\r\nROLE;CHARSET=UTF-8:Locataire\r\nEMAIL;CHARSET=UTF-8;TYPE=WORK,INTERNET:m.spagnoli@internet.fr\r\nEND:VCARD"
                        ],
                        "creationDate": "2024-02-29T10:59:44+01:00",
                        "type": "intervention",
                        "serviceCode": "P902",
                        "workType": "corrective",
                        "status": "open",
                        "event": "commented",
                        "eventDate": "2024-02-17T16:30:00+01:00",
                        "logDate": "2024-02-17T16:30:00+01:00",
                        "location": {
                            "assetLabel": "RdC, Porte D",
                            "assetAlgoliaId": "65e047ed4794512d751c2d07",
                            "address": {
                                "way": "9 RUE DU PARADIS",
                                "city": "WAMBRECHIES",
                                "zip": "59118",
                                "country": "FRANCE"
                            },
                            "assetReference": "111578",
                            "assetOwner": "demo.intent",
                            "geo": {
                                "longitude": -4.297238,
                                "latitude": 48.377953
                            }
                        },
                        "equipmentWorkingOrder": "not_operational",
                        "visitAttempt": 1,
                        "criticalLevel": 3
                    }
                ],
                "creationDate": "2024-02-29T10:56:30+01:00",
                "lastUpdateDate": "2024-02-29T10:59:44+01:00",
                "_links": {
                    "self": {
                        "href": "https://api.hubintent.com/api/operations/v2/operations/INTER-05062024-4?contractReference=contractMultiservices"
                    },
                    "documents:list": {
                        "href": "https://api.hubintent.com/api/documents/v1/documents?elementType=undefined&elementReference=INTER-05062024-4"
                    }
                }
            }
        ]
    },
    "total": 1
}