Step 4 — Configure Webhook URL
Meta sends all incoming messages and status updates to your server via a webhook. You must register Whoxa CRM's webhook URL in your Meta App.
Get Your Webhook Details from Whoxa CRM
- Log in to Whoxa CRM.
- Go to Settings → Integrations → Connect WhatsApp.
- Under Webhook Configuration, copy the two values:
- Webhook URL — derived from your API domain, e.g.,
https://your-api-domain.com/api/webhook/whatsapp. - Verification Token — this is not auto-generated. It's the exact value your backend admin set for
WHATSAPP_WEBHOOK_VERIFY_TOKENin the API server's.envfile. Ask your deployer for it if you don't have server access.
- Webhook URL — derived from your API domain, e.g.,
Register the Webhook in Meta
- Go to developers.facebook.com → Your App → WhatsApp → Configuration.
- Under the Webhooks section, click Edit.
- Paste your Webhook URL in the Callback URL field.
- Paste the Verification Token from Whoxa CRM.
- Click Verify and Save.
Meta will send a GET request to your URL to confirm it responds correctly. If verification fails, make sure your API server is running and publicly accessible.
Subscribe to Webhook Fields
After saving, scroll down to Webhook Fields and enable:
| Field | Required |
|---|---|
messages | ✅ Yes |
message_deliveries | Recommended |
message_reads | Recommended |
messaging_postbacks | Optional |
Click Subscribe for each field you want to enable.
Proceed to Step 5 — Verify & Save Credentials.