​

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

Configure webhooks in Meta Business Suite

​

Steps to Create WhatsApp OAuth API Credentials

​

1. Set Up WhatsApp Business Account

1. Visit Meta Business Suite
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
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