Справочник по веб-перехватчику smb_app_state_sync | Документация для разработчиков

Справочник по веб-перехватчикам smb_app_state_sync

Обновлено: 22 октября 2025 г

smb_app_state_sync бизнес-аккаунта WhatsApp .

Веб smb_app_state_sync используется для синхронизации контактов пользователей приложения WhatsApp Business, которые были подключены через поставщика решений.

Триггеры

Поставщик решений синхронизирует контакты бизнес-клиента в приложении WhatsApp Business с номером телефона клиента, подключенного к приложению WhatsApp Business . , и прошедший процедуру подключения через поставщика решений, добавляет контакт в свои контакты .Корпоративный клиент, имеющий номер телефона, используемый в приложении WhatsApp Business, и подключенный к системе поставщиком решений, удаляет контакт из списка контактов . , подключенный приложению WhatsApp Business, редактирует контакт в своих контактах .

Синтаксис

{ "object": "whatsapp_business_account", "entry": [ { "id": "<WHATSAPP_BUSINESS_ACCOUNT_ID> ", "изменения": [ { "значение": { "messaging_product": "whatsapp", "метаданные": { "отображаемый_номер_телефона": "<BUSINESS_DISPLAY_PHONE_NUMBER> ", "phone_number_id": "<BUSINESS_PHONE_NUMBER_ID> " }, "state_sync": [ { "type": "contact", "contact": { "full_name": "<CONTACT_FULL_NAME> ", "имя": "<CONTACT_FIRST_NAME> ", "номер телефона": "<CONTACT_PHONE_NUMBER> " }, "действие": "<ACTION> ", "метаданные": { "временная метка": "<WEBHOOK_TRIGGER_TIMESTAMP> " } },<!-- Additional contacts would follow, if any --> ] }, "field": "smb_app_state_sync" } ] } ] }

Параметры

Заполнитель	Описание	Пример значения
`<ACTION>` Нить	Указывает, добавил ли, отредактировал или удалил ли бизнес-клиент контакт из адресной книги своего телефона в приложении WhatsApp Business. Возможные значения: `Добавить` — указывает, что пользователь приложения WhatsApp Business добавил или отредактировал контакт. `удалить` — Указывает на то, что пользователь приложения WhatsApp Business удалил контакт.	`добавлять`
`<BUSINESS_DISPLAY_PHONE_NUMBER>` Нить	Номер телефона компании, отображаемый на экране.	`15550783881`
`<BUSINESS_PHONE_NUMBER_ID>` Нить	Идентификатор номера служебного телефона.	`106540352242922`
`<CONTACT_FIRST_NAME>` Нить	Имя контакта, как оно отображается в телефонной адресной книге бизнес-клиента в приложении WhatsApp Business. Не включается в случае удаления контакта из телефонной адресной книги приложения WhatsApp Business корпоративными клиентами.	`Пабло`
`<CONTACT_FULL_NAME>` Нить	Полное имя контакта, как оно отображается в телефонной адресной книге бизнес-клиента в приложении WhatsApp Business. Не включается в случае удаления контакта из телефонной адресной книги приложения WhatsApp Business корпоративными клиентами.	`Пабло Моралес`
Нить	Номер телефона контакта в WhatsApp.	`16505551234`
`<WEBHOOK_TRIGGER_TIMESTAMP>` Целое число	Временная метка Unix, указывающая на момент срабатывания веб-перехватчика.	`1739321024`
`<WHATSAPP_BUSINESS_ACCOUNT_ID>` Нить	Идентификатор бизнес-аккаунта WhatsApp.	`102290129340398`

Пример

{ "object": "whatsapp_business_account", "entry": [ { "id": "102290129340398", "changes": [ { "value": { "messaging_product": "whatsapp", "metadata": { "display_phone_number": "15550783881", "phone_number_id": "106540352242922" }, "state_sync": [ { "type": "contact", "contact": { "full_name": "Pablo Morales", "first_name": "Pablo", "phone_number": "16505551234" }, "action": "add", "metadata": { "timestamp": "1739321024" } } ] }, "field": "smb_app_state_sync" } ] } ] }