> ## 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 API Credentials

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

# WhatsApp API Credentials

WhatsApp API credentials allow AgentVerse nodes and custom function actions to access the Meta WhatsApp Business Cloud API.

The credential stores:

* **Access Token** — authenticates requests to the Meta Graph API
* **Business Account ID** — loads sender phone numbers and approved message templates

The sender **Phone Number ID** is not stored in this credential. Select it in the WhatsApp node, or pass it explicitly as `options.phoneNumberId` to a WhatsApp custom function action.

## Dashboard Screenshot

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

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

## Steps to Create WhatsApp API Credentials

### 1. Create Meta Business Account

1. Visit [Meta Business Suite](https://business.facebook.com)
2. Create a Meta Business account
3. Verify your business information

### 2. Set Up WhatsApp Business Account

1. In Meta Business Suite, navigate to **WhatsApp**
2. Click **Get Started**
3. Register your phone number for WhatsApp Business
4. Verify your phone number

### 3. 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")
5. Click **Create App**

### 4. 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 URL (optional)

### 5. Get API Credentials

1. In Meta Business Suite, go to **WhatsApp** > **API Setup**
2. Generate or copy your permanent **Access Token**
3. Copy your **WhatsApp Business Account ID**
4. Note the **Phone Number ID** separately; actions require it at execution time

### 6. Add to SubverseAI

1. Go to **Credentials** in your SubverseAI dashboard
2. Click **Create New Credential**
3. Select **WhatsApp API** from the credential types
4. Enter a name for your credential (e.g., Customer Support)
5. Fill in the required fields:
   * **Access Token**: Your permanent WhatsApp Cloud API access token
   * **Business Account ID**: Your WhatsApp Business Account ID
6. Click **Save Credential**

## Required Fields

* **Name**: A descriptive name for your credential
* **Access Token**: Your WhatsApp Cloud API access token
* **Business Account ID**: Your WhatsApp Business Account ID

## Usage Tips

* Use message templates for outbound messages to comply with WhatsApp policies
* Set up webhooks to receive incoming messages in real-time
* Monitor message quality metrics in Meta Business Suite
* Use different phone numbers for different use cases

## Troubleshooting

**Invalid Access Token**: Regenerate the access token in Meta Business Suite

**Phone Number Not Verified**: Ensure your WhatsApp Business account is properly verified

**Message Template Rejected**: Follow WhatsApp's template guidelines and policies

**Webhook Not Working**: Verify webhook URL and SSL certificate

## Usage

Once saved, use this credential with:

* [WhatsApp Business Cloud node](/agentverse/nodes/whatsapp)
* [`subverseActions.whatsapp.sendTextMessage`](/integrations/agentic-functions/custom-function-actions#whatsapp-send-text-message)
* [`subverseActions.whatsapp.sendTemplateMessage`](/integrations/agentic-functions/custom-function-actions#whatsapp-send-template-message)
* [`subverseActions.whatsapp.sendMediaMessage`](/integrations/agentic-functions/custom-function-actions#whatsapp-send-media-message)

Use the separate [WhatsApp Trigger API credential](/credentials/types/whatsapp-trigger-api) for incoming-message trigger webhooks.