Webhooks allow Meta to push real-time message events to your CRM. This is how incoming WhatsApp messages appear in your live chat inbox instantly.

Setting Up the Webhook

  1. In your Meta App, go to WhatsApp > Configuration.
  2. Under Webhook, click Edit.
  3. Enter the Callback URL — this is provided in your CRM under Settings > Meta Cloud API > Webhook URL.
  4. Enter the Verify Token — copy this from your CRM settings as well.
  5. Click Verify and Save. Meta will send a GET request to verify the endpoint.

Subscribing to Webhook Fields

After verification, click Manage next to Webhook fields and enable:

  • messages — for incoming messages
  • message_deliveries — for delivery receipts
  • message_reads — for read receipts
  • messaging_referrals — for Click-to-WhatsApp ad referrals

Generating a Permanent Access Token

  1. Go to Meta Business Manager > Business Settings > System Users.
  2. Create a System User, assign it Admin role.
  3. Click Generate New Token, pick your app, and enable all whatsapp_business_management and whatsapp_business_messaging permissions.
  4. Copy and save the token immediately — it is only shown once.
⚠️ Important: Never use a personal user access token. System User tokens are permanent and business-scoped.