BSG повідомляє про те, що відбувається з вашими повідомленнями WhatsApp, надсилаючи HTTP POST на вашу callback URL у міру того, як кожне повідомлення проходить свої етапи. У цій статті описано callback і точні дані, які ви отримаєте.
Налаштування вашої callback URL
Налаштуйте Callback URL For WhatsApp у розділі Management → Integrations & API → SMPP/API – password у кабінеті BSG (див. Початок роботи з 1-way WhatsApp на BSG, Крок 7). Ви також можете задати callback_url для окремого повідомлення під час одиночного надсилання — див. Send Single WhatsApp Message.
Що ви отримуєте
- BSG надсилає JSON-тіло на вашу callback URL у міру зміни статусу кожного повідомлення — тож зазвичай ви отримаєте більш ніж один callback на повідомлення (наприклад,
accepted, а потімdelivered). - Одиночні надсилання та кампанії використовують однакову структуру callback.
- Кожен callback ідентифікує повідомлення за BSG message
idта за вашимreference(значеннямreference_id, яке ви задали під час надсилання), тож ви можете зіставити його з отримувачем. - З'явиться згодом: пересилання вхідних повідомлень і натискань кнопок надходитиме на ту саму callback URL у майбутньому.
Якщо ви віддаєте перевагу отримувати статус самостійно, а не через callback-и, використовуйте Get Single Message Info.
Дані на виході
{
"error": 0,
"errorDescription": "No errors",
"id": "6030862472",
"msisdn": "48573743874",
"reference": "whatsappdemo005",
"time_in": "2026-07-03 11:50:31",
"time_sent": "2026-07-03 11:50:32",
"time_dr": "2026-07-03 11:50:34",
"status": "delivered",
"error_code": null,
"price": "0.0000000",
"currency": "UAH"
}
| Field | Description |
|---|---|
id |
Ідентифікатор повідомлення BSG (збігається з id, який повертає ваш запит на надсилання) |
reference |
Ваш reference_id із запиту на надсилання — використовуйте його, щоб співвіднести оновлення з отримувачем |
msisdn |
Номер телефону отримувача |
status |
Поточний статус (див. нижче) |
error / errorDescription
|
0 / "No errors", коли все гаразд; інакше — короткий опис проблеми |
error_code |
null, коли все гаразд; код помилки у разі невдачі (BSG дублює коди Meta) |
time_in / time_sent / time_dr
|
Мітки часу: прийнято, надіслано та квитанція про доставку |
price / currency
|
Списання, зафіксоване на боці BSG. Трафік WhatsApp тарифікується Meta, тому це значення зазвичай 0
|
Значення статусу: scheduled, moderation, accepted, sending, sent, delivered, read, expired, failed, undelivered, unknown.
Пов'язані матеріали
- Початок роботи з 1-way WhatsApp на BSG — де налаштувати вашу callback URL.
- Огляд BSG WhatsApp API — методи надсилання, які генерують ці callback-и.
-
Поширені помилки WhatsApp API (надсилання) — що означають значення
error_code. - Методи OneAPI: Send Single WhatsApp Message · Send WhatsApp campaign.
Документація Meta
- WhatsApp Cloud API error codes — що означають значення
error_codeу callback: https://developers.facebook.com/documentation/business-messaging/whatsapp/support/error-codes
Коментарі
0 коментарів
Стаття закрита для коментарів.