Перейти к основному содержимому

Справочник по веб-перехватчику 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 .A business customer with a WhatsApp Business app phone number who has been onboarded by a solution provider adds a contact to their WhatsApp Business app контакты?.A business customer with a WhatsApp Business app phone number who has been onboarded by a solution provider removes a contact from their WhatsApp Business app контакты?.A business customer with a WhatsApp Business app phone number who has been onboarded by a solution provider edits a contact in their WhatsApp Business app контакты?.

    Синтаксис

    {
    "object": "whatsapp_business_account", "entry": [ { "id": "<WHATSAPP_BUSINESS_ACCOUNT_ID>", "changes": [ { "value": { "messaging_product": "whatsapp", "metadata": { "display_phone_number": "<BUSINESS_DISPLAY_PHONE_NUMBER>", "phone_number_id": "<BUSINESS_PHONE_NUMBER_ID>" }, "state_sync": [ { "type": "contact", "contact": { "full_name": "<CONTACT_FULL_NAME>", "first_name": "<CONTACT_FIRST_NAME>", "phone_number": "<CONTACT_PHONE_NUMBER>" }, "action": "<ACTION>", "metadata": { "timestamp": "<WEBHOOK_TRIGGER_TIMESTAMP>" } }, <!-- Additional contacts would follow, if any --> ] }, "field": "smb_app_state_sync" } ] } ] }

    Параметры

    Заполнитель Описание Пример значения
    <ACTION>
    Нить
    Указывает, добавил ли, отредактировал или удалил ли бизнес-клиент контакт из адресной книги своего телефона в приложении WhatsApp Business.
    Возможные значения:
    добавлять - Indicates the WhatsApp Business app user added or edited a contact.
    удалять - Indicates the WhatsApp Business app user removed a contact.
    добавлять
    <BUSINESS_DISPLAY_PHONE_NUMBER>
    Нить
    Номер телефона компании, отображаемый на экране.
    15550783881
    <BUSINESS_PHONE_NUMBER_ID>
    Нить
    Идентификатор номера служебного телефона.
    106540352242922
    <CONTACT_FIRST_NAME>
    Нить
    Он контакт'контакт's first name, as it appears in the business клиент'клиент's WhatsApp Business app phone address book.
    Не включается в случае удаления контакта из телефонной адресной книги приложения WhatsApp Business корпоративными клиентами.
    Пабло
    <CONTACT_FULL_NAME>
    Нить
    Он контакт'контакт's full name, as it appears in the business клиент'клиент's WhatsApp Business app phone address book.
    Не включается в случае удаления контакта из телефонной адресной книги приложения 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" } ] } ] }