Skip to main content

​
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

Meta Business Suite Configure WhatsApp API in Meta Business Suite

​
Steps to Create WhatsApp API Credentials

​
1. Create Meta Business Account

  1. Visit Meta Business Suite
  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: Use the separate WhatsApp Trigger API credential for incoming-message trigger webhooks.