WhatsApp sources need a Pro project, because the Free plan has one source only.
Set up
1
Add the source
In your project, open Sources → Add source and pick WhatsApp Cloud API. hooksnode shows a Callback URL and a Verify token.
2
Paste the values into Meta
In Meta for Developers, open your app → WhatsApp → Configuration. Paste the Callback URL and the Verify token, then press Verify and save. Subscribe to the webhook fields you need, for example
messages.3
Paste the App Secret into hooksnode
In Meta, open App settings → Basic and copy the App Secret. Paste it into the source in hooksnode. From now on, hooksnode checks the
X-Hub-Signature-256 header of each event.4
Add a destination
Add the endpoint of your bot or support tool as a destination.
How it works
- Handshake. Meta sends
GET /p/<id>?hub.mode=subscribe&hub.verify_token=…&hub.challenge=…. hooksnode answers200with the challenge when the token matches, and403when it does not. - Signature. With an App Secret saved, an event with a wrong
X-Hub-Signature-256gets401. Without an App Secret, hooksnode accepts unsigned events and the source page shows a warning. - Duplicates. Meta retries a failed delivery for up to 36 hours with the same body. hooksnode stores each body once, because it uses a hash of the body as the idempotency key.