Configure the Meta WhatsApp Webhook

Enter the Wemblo callback URL and verify token in Meta, subscribe to events and test inbound messages and status updates.

Overview

Search Aliases: WhatsApp webhook URL, callback URL, verify token, messages webhook

THREE DIFFERENT VALUES

Callback URL: HTTPS Wemblo endpoint that receives Meta events.

Webhook Verify Token: Setup value used during the verification handshake.

Meta Access Token: Separate secret used by Wemblo to authorize API calls.

WEMBLO-SIDE PREPARATION

  1. Open Wemblo -> Integrations -> WhatsApp -> Webhook Controls.
  2. Copy the callback URL.
  3. Copy the verify-token value.
  4. Do not copy the access token into the Meta verify-token field.

META-SIDE SETUP

  1. Open Meta for Developers.
  2. Select the correct app.
  3. Open WhatsApp -> Configuration or Webhooks.
  4. Choose the WhatsApp object where required.
  5. Enter the Wemblo callback URL.
  6. Enter the Wemblo verify token.
  7. Choose Verify and Save.
  8. Subscribe to required fields, including message events and status updates supported by the current Meta configuration.
  9. Save.

INBOUND TEST

  1. Use a separate phone to message the connected business number.
  2. Confirm the event appears in the Wemblo webhook/event log.
  3. Confirm the conversation appears in Smart Inbox All and WhatsApp.
  4. Confirm the contact is created or updated.

STATUS TEST

  1. Send a test outbound message.
  2. Review sent, delivered, read or failed status where Meta provides the event.
  3. Confirm the status belongs to the correct message and workspace.

COMMON ISSUES & SOLUTIONS

Verification failsConfirm HTTPS, exact callback URL and exact verify token.
Verification succeeds but no messagesCheck event subscriptions, selected app, WABA and number.
Duplicate eventsHandle retries and idempotency in the receiving workflow.
Status events missingConfirm subscribed fields and provider support.
Wrong workspace receives eventReview the WABA/number mapping.

OFFICIAL LINK

https://developers.facebook.com/docs/whatsapp/cloud-api/webhooks/

Last reviewed: