Identidad del identificador de usuario de WhatsApp

/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.

Lectura

Una llamada GET a este punto de conexión recupera la clave de identidad más reciente de un usuario.

Ejemplo:

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 
    }
}
  

Campos devueltos

El objeto de respuesta contacts contiene la siguiente información sobre la identidad del usuario.

NombreDescripción

acknowledged

Tipo: cadena

Estado de reconocimiento de la notificación del sistema user_identity_changed más reciente.

created_timestamp

Tipo: entero

Marca de tiempo del momento en que el cliente de la API de WhatsApp Business detectó que probablemente haya cambiado el usuario.

hash

Tipo: cadena

Identificador de la notificación del sistema user_identity_changed más reciente.

Creación

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.

Ejemplo:

Solicitud:

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

Una respuesta satisfactoria es 200 OK con un cuerpo de mensaje null o {}.

Parámetros

NombreDescripción

hash

Tipo: cadena

Identificador de la notificación del sistema user_identity_change más reciente recibida para este contacto