Broadcasto logo Broadcasto

Custom webhook for WhatsApp Business events

If it can speak HTTPS, it can plug into Broadcasto. Subscribe to message, status, conversation, contact and campaign events and we will deliver them to your endpoint with retries and HMAC signatures.

Why connect Custom Webhook to WhatsApp

HMAC signed payloads

Every webhook is signed with HMAC SHA256 using your signing secret, verify in three lines of code.

Retry with exponential backoff

Failed deliveries retry up to 12 times across 24 hours, with a dead letter queue for diagnosis.

Event level filtering

Subscribe only to the events you care about, message, status, conversation, contact, campaign or all.

Replayable history

Last 30 days of webhook events can be replayed from the admin in case of downstream outages.

Multiple endpoints

Fan out to staging, production, analytics and BI endpoints simultaneously.

Common use cases

Custom dashboards

Stream WhatsApp metrics into your own data warehouse or analytics stack in real time.

Internal automation

Wire WhatsApp events into Slack, Microsoft Teams, ServiceNow or your in house ops tooling.

ML and personalisation

Feed reply patterns into your ML pipeline to score lead intent and prioritise outbound.

How it works

  1. Generate a signing secret in Broadcasto integrations.
  2. Configure your HTTPS endpoint URL and the events you care about.
  3. Verify the signature on incoming requests using HMAC SHA256.
  4. Acknowledge with HTTP 200 within 10 seconds, or we retry.

Frequently asked questions

What is the payload format?

All payloads are JSON, with a stable event schema documented in the developer hub.

How do I verify the signature?

Compute HMAC SHA256 of the raw body using your signing secret and compare to the X-Broadcasto-Signature header.

What is the retry policy?

12 attempts over 24 hours using exponential backoff. After that the event lands in the dead letter queue for manual replay.

Can I have multiple endpoints?

Yes, you can register an unlimited number of endpoints with independent filters.

Is there a sandbox?

Yes, a dedicated sandbox endpoint receives test events so you can build and test without touching production.