Incoming Messages (Callbacks)
When users send an incoming message to your Viber bot or other configured channels, SMSBAT forwards these messages to your server via Webhook (Callback).
Webhook Format
Callbacks are sent to your configured Webhook URL via an HTTP POST request with a JSON payload.
Request Body Example
{
"idUuid": "123e4567-e89b-12d3-a456-426614174000",
"alphaName": "ViberBotName",
"phoneNumber": "380936670003",
"text": "Hello, I need help with my order",
"dt": "2025-01-20T14:30:00.000Z"
}
Parameters
| Field | Type | Description |
|---|---|---|
idUuid |
string | Unique identifier for the incoming message |
alphaName |
string | Your brand/bot name that received the message |
phoneNumber |
string | The sender's phone number |
text |
string | The text content of the incoming message |
dt |
datetime | Timestamp of when the message was received |
Configuration
To start receiving Incoming Messages:
1. Provide your Webhook URL (HTTPS required) to your SMSBAT Account Manager or configure it in the Dashboard.
2. Your endpoint must accept POST requests with Content-Type: application/json.
3. Your server should respond with 200 OK upon successfully receiving the payload.
Note: If your server does not respond with
200 OKor times out, SMSBAT may attempt to retry the delivery based on your account configuration.