# Setup of Facebook OAuth App

Facebook Authentication allows you to provide **Facebook as a chatbot platform** to your customers.\
To enable this, you need to create a **Meta App** and add its credentials in the **Integrations → Facebook** section.

***

### Required Information

To add Facebook integration, you will need:

* **Configuration Name**
* **App ID**
* **App Secret**

These details are obtained from your **Meta Business Account**. Below is the process to get the same

***

### Step 1: Create a Meta App

1. Go to **Meta for Developers**.
2. Click **My Apps → Create App**.
3. Select **Business** as the app type.
4. Fill in:
   * **App Name**
   * **App Contact Email**
   * **Business Manager Account**
5. Click **Create App** and complete verification.
6. Once created, copy the **App ID** from the App Dashboard.

{% content-ref url="/pages/KMVqgVlSJCu1IjPP0fu9" %}
[Setup Facebook App for WhatsApp & Facebook Bots](/partner-platform-guidelines/integration-setup/setup-facebook-app-for-whatsapp-and-facebook-bots.md)
{% endcontent-ref %}

***

### Step 2: Add Required Products to the App

1. Inside your Meta App dashboard, go to **Add Products**.
2. Add the following:
   * **Facebook Login**
   * **Messenger** (if required for chatbot use)
3. Complete the basic setup shown for each product.

***

### Step 3: Get the App Secret

1. In the Meta App dashboard, go to **Settings → Basic**.
2. Locate the **App Secret**.
3. Click **Show** and authenticate to view it.
4. Copy and securely save the **App Secret**.

***

### Step 4: Save Facebook Configuration 

1. Log in to the **Agency Panel**.
2. Navigate to **Integrations → Facebook**.
3. Click on Configure button.

<figure><img src="/files/nBb4AqKxxhjBA127Bo8X" alt=""><figcaption></figcaption></figure>

3. View the existing configuration and edit it , Change the status, View the details.
4. To Add new , Click on **Add Configuration** button.

<figure><img src="/files/kG7HaSszoRwL4XZIyzPG" alt=""><figcaption></figcaption></figure>

5. Under **Add Facebook Integration Details**, enter:

* **Configuration Name** (e.g. Default, Production, Client Name)
* **App ID**
* **App Secret**

Click **Add Configuration**.

Once saved:

* The configuration appears in the list
* Status is shown as **Active**
* You can **edit or disable** it anytime using the Actions column

<figure><img src="/files/SeCj10XkhrDj329gOmST" alt=""><figcaption></figcaption></figure>

***

### Step 5: Verify Configuration Status

* **Green toggle** indicates the configuration is active
* Use the **Details (ℹ️)** icon to view configuration info
* Use the **Edit ✏️** icon to update credentials if needed

***

### Completion

Once the Facebook configuration is added and active:

* Businesses using your platform can offer **Facebook chatbots**
* Facebook authentication becomes available for bot setup
* The integration can be reused across multiple bots

***

### Important Notes

* App ID and App Secret are **environment-specific**
* Do not share App Secret publicly
* Ensure the Meta App remains **active and not deleted**
* Any changes in Meta App credentials must be updated here

#### Need Help?

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-of-facebook-oauth-app.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.