Plivo
The Plivo webhook receives SMS delivery reports from Plivo. These reports track whether messages were delivered, failed, or are still in transit.
Endpoint
Section titled “Endpoint”POST /api/rpc/webhooks/plivo
Security
Section titled “Security”This endpoint uses HMAC-SHA256 signature validation in production.
Supported statuses
Section titled “Supported statuses”| Plivo Status | Platform Event | Description |
|---|---|---|
delivered | sms_delivered | Message delivered to recipient |
undelivered | sms_undelivered | Message could not be delivered |
failed | sms_failed | Message failed to send |
sent | sms_sent | Message sent to carrier |
queued | — | Skipped (message queued) |
Payload fields
Section titled “Payload fields”| Field | Description |
|---|---|
MessageUUID | Plivo’s unique message ID |
Status | Delivery status |
To | Recipient phone number |
Units | Number of message units |
TotalRate | Cost per unit |
ParentMessageUUID | Parent message ID (for multi-part messages) |
Response
Section titled “Response”{ "success": true, "processed": 1}- In your Plivo console, configure the Message URL on your Plivo application.
- Set the URL to your platform’s Plivo webhook endpoint.
- Enable request signature validation in your Plivo account settings.
Related pages
Section titled “Related pages”- Vonage — alternative SMS provider integration
- Twilio SMS — alternative SMS provider integration
- Webhooks overview — how webhooks work