Identidad del identificador de WhatsApp del usuario

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

Puedes recibir notificaciones de WhatsApp si existe la posibilidad de que haya cambiado un usuario con el que te comunicas. Utiliza este perímetro /v1/contacts para administrar las identidades de los usuarios. Consulta Explicación del cambio de identidad de WhatsApp Business para obtener más información.

Para obtener más información sobre la notificación del sistema que se envía desde WhatsApp, consulta Mensajes del sistema entrantes — Ejemplo: Es posible que un usuario haya cambiado. La empresa administra la respuesta a la notificación del sistema.

Lectura

Una llamada GET a este extremo recupera el valor de hash de identidad más reciente para un usuario.

Ejemplo

Solicitud:

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

Respuesta:

Si es correcta, la solicitud devuelve 200 OK y un cuerpo de mensaje que contiene un objeto contacts. Por ejemplo, la respuesta completa, incluido el objeto contacts, puede tener el aspecto siguiente:

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

Campos devueltos

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

Creación

Utiliza llamadas PUT a este extremo para confirmar la notificación del sistema user_identity_changed más reciente.

Hasta que no hayas realizado una llamada a la API identity correcta después de recibir una notificación user_identity_changed, todos los mensajes salientes para este usuario se bloquearán si la configuración de show_security_notifications está habilitada en la configuración de la aplicación.

Ejemplo

Solicitud:

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

Respuesta:

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

Parámetros