> ## Documentation Index
> Fetch the complete documentation index at: https://chatbotx.io/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# WhatsApp Embedded Signup

> Connect WhatsApp Business to ChatbotX via Meta's Embedded Signup flow.

## Prerequisites

Before you begin, make sure you have:

* A valid Facebook account
* A WhatsApp Business account (or the ability to create one)
* A ChatbotX installation with a publicly accessible URL
* Admin access to your ChatbotX installation

<Info>
  If you are developing locally, you will need a tunneling tool such as [ngrok](/channels/local-development-with-tunnels) to expose your local server to the internet.
</Info>

## Step 1: Create a Facebook App

If you already have a Facebook App (for example, from your [Messenger channel setup](/channels/facebook-messenger)), you can reuse it and skip directly to [Step 2](#step-2--configure-credentials-in-chatbotx).

<Steps>
  <Step title="Create a new app">
    Go to the [Facebook Developer Portal](https://developers.facebook.com/apps/) and click **Create App**.

    <Frame>
      <img src="https://mintcdn.com/chatbotx/6419eoAF_uo2OCBi/images/image-1.png?fit=max&auto=format&n=6419eoAF_uo2OCBi&q=85&s=a4312497d6e27a9d63e2c2adc4fd6d12" alt="Create App button in the Facebook Developer Portal" width="2409" height="757" data-path="images/image-1.png" />
    </Frame>
  </Step>

  <Step title="Enter app details">
    Enter your **App name** and **contact email**, then click **Next**.

    <Frame>
      <img src="https://mintcdn.com/chatbotx/bk1D42eDWTivbgT_/images/image-2.png?fit=max&auto=format&n=bk1D42eDWTivbgT_&q=85&s=5249012405fdb92ea7cadc59bbcd09ce" alt="App name and contact email fields" width="2197" height="937" data-path="images/image-2.png" />
    </Frame>
  </Step>

  <Step title="Select a use case">
    When asked for a use case, select **Other**.

    <Frame>
      <img src="https://mintcdn.com/chatbotx/bk1D42eDWTivbgT_/images/image-3.png?fit=max&auto=format&n=bk1D42eDWTivbgT_&q=85&s=bbd6313775d17a3971de57329c78c56f" alt="Use case selection — Other option highlighted" width="2151" height="1708" data-path="images/image-3.png" />
    </Frame>
  </Step>

  <Step title="Choose app type">
    For the app type, choose **Business**.

    <Frame>
      <img src="https://mintcdn.com/chatbotx/bk1D42eDWTivbgT_/images/image-4.png?fit=max&auto=format&n=bk1D42eDWTivbgT_&q=85&s=a7bc6f433111bee494f0220d8505799c" alt="App type selection — Business option highlighted" width="2173" height="844" data-path="images/image-4.png" />
    </Frame>
  </Step>

  <Step title="Finish creation">
    Review your details and click **Create App** to finish.

    <Frame>
      <img src="https://mintcdn.com/chatbotx/bk1D42eDWTivbgT_/images/image-5.png?fit=max&auto=format&n=bk1D42eDWTivbgT_&q=85&s=5d530bddb2eeb78f5d24962a31fcfbb1" alt="Confirmation screen before creating the app" width="2177" height="1104" data-path="images/image-5.png" />
    </Frame>
  </Step>

  <Step title="Get your App ID and App Secret">
    After creating your app, go to **Settings → Basic** to find your **App ID** and **App Secret**. Click **Show** and authenticate with your Facebook password to reveal the App Secret. You will need both values in the next step.

    <Frame>
      <img src="https://mintcdn.com/chatbotx/bk1D42eDWTivbgT_/images/image-6.png?fit=max&auto=format&n=bk1D42eDWTivbgT_&q=85&s=0d075ac6d3a6ff00f748941fa54aecfa" alt="App ID and App Secret in Basic Settings" width="2529" height="1463" data-path="images/image-6.png" />
    </Frame>
  </Step>
</Steps>

## Step 2: Configure Credentials in ChatbotX

A Super Admin must enter the WhatsApp credentials in ChatbotX before the integration can work. Complete this step immediately after obtaining your App ID and App Secret.

<Steps>
  <Step title="Open Integrations">
    In your ChatbotX installation, navigate to:

    ```text theme={null}
    https://app.yourdomain.com/manage/integrations
    ```

    Then select **WhatsApp**.

    <Frame>
      <img src="https://mintcdn.com/chatbotx/FAZvdFXI0s4AXKUI/images/image-324.png?fit=max&auto=format&n=FAZvdFXI0s4AXKUI&q=85&s=0471241e688176267f8cf109e251d6b6" alt="chatbotx_super_admin_integrations_whatsapp" width="2830" height="1665" data-path="images/image-324.png" />
    </Frame>
  </Step>

  <Step title="Open the WhatsApp configuration">
    Find the **WhatsApp** card and click the **Edit** button to open the configuration modal.

    <Frame>
      <img src="https://mintcdn.com/chatbotx/FAZvdFXI0s4AXKUI/images/image-325.png?fit=max&auto=format&n=FAZvdFXI0s4AXKUI&q=85&s=706cef1b1dc38a7e1155146702137b89" alt="chatbotx_super_admin_whatsapp_edit_modal" width="2867" height="1805" data-path="images/image-325.png" />
    </Frame>
  </Step>

  <Step title="Fill in the WhatsApp credentials">
    In the **Edit WhatsApp** modal, fill in the following fields:

    | Field                         | Description                                       | Where to find                                                                                                                         | Example            |
    | ----------------------------- | ------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------- | ------------------ |
    | **Client ID**                 | Facebook **App ID**                               | [Meta Developer Portal](https://developers.facebook.com/apps/) → App → **Settings → Basic**                                           | `1974877133429651` |
    | **Client Secret**             | Facebook **App Secret**                           | Same page → click **Show**                                                                                                            | `●●●●●●●●●●`       |
    | **API Version**               | Graph API version                                 | App → **Settings → Advanced → API Version**                                                                                           | `v1.0`             |
    | **Webhook Verify Token**      | Random string for webhook verification            | Self-generated                                                                                                                        | `i7CTHYSF66uEHS3B` |
    | **App Config ID**             | Configuration ID from the Embedded Signup wizard  | **Facebook Login for Business → Configurations**. See [Step 4](#step-4--obtain-configuration-id)                                      | `783655134328535`  |
    | **System User ID**            | System User's ID, obtained via Graph API Explorer | [Graph API Explorer](https://developers.facebook.com/tools/explorer/). See [Step 5](#step-5--obtain-system-user-id-and-token)         | `110835055179851`  |
    | **System User Token**         | Access token generated for your System User       | [Meta Business Settings](https://business.facebook.com/settings/system-users). See [Step 5](#step-5--obtain-system-user-id-and-token) | `EAACanps...`      |
    | **Business ID**\*(optional)\* | Meta Business Portfolio ID                        | [Meta Business Settings](https://business.facebook.com/settings/) → **Business Info**                                                 | `627055339164xxx`  |
    | **Business Name**             | Your business display name in ChatbotX            | Your own business name                                                                                                                | `botx`             |

    <Warning>
      **Client ID** and **Client Secret** must exactly match the values in your Facebook App's **Settings → Basic**. If any value is incorrect, the WhatsApp Embedded Signup flow will fail silently.
    </Warning>
  </Step>

  <Step title="Save">
    Click **Save** to apply the settings. The WhatsApp card will now display your **Client ID** and **Business Name**. WhatsApp Embedded Signup will now be available as a channel when creating chatbots.
  </Step>
</Steps>

## Step 3: Configure the WhatsApp Product

<Steps>
  <Step title="Add WhatsApp product to your app">
    In your Facebook app dashboard, click **Add Product** in the left sidebar. Find **WhatsApp** in the product list and click **Set Up**.

    <Frame>
      <img src="https://mintcdn.com/chatbotx/wunzjY8x_ggxMSs2/images/image-243.png?fit=max&auto=format&n=wunzjY8x_ggxMSs2&q=85&s=50197bee717da07cd1c0e038fb824da9" alt="Adding WhatsApp product" width="2797" height="1406" data-path="images/image-243.png" />
    </Frame>
  </Step>

  <Step title="Confirm the WhatsApp Quickstart dashboard">
    After clicking **Set Up**, you will be redirected to the **WhatsApp Quickstart** dashboard. This confirms the WhatsApp product has been added successfully.

    <Frame>
      <img src="https://mintcdn.com/chatbotx/wunzjY8x_ggxMSs2/images/image-244.png?fit=max&auto=format&n=wunzjY8x_ggxMSs2&q=85&s=2cd541497dd8532f8a2bab2e24e9db00" alt="whatsapp_quickstart_dashboard" width="2959" height="1558" data-path="images/image-244.png" />
    </Frame>

    <Warning>
      If you see a **"Missing valid payment method"** warning, click **Add payment method** to configure billing. Without a valid payment method, you will not be able to send messages beyond the free test tier.
    </Warning>

    <Note>
      **Do NOT click "Start using the API!"**. This button is for direct Cloud API setup, which requires manual webhook and phone number configuration. ChatbotX uses the **Embedded Signup** flow instead, which automates the entire process. Skip this section entirely.
    </Note>
  </Step>

  <Step title="Add Facebook Login for Business product">
    The Embedded Signup flow requires the **Facebook Login for Business** product. Go back to the app dashboard, click **Add Product**, find **Facebook Login for Business**, and click **Settings**.

    <Frame>
      <img src="https://mintcdn.com/chatbotx/wunzjY8x_ggxMSs2/images/image-245.png?fit=max&auto=format&n=wunzjY8x_ggxMSs2&q=85&s=0f1cd5fcf3285d573a3de7d8af0946f9" alt="facebook_app_login" width="2858" height="1502" data-path="images/image-245.png" />
    </Frame>

    <Note>
      If you already have **Facebook Login for Business** added (for example, from a previous [Messenger](/channels/facebook-messenger) or [Instagram](/channels/instagram) setup), skip this step and proceed to Step 4.
    </Note>
  </Step>
</Steps>

## Step 4: Obtain Configuration ID

The **Configuration ID** is the critical value that enables the WhatsApp Embedded Signup flow in ChatbotX. You obtain it from the **Facebook Login for Business** product settings through a 6-step configuration wizard.

<Steps>
  <Step title="Navigate to Facebook Login for Business configurations">
    In your Facebook app left sidebar, expand **Facebook Login for Business** and click **Configurations**. Click the **Create configuration** button to start the wizard.

    <Frame>
      <img src="https://mintcdn.com/chatbotx/wunzjY8x_ggxMSs2/images/facebook_login_for_business_configuration_menu.png?fit=max&auto=format&n=wunzjY8x_ggxMSs2&q=85&s=9d02c1395f789e44729c08a9c7700633" alt="Facebook Login For Business Configuration Menu" width="2952" height="1648" data-path="images/facebook_login_for_business_configuration_menu.png" />
    </Frame>
  </Step>

  <Step title="Name">
    Enter a descriptive name for this configuration (for example, `BotX`), then click **Next**.

    <Frame>
      <img src="https://mintcdn.com/chatbotx/wunzjY8x_ggxMSs2/images/facebook_create_configuration_step_name.png?fit=max&auto=format&n=wunzjY8x_ggxMSs2&q=85&s=771add6700f99d5e47139395d1ac5b2c" alt="Facebook Create Configuration Step Name" width="2952" height="795" data-path="images/facebook_create_configuration_step_name.png" />
    </Frame>
  </Step>

  <Step title="Login variation">
    Select **WhatsApp Embedded Signup** as the login variation, then click **Next**.

    <Frame>
      <img src="https://mintcdn.com/chatbotx/wunzjY8x_ggxMSs2/images/facebook_create_configuration_step_login_variation.png?fit=max&auto=format&n=wunzjY8x_ggxMSs2&q=85&s=6911f3fcc0ad8d05e86a8a1226f85f98" alt="Facebook Create Configuration Step Login Variation" width="2947" height="1068" data-path="images/facebook_create_configuration_step_login_variation.png" />
    </Frame>

    <Warning>
      This setting **cannot be changed later**. Make sure to select **WhatsApp Embedded Signup** before clicking **Next**.
    </Warning>
  </Step>

  <Step title="Products">
    Check the **WhatsApp Cloud API** checkbox at minimum, then click **Next**.

    <Frame>
      <img src="https://mintcdn.com/chatbotx/wunzjY8x_ggxMSs2/images/facebook_create_configuration_step_products.png?fit=max&auto=format&n=wunzjY8x_ggxMSs2&q=85&s=7a6665a06312bc5e9ec99101d6c3870c" alt="Facebook Create Configuration Step Products" width="2952" height="1287" data-path="images/facebook_create_configuration_step_products.png" />
    </Frame>

    <Warning>
      This setting **cannot be changed later**. Make sure to select at least **WhatsApp Cloud API** before clicking **Next**.
    </Warning>
  </Step>

  <Step title="Access token">
    Set **Token expiration** to **Never** for uninterrupted service, then click **Next**.

    <Frame>
      <img src="https://mintcdn.com/chatbotx/wunzjY8x_ggxMSs2/images/facebook_create_configuration_step_access_token.png?fit=max&auto=format&n=wunzjY8x_ggxMSs2&q=85&s=5c59c06e7eda7051acb406774368f73d" alt="Facebook Create Configuration Step Access Token" width="2954" height="1038" data-path="images/facebook_create_configuration_step_access_token.png" />
    </Frame>
  </Step>

  <Step title="Assets">
    Leave the default selections as-is — the wizard pre-selects the necessary assets based on your chosen products. Click **Next**.

    <Frame>
      <img src="https://mintcdn.com/chatbotx/wunzjY8x_ggxMSs2/images/facebook_create_configuration_step_assets.png?fit=max&auto=format&n=wunzjY8x_ggxMSs2&q=85&s=8b7a92561a0b9e746f0766ca6ca870a8" alt="Facebook Create Configuration Step Assets" width="2952" height="1411" data-path="images/facebook_create_configuration_step_assets.png" />
    </Frame>
  </Step>

  <Step title="Permissions">
    Review the permissions. Ensure at least these 3 WhatsApp permissions are included:

    | Permission                        | Purpose                                                            |
    | --------------------------------- | ------------------------------------------------------------------ |
    | `whatsapp_business_management`    | Read and manage WhatsApp Business assets (phone numbers, profiles) |
    | `whatsapp_business_messaging`     | Send and receive WhatsApp messages and make calls                  |
    | `whatsapp_business_manage_events` | Log events such as purchases, add-to-cart, and leads               |

    <Frame>
      <img src="https://mintcdn.com/chatbotx/wunzjY8x_ggxMSs2/images/facebook_create_configuration_step_permissions.png?fit=max&auto=format&n=wunzjY8x_ggxMSs2&q=85&s=b546d62bb17b66cce1106cf2a7ae4324" alt="Facebook Create Configuration Step Permissions" width="2964" height="1831" data-path="images/facebook_create_configuration_step_permissions.png" />
    </Frame>

    Click **Create** to finalize the configuration.
  </Step>

  <Step title="Copy the Configuration ID">
    A success dialog will appear. Copy the **Configuration ID** displayed, you will need it when filling in the credentials in Step 2.

    <Frame>
      <img src="https://mintcdn.com/chatbotx/wunzjY8x_ggxMSs2/images/facebook_configuration_id_generated_copy.png?fit=max&auto=format&n=wunzjY8x_ggxMSs2&q=85&s=9db1c6bf2bc971d79efe1b1ba16edb12" alt="Facebook Configuration Id Generated Copy" width="2954" height="976" data-path="images/facebook_configuration_id_generated_copy.png" />
    </Frame>
  </Step>
</Steps>

<Warning>
  Before overriding the current callback URI, your app must be subscribed to receive messages for the WhatsApp Business Account. This prevents error (#100) during webhook configuration. Ensure the `messages` webhook field is subscribed in your app's **Webhooks** settings under the **WhatsApp** product section.
</Warning>

## Step 5: Obtain System User ID and Token

<Steps>
  <Step title="Navigate to System Users">
    Go to [Meta Business Settings](https://business.facebook.com/settings/system-users) and navigate to **Users → System Users** in the left sidebar. If you don't have a System User yet, click **Add**, choose a name, and set the role to **Admin**.

    <Frame>
      <img src="https://mintcdn.com/chatbotx/sLgO8A9xEHP_0Ast/images/image-251.png?fit=max&auto=format&n=sLgO8A9xEHP_0Ast&q=85&s=2bcdad3dba07fd3981da1a4db37ab576" alt="meta_business_system_users" width="3035" height="1821" data-path="images/image-251.png" />
    </Frame>
  </Step>

  <Step title="Generate Access Token">
    Select your System User and click **Generate New Token**. Configure the following:

    1. **Select App**: choose your Facebook App
    2. **Token Expiration**: select **Never** to avoid disruptions
    3. **Select Permissions**: check these 3 permissions:

    | Permission                     | Purpose                                  |
    | ------------------------------ | ---------------------------------------- |
    | `business_management`          | Manage business assets and settings      |
    | `whatsapp_business_management` | Read and manage WhatsApp Business assets |
    | `whatsapp_business_messaging`  | Send and receive WhatsApp messages       |

    <Frame>
      <img src="https://mintcdn.com/chatbotx/sLgO8A9xEHP_0Ast/images/image-252.png?fit=max&auto=format&n=sLgO8A9xEHP_0Ast&q=85&s=3b614fa3128c76ee9a6b92390240f110" alt="meta_system_user_generate_token" width="3035" height="1821" data-path="images/image-252.png" />
    </Frame>

    <Frame>
      <img src="https://mintcdn.com/chatbotx/sLgO8A9xEHP_0Ast/images/image-253.png?fit=max&auto=format&n=sLgO8A9xEHP_0Ast&q=85&s=4f2e5b5b2d8f139966e4b6aa48fa5eee" alt="meta_system_user_assign_permissions" width="2989" height="1807" data-path="images/image-253.png" />
    </Frame>

    Click **Generate Token**. Copy the generated token, this is your **System User Token**.

    <Warning>
      Save the token immediately. You will not be able to view it again after closing the dialog.
    </Warning>
  </Step>

  <Step title="Get System User ID via Graph API Explorer">
    Go to the [Meta Graph API Explorer](https://developers.facebook.com/tools/explorer/), paste your **System User Token** into the **Access Token** field, set the request to `GET /me`, and click **Submit**. Copy the `id` value from the response, this is your **System User ID**.

    ```json theme={null}
    {
      "name": "Your System User Name",
      "id": "110835055179851"
    }
    ```
  </Step>
</Steps>

## Step 6: Create a WhatsApp Channel

Once the Super Admin has configured the integration credentials, users can connect their WhatsApp Business accounts through the Embedded Signup flow.

<Steps>
  <Step title="Navigate to Channel Selection">
    Go to **Settings → Channel** and click **Add WhatsApp**.

    <Frame>
      <img src="https://mintcdn.com/chatbotx/voS3Qh6j-s9Wg2oh/images/image-223.png?fit=max&auto=format&n=voS3Qh6j-s9Wg2oh&q=85&s=44b713c4420ac6e880c213e1bbdcfeee" alt="whatsapp_channel_selection" width="3019" height="1263" data-path="images/image-223.png" />
    </Frame>
  </Step>

  <Step title="Choose your WhatsApp connection">
    Select the option that best fits your needs and click **Continue**:

    * **Connect an existing WhatsApp Business Account**: use if you already have a Meta Business account set up
    * **Transfer phone from another WhatsApp provider**: migrate your current number from a different BSP
    * **Marketing Message Lite**: for a marketing messaging setup

    <Frame>
      <img src="https://mintcdn.com/chatbotx/A6pCrJN_xX7SoHDW/images/image-366.png?fit=max&auto=format&n=A6pCrJN_xX7SoHDW&q=85&s=16222cf8f05ade8c306430755cb758e1" alt="whatsapp_provider_selection" width="1085" height="518" data-path="images/image-366.png" />
    </Frame>
  </Step>

  <Step title="Connect your account">
    Follow the Meta embedded signup flow to link your WhatsApp Business account. Review the permissions, accept the Meta Hosting Terms for Cloud API and the Meta Terms for WhatsApp Business, then click **Continue**.

    <Frame>
      <img src="https://mintcdn.com/chatbotx/sLgO8A9xEHP_0Ast/images/image-249.png?fit=max&auto=format&n=sLgO8A9xEHP_0Ast&q=85&s=425de7c5b7fd913987df51feed12def8" alt="whatsapp_facebook_authentication" width="1178" height="1406" data-path="images/image-249.png" />
    </Frame>
  </Step>

  <Step title="Select Business Assets">
    Choose your **Business portfolio** and **WhatsApp Business account** (or create new ones), then click **Next**.

    <Frame>
      <img src="https://mintcdn.com/chatbotx/qnZKYwi8GC0pQvAu/images/image-221.png?fit=max&auto=format&n=qnZKYwi8GC0pQvAu&q=85&s=80acb4a9dcc6a2a659fa511ac22056fa" alt="whatsapp_select_business_assets" width="1185" height="1410" data-path="images/image-221.png" />
    </Frame>
  </Step>

  <Step title="Fill Business Information">
    Enter your business **Name**, **Category**, **Website**, and **Time zone**, then click **Next**.

    <Frame>
      <img src="https://mintcdn.com/chatbotx/qnZKYwi8GC0pQvAu/images/image-222.png?fit=max&auto=format&n=qnZKYwi8GC0pQvAu&q=85&s=632d3b4eb4a6aa508616c30da2a547b3" alt="whatsapp_business_profile_details_setup" width="1185" height="1410" data-path="images/image-222.png" />
    </Frame>
  </Step>

  <Step title="Add your WhatsApp phone number">
    Enter your **WhatsApp Business display name** and add a phone number. Complete verification via SMS or voice call, then click **Next**.

    <Frame>
      <img src="https://mintcdn.com/chatbotx/GGISsHKnmtvJ9rNt/images/image-231.png?fit=max&auto=format&n=GGISsHKnmtvJ9rNt&q=85&s=8df0fa5e9d6ce027917644a55e60012a" alt="whatsapp_add_phone_number" width="1185" height="1410" data-path="images/image-231.png" />
    </Frame>
  </Step>

  <Step title="Review and Confirm Permissions">
    Review the selected assets and access levels, then click **Confirm** to complete the integration.

    <Frame>
      <img src="https://mintcdn.com/chatbotx/GGISsHKnmtvJ9rNt/images/image-225.png?fit=max&auto=format&n=GGISsHKnmtvJ9rNt&q=85&s=9b5a201a8f6a5812d0eb848cefe18d25" alt="meta_whatsapp_permission_review_confirmation" width="1183" height="1410" data-path="images/image-225.png" />
    </Frame>
  </Step>

  <Step title="Complete Setup">
    Your WhatsApp account is now connected. Click **Finish** on the Meta popup to be redirected to ChatbotX. Your new WhatsApp channel will appear in the inbox section.

    <Frame>
      <img src="https://mintcdn.com/chatbotx/sLgO8A9xEHP_0Ast/images/image-250.png?fit=max&auto=format&n=sLgO8A9xEHP_0Ast&q=85&s=f52e359d6af4184c197cf82661fa4eaf" alt="meta_whatsapp_connection_success_confirmation_details" width="1169" height="1400" data-path="images/image-250.png" />
    </Frame>

    <Frame>
      <img src="https://mintcdn.com/chatbotx/Cg6Fm0FCGSn8J1YO/images/image-224.png?fit=max&auto=format&n=Cg6Fm0FCGSn8J1YO&q=85&s=1707e1c9ac289384d6c9e4b365475389" alt="chatbotx_dashboard_whatsapp_channel_management_interface" width="2968" height="1490" data-path="images/image-224.png" />
    </Frame>
  </Step>
</Steps>

## Commerce Policy Compliance

Meta will review your business to ensure it complies with WhatsApp's Commerce Policy and will reach out within 24 hours if there's an issue.

## Troubleshooting

<AccordionGroup>
  <Accordion title="WhatsApp Embedded Signup option is not available">
    This usually means the Super Admin configuration is incomplete.

    **Checklist:**

    * Confirm the Super Admin has entered all required credentials (App ID, App Secret, Configuration ID) at `/manage/integrations`
  </Accordion>

  <Accordion title="Error (#100) during webhook configuration">
    Your app must be subscribed to receive messages **before** overriding the callback URI.

    **Fix:**

    1. Go to your Facebook app in the [Meta Developer Portal](https://developers.facebook.com/apps/)
    2. In the left sidebar, navigate to **WhatsApp → Configuration**
    3. Under **Webhooks**, subscribe to the `messages` field for WhatsApp Business Account
    4. Retry the Embedded Signup flow
  </Accordion>

  <Accordion title="Authentication errors during Embedded Signup">
    **Checklist:**

    * Ensure you are logged into a Facebook account with **admin access** to the Meta Business Portfolio
    * Verify your app has the required permissions: `whatsapp_business_management`, `whatsapp_business_messaging`, `whatsapp_business_manage_events`
    * Confirm the **App ID** and **App Secret** in the Super Admin panel match the values in **Settings → Basic** of the Meta Developer Portal
  </Accordion>

  <Accordion title="Business verification is pending or rejected">
    **What to do:**

    * Ensure your business information is **accurate and complete** (legal name, website, address)
    * Check that your business complies with [WhatsApp's Commerce Policy](https://www.whatsapp.com/legal/commerce-policy/)
    * New accounts have a temporary message limit until verification is completed
    * Verification typically takes **up to 1 business day**
  </Accordion>

  <Accordion title="App Review submission was rejected">
    **Steps to resolve:**

    1. Open the rejected submission in the [Meta Developer Dashboard](https://developers.facebook.com/apps/)
    2. Review the rejection reason and feedback provided by the review team
    3. Use the **Messenger support icon** (bottom right corner) to contact the review team for clarification
    4. Provide clear documentation of your use case, test credentials, and step-by-step instructions for the reviewer
    5. Resubmit after addressing all feedback
  </Accordion>

  <Accordion title="How do I get help if the issue persists?">
    1. **Check ChatbotX logs**: Look for error messages in both `rails` and `sidekiq` service logs
    2. **Verify Facebook/WhatsApp accounts**: Confirm all prerequisites (business verification, permissions, billing) are met
    3. **Contact Community Support**: Visit the [ChatbotX Community](https://discord.chatbotx.io) with specific error messages and screenshots
  </Accordion>
</AccordionGroup>

## Reference Documentation

For more technical details, refer to the official Meta documentation: [WhatsApp Embedded Signup - Meta for Developers](https://developers.facebook.com/docs/whatsapp/embedded-signup/).