Real-time Delivery Updates
Webhooks & Delivery Reports
Receive instant delivery confirmations for every SMS you send. MessageBot securely pushes delivery events to your backend — no polling, no delays.
What is a Webhook?
A webhook is an HTTP endpoint on your server that automatically receives delivery updates whenever an SMS status changes. Instead of repeatedly querying the API, MessageBot sends updates directly to your system.
Why developers prefer webhooks
- ✔ Zero polling overhead
- ✔ Near real-time delivery status
- ✔ Works with any backend stack
Message Delivery Lifecycle
1
Submitted
API accepts your request
2
Enroute
Handed to telecom operator
3
Delivered / Failed
Final delivery state
4
Webhook Callback
Status pushed to your server
Enabling Webhooks
Include a callBackUrl while sending SMS. The URL must be publicly accessible and capable of handling HTTP POST requests.
{
"apiToken": "YOUR_TOKEN",
"messageType": "2",
"destinationAddress": "918744815388",
"sourceAddress": "TSTBOT",
"messageText": "Hello",
"callBackUrl": "https://yourdomain.com/webhook"
}Webhook Payload
{
"messageId": 22,
"operationCode": 0,
"status": "Success",
"dlrStatus": "Delivered",
"userReferenceId": "REF123",
"destinationAddress": 918744815388,
"remarks": "Dlr Status is : Delivered"
}Delivery Status Codes
| Code | Status | Description |
|---|---|---|
| 1 | Enroute | Submitted to operator |
| 2 | Delivered | Successfully delivered |
| 5 | Undeliverable | Network or handset issue |
| 8 | Rejected | Rejected by operator |
Reliability & Best Practices
Always return HTTP 200 immediately
Ensure webhook endpoints are idempotent
Log and monitor all delivery callbacks
Process events asynchronously