/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
содержит перечисленные ниже сведения о личности пользователя.
Имя | Описание |
---|---|
Тип: строка | Состояние подтверждения последнего системного уведомления |
Тип: целое число | Метка времени момента, когда клиент WhatsApp Business API обнаружил потенциальную смену пользователя. |
Тип: строка | Идентификатор последнего системного уведомления |
Выполните вызов 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
или {}
.
Имя | Описание |
---|---|
Тип: строка | Идентификатор последнего системного уведомления |