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

# WhatsApp OAuth API Credentials

> How to create and configure WhatsApp OAuth API credentials for SubverseAI

# WhatsApp OAuth API Credentials

WhatsApp OAuth API credentials allow your SubverseAI agents to authenticate with the WhatsApp Business Platform using OAuth client credentials for messaging workflows.

## Overview

WhatsApp OAuth API credentials provide access to:

* WhatsApp webhook configuration
* Message trigger setup
* Real-time message reception
* Event-driven workflows
* Automated response systems

## Dashboard Screenshot

<img src="https://mintcdn.com/subverse-611dde60/UJfqKuDwL_HYMF1w/images/credentials/whatsapp-oauth-api.png?fit=max&auto=format&n=UJfqKuDwL_HYMF1w&q=85&s=acf77ce8c0476575cb13636b7fcea07d" alt="Meta Business Suite" width="1520" height="1128" data-path="images/credentials/whatsapp-oauth-api.png" />

*Configure webhooks in [Meta Business Suite](https://business.facebook.com)*

## Steps to Create WhatsApp OAuth API Credentials

### 1. Set Up WhatsApp Business Account

1. Visit [Meta Business Suite](https://business.facebook.com)
2. Create or select your WhatsApp Business account
3. Verify your business information and phone number

### 2. Create WhatsApp App

1. Go to **Apps** in Meta Business Suite
2. Click **Create App**
3. Select **Business** app type
4. Enter app name (e.g., "SubverseAI WhatsApp Triggers")
5. Click **Create App**

### 3. Configure WhatsApp Product

1. In your app dashboard, click **Add Products**
2. Select **WhatsApp**
3. Configure WhatsApp settings:
   * Choose your WhatsApp Business Account
   * Set up message templates
   * Configure webhook settings

### 4. Set Up Webhook

1. In WhatsApp settings, go to **Webhooks**
2. Click **Configure**
3. Enter your webhook URL: `https://your-subverseai-domain.com/webhooks/whatsapp`
4. Select webhook events:
   * **Messages**: Incoming messages
   * **Message Status**: Delivery and read receipts
   * **Account Updates**: Account status changes
5. Click **Verify and Save**

### 5. Get OAuth Credentials

1. Go to the [Meta Developer Console](https://developers.facebook.com)
2. Select your WhatsApp Business app
3. Go to **App Settings** > **Basic**
4. Copy the **App ID** as your **Client ID**
5. Copy the **App Secret** as your **Client Secret**

### 6. Add to SubverseAI

1. Go to **Credentials** in your SubverseAI dashboard
2. Click **Create New Credential**
3. Select **WhatsApp OAuth API** from the credential types
4. Enter a name for your credential (e.g., Main WhatsApp)
5. Fill in the required fields:
   * **Client ID**: Your WhatsApp Business Platform OAuth Client ID from the Meta Developer Console
   * **Client Secret**: Your WhatsApp Business Platform OAuth Client Secret from the Meta Developer Console
6. Click **Save Credential**

## Required Fields

* **Name**: A descriptive name for your credential
* **Client ID**: Your WhatsApp Business Platform OAuth Client ID from the Meta Developer Console
* **Client Secret**: Your WhatsApp Business Platform OAuth Client Secret for secure authentication

## Usage Tips

* Use HTTPS URLs for webhooks
* Test webhook endpoints before going live
* Monitor webhook delivery and failures
* Use message templates for outbound messages
* Set up proper error handling for webhook failures

## Troubleshooting

**Invalid Client ID or Client Secret**: Verify the App ID and App Secret copied from the Meta Developer Console

**Message Not Received**: Check webhook event subscriptions and phone number status

**Rate Limit Exceeded**: Monitor message sending rates and implement throttling

**Template Rejected**: Follow WhatsApp's message template guidelines

## Next Steps

After creating your WhatsApp OAuth API credentials:

* Set up real-time message handling workflows
* Configure automated response systems
* Build customer support automations
* Monitor webhook performance and delivery
* Test message templates and interactive messages