# Setup Facebook App for WhatsApp & Facebook Bots

Facebook App is needed with valid permission & advance access for the setting of the WhatsApp Automated onboarding and Facebook Bot. Here is the pre-requisites and process for the same.

### Pre-Requisites <a href="#pre-requisites" id="pre-requisites"></a>

To enable Facebook App integration, you will need the following details

#### Required Details for Integration on the BotPenguin Portal <a href="#required-details-for-integration-on-the-botpenguin-portal" id="required-details-for-integration-on-the-botpenguin-portal"></a>

* App ID
* App Secret
* System User Token
* App Config ID

#### Other Required Details <a href="#other-required-details" id="other-required-details"></a>

Apart from the above, You will require the following to make your integration work properly.

* Verified Meta Business Manager
* Valid Privacy Policy and Terms & Conditions link
* Advance permissions Approval from Meta
  * whatsapp\_business\_messaging
  * public\_profile
  * email
  * whatsapp\_business\_management
  * catalog\_management
  * pages\_manage\_metadata
  * pages\_messaging
  * Business Asset User Profile Access
  * pages\_user\_locale
  * pages\_user\_timezone
  * pages\_user\_gender
  * pages\_read\_engagement
  * business\_management
  * pages\_show\_list

### Step 1: Set Up Your Meta App

Follow the steps below to create your Meta App:

1. Go to **Meta for Developers**.
2. Click **My Apps → Create App**.
3. Select **Business** as the app type.
4. Enter the required details:
   * **App Name**
   * **App Contact Email**
   * **Business Manager Account**
5. Click **Create App** and complete the security check.
6. Once the app is created, note down the **App ID** from the dashboard.

{% content-ref url="/pages/CANQcnIGc4BN3cuMOgeS" %}
[Create Facebook Login for Business Configuration](/partner-platform-guidelines/integration-setup/setup-facebook-app-for-whatsapp-and-facebook-bots/create-facebook-login-for-business-configuration.md)
{% endcontent-ref %}

***

### Step 2: Set Up System User Token

Follow the steps below to create a System User and generate an access token:

1. Go to **Meta Business Manager**.
2. Navigate to **Business Settings → Users → System Users**.
3. Click **Add** and create a **System User** (Admin access recommended).
4. Assign the created system user to your Meta App.
5. Generate a **System User Access Token** with the required permissions:
   * WhatsApp Business Management
   * WhatsApp Business Messaging
6. Copy and securely save the generated token.

{% content-ref url="/pages/E1u4ATSzjH8sijm0H0i7" %}
[Meta System User Token](/partner-platform-guidelines/integration-setup/setup-facebook-app-for-whatsapp-and-facebook-bots/meta-system-user-token.md)
{% endcontent-ref %}

***

### Step 3: Create App Configuration for WhatsApp Automated Onboarding

Follow the steps below to create the App Configuration and get the **App Config ID**:

1. Open your Meta App in **Meta for Developers**.
2. Go to **Products → Facebook Login for Business**.
3. Add and configure **Facebook Login for Business**.
4. Complete the required setup:
   * Business verification
   * Valid redirect URLs
5. Generate the **App Configuration ID** once setup is completed.
6. Save the App Config ID for further use.

{% embed url="<https://www.youtube.com/watch?v=d-ogYLsO3QQ>" %}

***

### Step 4: Share Details for Approval & Further Configuration

Once all the above steps are completed:

1. Ensure the following are ready:
   * Meta App created
   * System User Token generated
   * App Config ID available
   * Valid **Privacy Policy URL**
   * Valid **Terms & Conditions URL**
2. Share access to your **Meta Business Manager**.
3. Follow this official guide to grant access:\
   <https://www.facebook.com/business/help/2169003770027706>
4. Share Business Manager access with the following email:

   ```
   ajaysudhakar941@gmail.com
   ```
5. After access is shared, the team will proceed with:
   * App review
   * WhatsApp onboarding
   * Final configuration

***

### Completion

Once approval and configuration are completed, **WhatsApp Automated Onboarding** will be enabled for your setup.

#### ❓ Got any questions? <a href="#got-any-questions" id="got-any-questions"></a>

Please feel free to reach out to us at <mark style="color:$primary;"><support@botpenguin.com></mark>, in case of any questions or concerns.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://partners.botpenguin.com/partner-platform-guidelines/integration-setup/setup-facebook-app-for-whatsapp-and-facebook-bots.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.