/v1/contacts/{users-whatsapp-id}/identity
Es posible recibir notificaciones de WhatsApp si un usuario con el que te estás comunicando hubiera cambiado. Usa este perímetro /v1/contacts para administrar las identidades de los usuarios. Si quieres obtener más información, consulta Cómo interpretar el cambio de identidad para WhatsApp Business.
Para obtener más información sobre la notificación del sistema enviada desde WhatsApp, consulta Notificaciones entrantes del sistema: por ejemplo, un usuario potencialmente cambiado. Tu empresa administra la respuesta a la notificación del sistema.
Una llamada GET
a este punto de conexión recupera la clave de identidad más reciente de un usuario.
Solicitud:
GET /v1/contacts/users-whatsapp-id/identity
Las solicitudes exitosas devuelven 200 OK
y un cuerpo de mensajes que contiene un objeto contacts
en el cuerpo del mensaje. Por ejemplo, la respuesta completa, que incluye el objeto contacts
, podría tener el siguiente aspecto:
{ "contacts": { "hash": "UKD6Y/5SqDU=", "created_timestamp": 1600132094000, "acknowledged": true } }
El objeto de respuesta contacts
contiene la siguiente información sobre la identidad del usuario.
Nombre | Descripción |
---|---|
Tipo: cadena | Estado de reconocimiento de la notificación del sistema |
Tipo: entero | Marca de tiempo del momento en que el cliente de la API de WhatsApp Business detectó que probablemente haya cambiado el usuario. |
Tipo: cadena | Identificador de la notificación del sistema |
Usa las llamadas PUT
a este punto de conexión para reconocer la notificación del sistema user_identity_changed
más reciente.
Hasta que no se realice con éxito una llamada a la API de identity
después de recibir una notificación de user_identity_changed
todos los mensajes salientes para este usuario se bloquearán si la configuración de show_security_notifications
está activada en la configuración de la aplicación.
Solicitud:
PUT /v1/contacts/users-whatsapp-id/identity { “hash”: “Rc/eg9RQ0JA=” }
Una respuesta satisfactoria es 200 OK
con un cuerpo de mensaje null
o {}
.
Nombre | Descripción |
---|---|
Tipo: cadena | Identificador de la notificación del sistema |