## WhatsApp Business integration

Integrating WhatsApp Business with Frontegg lets your application read and manage WhatsApp Business Accounts (WABAs), send and receive messages, manage phone numbers and message templates, and act on behalf of a business on the WhatsApp Business Platform — all through Frontegg's integration layer using Meta OAuth.

The integration is built on top of the [Meta Graph API](https://developers.facebook.com/docs/graph-api) and the [WhatsApp Business Cloud API](https://developers.facebook.com/docs/whatsapp/cloud-api). You configure the integration by creating a Meta for Developers app, connecting it to a Meta Business Portfolio, and adding the required permissions.

Prerequisites
- A [Meta for Developers](https://developers.facebook.com/) account with a verified phone number and email.
- A [Meta Business Portfolio](https://business.facebook.com/) (also called a Business Manager account). If your company already has one, ask your business admin to add you instead of creating a new portfolio.
- A [WhatsApp Business Account (WABA)](https://www.facebook.com/business/help/2087193751603668) connected to that Business Portfolio, with at least one verified phone number.
- Permission to create apps in the Business Portfolio and request data access (typically Admin role).


### Create a Meta app

#### Step 1: Open the Meta for Developers apps page

Sign in to the [Meta for Developers apps page](https://developers.facebook.com/apps/) with your Facebook account. Click **Create App** to start the app creation flow.

![Meta for Developers Apps page with Create App highlighted](/assets/whatsapp-business-1.d7f778c28ebda439d5d8c46c9e54e85aaf3cf4f5a87f167e5c1e1b6e07649eb4.1ce25488.png)

#### Step 2: Add app details

Enter an **App name** (for example, `Frontegg Integration`) and confirm the **App contact email**. Meta uses this email for policy notifications and recovery — set it to an address you check regularly. Click **Next**.

![Create an app App details step with name filled in and Next highlighted](/assets/whatsapp-business-2.1724c738e3960103ddfde4b7c632570e886f4ee90b2bebe19b459b3e34b615d1.1ce25488.png)

#### Step 3: Select the WhatsApp use case

On the **Use cases** step, choose **Connect with customers through WhatsApp**. This automatically provisions the WhatsApp product, Facebook Login for Business, and the `whatsapp_business_management` and `whatsapp_business_messaging` permissions. Click **Next**.

Use cases can't be combined
After selecting the WhatsApp use case, other use cases (Facebook Login, Instant Games, etc.) become disabled on the same app. If you need them for a different integration, create a separate app.

![Use cases step with Connect with customers through WhatsApp highlighted](/assets/whatsapp-business-3.1838c7dd078e6cddb9bac0b408af9db17c709b8970bf5e83861fc9d7cc3c095d.1ce25488.png)

#### Step 4: Connect a Business Portfolio

On the **Business** step, choose the Business Portfolio that owns your WABA. If no portfolios are listed, create one in [Meta Business Manager](https://business.facebook.com/overview) first, then return to this step.

Click **Next** through the **Requirements** and **Overview** steps, then click **Create app**. Meta opens the app dashboard once the app is created.

### Copy the credentials

#### Step 5: Find the App ID and App secret

In the app dashboard, open **App settings → Basic** from the left navigation. Copy the **App ID** — this is your Frontegg **Client ID**. Click **Show** next to **App secret** (Meta asks you to re-enter your Facebook password), then copy the value — this is your Frontegg **Client Secret**.

Treat the App secret like a password
The App secret grants full access to your app. Never commit it to source control or share it outside the Frontegg portal configuration.

![App settings Basic page with App ID and App secret fields highlighted](/assets/whatsapp-business-4.1a92a080093f80a6b537c377759f6eeee5224c6d8f51bf8b2d5fc416991baf76.1ce25488.png)

### Configure the redirect URL

#### Step 6: Add the Frontegg redirect URI

In the left navigation, expand **Facebook Login for Business** and click **Settings**. In the **Valid OAuth Redirect URIs** field, paste your Frontegg redirect URL:

- `https://YOUR_MCP_GATEWAY_URL/integration-callback`


Replace `YOUR_MCP_GATEWAY_URL` with the MCP Gateway URL from the Frontegg portal **Settings → Basic configuration** page. Press **Enter** to add the URI, then click **Save changes** at the bottom of the page.

![Facebook Login for Business Settings page with Valid OAuth Redirect URIs configured](/assets/whatsapp-business-5.c1b3e5f07fac8d1576857eb6a2a784bfae3b5b2ad297f23b9aef32704bb06ad7.1ce25488.png)

### Configure permissions

#### Step 7: Add the business_management permission

In the left navigation, click **Use cases**, then open the **Connect with customers through WhatsApp** use case and select the **Permissions and features** tab. The WhatsApp use case ships with `whatsapp_business_management` and `whatsapp_business_messaging` already enabled (status **Ready for testing**). You need to add `business_management` manually — click **Add** in that row.

The integration requires the following permissions:

| Permission | Description |
|  --- | --- |
| `whatsapp_business_management` | Read and manage WhatsApp business assets: WABAs, phone numbers, message templates, QR codes, and webhook subscriptions. |
| `whatsapp_business_messaging` | Send WhatsApp messages and calls, upload and retrieve media, manage business profile info, and register phone numbers. |
| `business_management` | Read and write with the Business Manager API. Required so Frontegg can resolve the WABA your phone number belongs to. |


![Permissions and features tab with the three required WhatsApp scopes highlighted](/assets/whatsapp-business-6.6ae8e62decb35c2ef2342a749b7e6254738f8caaa25809f40f2f2e501df9f5f1.1ce25488.png)

App Review required for production
The `whatsapp_business_management`, `whatsapp_business_messaging`, and `business_management` permissions are usable for testing immediately, but Meta requires you to submit the app for [App Review](https://developers.facebook.com/docs/app-review/) before they can act on behalf of users outside your development team. App Review needs a Privacy Policy URL, an app icon, and a screencast demonstrating each permission.

### Configure the Frontegg portal

Once you have your **App ID (Client ID)** and **App secret (Client Secret)**, enter them in the Frontegg portal:

1. Open the **Frontegg portal** and navigate to [ENVIRONMENT] → Integrations → WhatsApp Business.
2. Enter the **Client ID** and **Client Secret** in the corresponding fields.
3. Select the required **scopes** (`whatsapp_business_management`, `whatsapp_business_messaging`, `business_management`).
4. Click **Save**.


When a user authorizes the integration, Meta prompts them to select a WABA and grant the requested permissions.

### Additional resources

- [WhatsApp Business Cloud API documentation](https://developers.facebook.com/docs/whatsapp/cloud-api)
- [WhatsApp Business Platform overview](https://developers.facebook.com/docs/whatsapp/business-management-api)
- [Meta Graph API permissions reference](https://developers.facebook.com/docs/permissions)
- [Meta App Review process](https://developers.facebook.com/docs/app-review/)
- [Meta for Developers apps page](https://developers.facebook.com/apps/)
- [How to get your Redirect URL](/agen-for-work/connectors/redirect-url)