Webhooks
Webhooks send the messages of your WhatsApp line to your own server. When your line receives or sends a message, Volt makes an HTTPS POST request to a URL you choose, with the message as JSON.
Use webhooks to connect your line to a bot, a CRM, or an internal tool that must react when a message arrives. If you want an AI assistant to read and send messages on request, use the MCP server instead.
How it works
- You add an HTTPS URL in Volt. This is your endpoint.
- Volt sends a signed test event. If your server answers
200, Volt saves the endpoint and shows its signing secret once. - From then on, each new message of your line becomes one event for each endpoint.
- Your server checks the signature, answers
2xx, and does its work.
What you get
- Two events:
message.receivedandmessage.sent. You choose which ones each endpoint receives. See Events. - Signed requests: every request follows the Standard Webhooks specification, so you can verify it with an existing library. See Verify Signatures.
- Retries: if your server does not answer
2xx, Volt tries again. Each event gets up to 8 attempts over about 24 hours. - A WhatsApp alert: if your endpoint stops answering, Volt tells you in WhatsApp.
Limits
| Free | Paid plans | |
|---|---|---|
| Endpoints for each WhatsApp line | 5 | 5 |
| Delivered events | 1,000 a month | Unlimited |
Only delivered events count. Test events do not count. When a Free account reaches the limit, Volt drops new events until the next month starts.
Availability
Webhooks are rolling out gradually. If you do not see the Webhooks section in App Store › Developer, contact us and we will turn it on for your account.