Личность пользователя WhatsApp

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

Вы можете получать уведомления от WhatsApp о том, что пользователь, с которым вы общаетесь, мог смениться. Эта граница контекста /v1/contacts позволяет управлять информацией о личностях пользователей. Дополнительную информацию см. в статье Изменение личности пользователя в WhatsApp Business.

Дополнительную информацию о системных уведомлениях от WhatsApp см. в разделе Входящие системные сообщения (пример: возможная смена пользователя). На это системное уведомление должна реагировать ваша компания.

Чтение

Выполните вызов GET к этой конечной точке, чтобы получить актуальную хэшированную строку личности пользователя.

Пример

Запрос:

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

В случае успеха возвращается код 200 OK и сообщение с объектом contacts. Пример полного ответа с объектом contacts:

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

Возвращаемые поля

Объект ответа contacts содержит перечисленные ниже сведения о личности пользователя.

ИмяОписание

acknowledged

Тип: строка

Состояние подтверждения последнего системного уведомления user_identity_changed.

created_timestamp

Тип: целое число

Метка времени момента, когда клиент WhatsApp Business API обнаружил потенциальную смену пользователя.

hash

Тип: строка

Идентификатор последнего системного уведомления user_identity_changed.

Создание

Выполните вызов PUT к этой конечной точке, чтобы принять последнее системное уведомление user_identity_changed.

Если в настройках приложения включены настройки show_security_notifications, все исходящие сообщения в адрес этого пользователя будут блокироваться до тех пор, пока вы не выполните успешный вызов API identity после получения уведомления user_identity_changed.

Пример

Запрос:

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

В случае успеха возвращается ответ 200 OK с сообщением null или {}.

Параметры

ИмяОписание

hash

Тип: строка

Идентификатор последнего системного уведомления user_identity_change, полученного для данного контакта.