BSG reports what happens to your WhatsApp messages by sending an HTTP POST to your callback URL as each message progresses. This article describes the callback and the exact output you'll receive.
Set your callback URL
Configure a Callback URL For WhatsApp in Management → Integrations & API → SMPP/API – password in the BSG cabinet (see Getting started with 1-way WhatsApp on BSG, Step 7). You can also set a per-message callback_url on a single send — see Send Single WhatsApp Message.
What you receive
- BSG posts a JSON body to your callback URL as each message changes status — so you'll typically get more than one callback per message (for example
accepted, thendelivered). - Single sends and campaigns use the same callback shape.
- Each callback identifies the message by BSG message
idand by yourreference(thereference_idyou set when sending), so you can match it to a recipient. - Coming later: inbound message and button-tap forwarding will arrive on the same callback URL in a future release.
If you'd rather pull status instead of receiving callbacks, use Get Single Message Info.
The output
{
"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 message ID (matches the id returned by your send request) |
reference |
Your reference_id from the send request — use it to correlate the update to a recipient |
msisdn |
Recipient's phone number |
status |
Current status (see below) |
error / errorDescription
|
0 / "No errors" when fine; otherwise a summary of the problem |
error_code |
null when fine; the error code on failure (BSG mirrors Meta's codes) |
time_in / time_sent / time_dr
|
Timestamps: accepted, sent, and delivery-receipt |
price / currency
|
Charge recorded on the BSG side. WhatsApp traffic is billed by Meta, so this is typically 0
|
Status values: scheduled, moderation, accepted, sending, sent, delivered, read, expired, failed, undelivered, unknown.
Related
- Getting started with 1-way WhatsApp on BSG — where to set your callback URL.
- BSG WhatsApp API Overview — the send methods that generate these callbacks.
-
Common WhatsApp API errors — what
error_codevalues mean. - OneAPI methods: Send Single WhatsApp Message · Send WhatsApp campaign.
Comments
0 comments
Article is closed for comments.