> For the complete documentation index, see [llms.txt](https://help.botpenguin.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.botpenguin.com/bots/whatsapp-bot/bot-setup/whatsapp-bot-creation-with-manual-onboarding/subscribe-wa-webhook-with-botpenguin.md).

# Subscribe WA webhook with BotPenguin

This page guides you through configuring the WhatsApp webhook on the Meta Developer Dashboard so that your WhatsApp Bot can receive messages and notifications through BotPenguin.

### Before You Begin

* You must have completed the [Register & Verify Your WhatsApp Number](https://help.botpenguin.com/bots/whatsapp-bot/bot-setup/whatsapp-bot-creation-with-manual-onboarding/register-and-verify-your-whatsapp-number) step.
* Make sure you are using the **latest available API version** in your Meta Developer Dashboard. Using an outdated version may cause webhook delivery issues.

***

### Step 1: Open the Meta Developer Dashboard

1. Go to [developers.facebook.com](https://developers.facebook.com/).
2. Log in and open your Meta App.

***

### Step 2: Go to API Setup

1. In the left sidebar, click **WhatsApp → API Setup**.

<figure><img src="https://1745791824-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAPDb8cKQtGlIAfgHjcsQ%2Fuploads%2F8C3Oxm5YhLWLVuhRakzR%2FAPI%20Setup.png?alt=media&amp;token=b6589163-1f84-4b24-80b9-e93fa936b96f" alt="Locate WhatsApp API Setup"><figcaption><p>Locate WhatsApp API Setup</p></figcaption></figure>

2. Scroll to **Step 3: Configure webhooks to receive messages**.
3. Click **Configure Webhooks**.

<figure><img src="https://1745791824-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAPDb8cKQtGlIAfgHjcsQ%2Fuploads%2FRDMmWqXc68BaNIMmtiwC%2FConfigure%20Webhook%20Start.png?alt=media&amp;token=39d86d42-54cf-401a-b364-6f1f0a11bb9f" alt="Configure webhooks"><figcaption><p>Configure webhooks</p></figcaption></figure>

### Step 3: Edit the Webhook Callback URL

1. On the Configuration page, click **Edit**.

<figure><img src="https://1745791824-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAPDb8cKQtGlIAfgHjcsQ%2Fuploads%2FBxzgTJbgkoIEqXI5SFRn%2FEdit%20Webhook.png?alt=media&amp;token=93ec2b62-c4e0-4cf8-a9b0-031c4b80d8d2" alt="Edit Webhook URL"><figcaption><p>Edit Webhook URL</p></figcaption></figure>

2. A pop-up titled **Edit webhook's callback URL** will appear.
3. Enter the following details:

   | Field            | Value                                          |
   | ---------------- | ---------------------------------------------- |
   | **Callback URL** | `https://api.v7.botpenguin.com/whatsapp/cloud` |
4. Click **Verify and Save**.

{% hint style="info" %}
Enter the Callback URL and Verify Token exactly as shown above. Any typo will cause the verification to fail.
{% endhint %}

<figure><img src="https://1745791824-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAPDb8cKQtGlIAfgHjcsQ%2Fuploads%2FkNOHKEKbp851hrKdeMVN%2FEnter%20Webhook%20URL.png?alt=media&amp;token=e6ba0fd2-9bc4-443a-af3a-1fe1fce37444" alt="Enter Webhook Details"><figcaption><p>Enter Webhook Details</p></figcaption></figure>

### Step 4: Subscribe to Webhook Fields

1. Once the webhook URL is saved, click **Manage** next to the webhook.

<figure><img src="https://1745791824-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAPDb8cKQtGlIAfgHjcsQ%2Fuploads%2FBGK0oQVA7jCPxp3LODHH%2FManage%20webhook%20Field.png?alt=media&amp;token=5755e728-b4d9-4a2f-bc13-fbadd2f0f7a2" alt="Manage Webhook Fields"><figcaption><p>Manage Webhook Fields</p></figcaption></figure>

1. A **Webhook Fields** pop-up will appear listing all available fields.
2. Subscribe to **all available fields**, with the following three exceptions — no need to subscribe to:
   * `message_echoes`
   * `messaging_handovers`
   * `standby`

<figure><img src="https://1745791824-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAPDb8cKQtGlIAfgHjcsQ%2Fuploads%2FghmlyQi7A6sI1OoZdA5a%2FSubscriber%20fields.png?alt=media&amp;token=b046c49d-6470-416c-a5ce-a57386e210db" alt="Subscribe to Webhook Events"><figcaption><p>Subscribe to Webhook Events</p></figcaption></figure>

4. Save your selections.

***

### What's Next

Your webhook is now configured. Proceed to the next step:

{% content-ref url="/pages/mXRICYBfVKoZWqQrjzyt" %}
[Update WA account Payment Method](/bots/whatsapp-bot/bot-setup/whatsapp-bot-creation-with-manual-onboarding/update-wa-account-payment-method.md)
{% endcontent-ref %}

***

### Support

If everything is correct and you are still unable to move forward, write to us at <support@botpenguin.com>. We will respond back within 48 business hours.