Identité ID WhatsApp de l’utilisateur·ice

/v1/contacts/{users-whatsapp-id}/identity

Vous pouvez recevoir des notifications de WhatsApp lorsqu’une personne avec laquelle vous communiquez semble avoir été modifiée. Utilisez l’arête /v1/contacts pour gérer les identités des utilisateur·ices. Pour plus d’informations, consultez la section Comprendre les modifications d’identité pour WhatsApp Business.

Pour plus d’informations sur les notifications système envoyées par WhatsApp, consultez la section Messages système entrants — Exemple : potentiel changement d’utilisateur. La réponse à la notification système est gérée par votre entreprise.

Lecture

Un appel GET à ce point de terminaison permet de récupérer la dernière identité hachée d’un·e utilisateur·ice.

Exemple

Requête :

GET /v1/contacts/users-whatsapp-id/identity

En cas de réussite, votre requête renvoie 200 OK et un corps de message contenant un objet contacts. Par exemple, la réponse complète, comprenant l’objet contacts, pourrait ressembler à ceci :

{
    "contacts":
    {
        "hash": "UKD6Y/5SqDU=",
        "created_timestamp": 1600132094000,
        "acknowledged": true 
    }
}
  

Champs renvoyés

L’objet réponse contacts contient les informations suivantes concernant l’identité de l’utilisateur·ice :

Création

Utilisez des appels PUT vers ce point de terminaison pour accuser réception de la dernière notification système user_identity_changed.

Tant que votre appel d’API identity n’aboutit pas, après la réception d’une notification user_identity_changed, tous les messages sortants adressés à l’utilisateur·ice concerné·e seront bloqués si les paramètres show_security_notifications sont activés dans les paramètres de l’application.

Exemple

Requête :

PUT /v1/contacts/users-whatsapp-id/identity
  {
    “hash”: “Rc/eg9RQ0JA=”
  }

En cas de réussite, la réponse se compose du code 200 OK avec un corps de message null ou {}.

Paramètres