Skip to main content

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

WhatsApp Trigger API credentials allow your SubverseAI agents to set up and manage WhatsApp message triggers and webhooks for real-time messaging workflows.

​
Overview

WhatsApp Trigger credentials provide access to:
  • WhatsApp webhook configuration
  • Message trigger setup
  • Real-time message reception
  • Event-driven workflows
  • Automated response systems

​
Dashboard Screenshot

Meta Business Suite Configure webhooks in Meta Business Suite

​
Steps to Create WhatsApp Trigger 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 Trigger Credentials

  1. Go to App Settings > Basic
  2. Copy the App ID
  3. Go to WhatsApp > API Setup
  4. Copy the Access Token
  5. Note your Phone Number ID
  6. Copy the Webhook Verify Token

​
6. Add to SubverseAI

  1. Go to Credentials in your SubverseAI dashboard
  2. Click Create New Credential
  3. Select WhatsApp Trigger API from the credential types
  4. Enter a name for your credential
  5. Fill in the required fields:
    • Access Token: Your WhatsApp API access token
    • Phone Number ID: Your WhatsApp phone number ID
    • App ID: Your Meta app ID
    • Webhook Verify Token: Your webhook verification token
    • Webhook URL: Your webhook endpoint URL
  6. Click Test Connection to verify the credentials work
  7. Click Save Credential

​
Required Fields

  • Name: A descriptive name for your credential
  • Access Token: Your WhatsApp API access token
  • Phone Number ID: Your WhatsApp Business phone number ID
  • App ID: Your Meta app ID
  • Webhook Verify Token: Token for webhook verification
  • Webhook URL: Your webhook endpoint URL

​
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

Webhook Verification Failed: Ensure your webhook URL is accessible and returns the correct verification token 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 Trigger 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