Skip to main content

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

  1. Log in to Whoxa CRM.
  2. Go to Settings → Integrations → Connect WhatsApp.
  3. 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_TOKEN in the API server's .env file. Ask your deployer for it if you don't have server access.

Register the Webhook in Meta

  1. Go to developers.facebook.comYour App → WhatsApp → Configuration.
  2. Under the Webhooks section, click Edit.
  3. Paste your Webhook URL in the Callback URL field.
  4. Paste the Verification Token from Whoxa CRM.
  5. 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:

FieldRequired
messages✅ Yes
message_deliveriesRecommended
message_readsRecommended
messaging_postbacksOptional

Click Subscribe for each field you want to enable.


Proceed to Step 5 — Verify & Save Credentials.