Skip to Content
WebhooksOverview

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

  1. You add an HTTPS URL in Volt. This is your endpoint.
  2. Volt sends a signed test event. If your server answers 200, Volt saves the endpoint and shows its signing secret once.
  3. From then on, each new message of your line becomes one event for each endpoint.
  4. Your server checks the signature, answers 2xx, and does its work.

What you get

  • Two events: message.received and message.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

FreePaid plans
Endpoints for each WhatsApp line55
Delivered events1,000 a monthUnlimited

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.