Справочник по веб-перехватчикам сообщений о заказах | Документация для разработчиков
Справочник веб-перехватчика сообщений о заказах
Обновлено: 22 октября 2025 г
сообщений бизнес-аккаунта WhatsApp для сообщений о заказах.
Триггеры
Синтаксис
{ "object": "whatsapp_business_account", "entry": [ { "id": "<WHATSAPP_BUSINESS_ACCOUNT_ID> ", "изменения": [ { "значение": { "messaging_product": "whatsapp", "метаданные": { "отображаемый_номер_телефона": "<BUSINESS_DISPLAY_PHONE_NUMBER> ", "phone_number_id": "<BUSINESS_PHONE_NUMBER_ID> " }, "контакты": [ { "профиль": { "имя": "<WHATSAPP_USER_PROFILE_NAME> " }, "wa_id": "<WHATSAPP_USER_ID> ", "identity_key_hash": "<IDENTITY_KEY_HASH> "<!-- only included if identity change check enabled --> } ], "сообщения": [ { "из": "<WHATSAPP_USER_PHONE_NUMBER> ", "идентификатор": "<WHATSAPP_MESSAGE_ID> ", "временная метка": "<WEBHOOK_TRIGGER_TIMESTAMP> ", "type": "order", "order": { "catalog_id": "<PRODUCT_CATALOG_ID> ", "текст": "<ORDER_TEXT> ", "product_items": [ { "product_retailer_id": "<PRODUCT_ID> ", "количество":<PRODUCT_QUANTITY> , "item_price":<PRODUCT_PRICE> , "валюта": "<CURRENCY_CODE> " } ] } } ] }, "поле": "сообщения" } ] } ] }Параметры
| Заполнитель | Описание | Пример значения |
|---|---|---|
<BUSINESS_DISPLAY_PHONE_NUMBER>Нить | Номер телефона компании, отображаемый на экране. | 15550783881 |
<BUSINESS_PHONE_NUMBER_ID>Нить | Идентификатор номера служебного телефона. | 106540352242922 |
<CURRENCY_CODE>Нить | Код валюты каталога. | доллар США |
<IDENTITY_KEY_HASH>Нить | Хэш ключа идентификации. Включается только в том случае, если включена проверки изменений идентификатора . | DF2lS5v2W6x= |
<ORDER_TEXT>Нить | Текст, прилагаемый к заказу. | Обожаю их! |
<PRODUCT_CATALOG_ID>Нить | 194836987003835 | |
<PRODUCT_ID>Нить | di9ozbzfi4 | |
<PRODUCT_PRICE>Целое число | Цена за единицу товара. | 7.99 |
<PRODUCT_QUANTITY>Целое число | Количество товара. | 2 |
<WEBHOOK_TRIGGER_TIMESTAMP>Нить | Временная метка Unix, указывающая на момент срабатывания веб-перехватчика. | 1739321024 |
<WHATSAPP_BUSINESS_ACCOUNT_ID>Нить | Идентификатор бизнес-аккаунта WhatsApp. | 102290129340398 |
<WHATSAPP_MESSAGE_ID>Нить | Идентификатор сообщения WhatsApp. | wamid.HBgLMTY1MDM4Nzk0MzkVAgASGBQzQUFERjg0NDEzNDdFODU3MUMxMAA= |
<WHATSAPP_USER_ID>Нить | Идентификатор пользователя WhatsApp. Обратите внимание, что идентификатор пользователя WhatsApp и номер телефона могут не всегда совпадать. | 16505551234 |
<WHATSAPP_USER_PHONE_NUMBER>Нить | Номер телефона пользователя WhatsApp. Это то же значение, которое возвращает API в качестве входного значения при отправке сообщения пользователю WhatsApp. Обратите внимание, что номер телефона и идентификатор пользователя WhatsApp могут не всегда совпадать. | 16505551234 |
<WHATSAPP_USER_PROFILE_NAME>Нить | Имя пользователя WhatsApp, как оно отображается в его профиле в клиенте WhatsApp. | Шина Нельсон |
Пример
В этом примере веб-перехватчика описывается заказ, размещенный пользователем WhatsApp на 3 товара через интерактивное сообщение каталога.
{ "object": "whatsapp_business_account", "entry": [ { "id": "102290129340398", "changes": [ { "value": { "messaging_product": "whatsapp", "metadata": { "display_phone_number": "15550783881", "phone_number_id": "106540352242922" }, "contacts": [ { "profile": { "name": "Sheena Nelson" }, "wa_id": "16505551234" } ], "messages": [ { "from": "16505551234", "id": "wamid.HBgLMTY1MDM4Nzk0MzkVAgASGBQzQUFERjg0NDEzNDdFODU3MUMxMAA=", "timestamp": "1750096325", "type": "order", "order": { "catalog_id": "194836987003835", "text": "Обожаю их!", "product_items": [ { "product_retailer_id": "di9ozbzfi4", "quantity": 2, "item_price": 30, "currency": "USD" }, { "product_retailer_id": "nqryix03ez", "quantity": 1, "item_price": 25, "currency": "USD" } ] } } ] }, "field": "messages" } ] } ] }