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 OK or times out, SMSBAT may attempt to retry the delivery based on your account configuration.