Ajouter des contacts sur un asset

Vous pouvez ajouter les contacts de vos clients locataires ou de votre personnel afin de les partager à vos prestataires de maintenance mais également à des services tiers afin de réaliser de l'envoi de SMS ou d'enquête de satisfaction par exemple.

Il est possible d'associer un contact à n'importe quel asset (bâti et équipement). Le contact est à renseigner dans champ intent_contacts au format vCard.

Il est possible d'associer plusieurs contacts pour un même élément de patrimoine.
Pensez à segmenter vos contacts avec le champ ROLE de la vCard. Par exemple, Gardien, Responsable de site, Contractant, Locataires, etc.

Méthodes

Vous pouvez indiquer le(s) contact(s) sur un asset dès sa création. Veuillez vous référer à  ⁠⁠Création d'asset bâti par le propriétaire⁠ 

Si vous souhaitez ajouter à postériori ou bien réaliser la modification d'un contact, il vous faut réaliser une modification d'un asset.
PATCH /assets/v1/assets/{reference}

{
    "tags":[
        {
            "operation":"add",
            "name":"intent_contacts",
            "value":"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:Gardien\r\nEMAIL;CHARSET=UTF-8;TYPE=WORK,INTERNET:p.dupont@internet.fr\r\nEND:VCARD\r\nBEGIN:VCARD\n\nVERSION:3\r\nFN;CHARSET=UTF-8:Marie FRANCE\r\nN;CHARSET=UTF-8:FRANCE ;Marie\r\nTEL;TYPE=WORK,VOICE:0709243902\r\nTEL;TYPE=HOME,VOICE:0385874498\r\nADR;TYPE=WORK:165 Avenue du Bretagne;59000;LILLE;France\r\nROLE;CHARSET=UTF-8:Locataire 2\r\nEMAIL;CHARSET=UTF-8;TYPE=WORK,INTERNET:mfrance@internet.fr\r\nEND:VCARD"
        }
    ]
}
La modification (PATCH) est un écrase et remplace. Ainsi, si un contact est déjà présent et que vous modifiez le champ intent_contacts, la plateforme écrase et remplace la valeur dans le champ intent_contacts par la nouvelle valeur que vous indiquez.

Si vous souhaitez uniquement supprimer un contact sans le modifier ou le remplacer, il vous faut réaliser l'appel API suivant,
PATCH /assets/v1/assets/{reference}

{
    "tags":[
        {
            "operation":"remove",
            "name":"intent_contacts"
        }
    ]
}