WhatsApp API

Configure your WhatsApp Business API integration and send messages programmatically.

Setup Guide

Before using the WhatsApp endpoints, you need to obtain credentials from Facebook/Meta.

Step 1: Create Facebook Developer Account

1. Go to developers.facebook.com
2. Click 'Get Started' and create an account
3. Verify your email and phone number
4. Complete developer verification if prompted

Step 2: Create Facebook App

1. Go to 'My Apps' > 'Create App'
2. Select 'Business' as the app type
3. Fill in app name and contact email
4. Add WhatsApp product to your app
5. Note down your App ID and App Secret

Step 3: Set Up WhatsApp Business API

1. Go to WhatsApp > API Setup in your app
2. Add a phone number (or use test number)
3. Generate temporary access token
4. Note down your WhatsApp Business Account ID
5. Copy the temporary access token

Step 4: Generate System User Token

1. Go to Business Settings > System Users
2. Create a new system user
3. Assign WhatsApp Business Management permission
4. Generate a permanent access token
5. Save this token securely - it doesn't expire

Step 5: Configure Webhook (Optional)

1. Go to WhatsApp > Configuration
2. Add webhook URL: https://your-domain.com/webhook/whatsapp
3. Use a verify token (any random string)
4. Subscribe to messages and messaging_postbacks events
5. Verify webhook endpoint

Required Credentials

Troubleshooting

Configure WhatsApp Integration

Set up WhatsApp Business API credentials in your workspace.

POST /api/whatsapp/configure

Request Body:

{
  "facebookAppId": "your_facebook_app_id",
  "facebookAppSecret": "your_facebook_app_secret",
  "whatsappBusinessAccountId": "your_whatsapp_business_account_id",
  "accessToken": "your_system_user_access_token",
  "phoneNumberId": "your_phone_number_id",
  "webhookVerifyToken": "your_webhook_verify_token"
}

Response:

{
  "success": true,
  "message": "WhatsApp configuration saved successfully",
  "configuration": {
    "id": 1,
    "isConfigured": true,
    "phoneNumber": "+1234567890",
    "businessAccountId": "your_whatsapp_business_account_id",
    "tokenExpiresAt": "2025-12-31T23:59:59.000Z",
    "createdAt": "2025-01-01T00:00:00.000Z"
  }
}

Check WhatsApp Status

Check the status of your WhatsApp Business API integration.

GET /api/whatsapp/status

Response:

{
  "isConfigured": true,
  "isActive": true,
  "phoneNumber": "+1234567890",
  "businessAccountId": "123456789",
  "tokenStatus": "valid",
  "tokenExpiresAt": "2025-12-31T23:59:59.000Z",
  "lastSyncAt": "2025-01-01T12:00:00.000Z",
  "templatesCount": 5,
  "capabilities": {
    "sendMessages": true,
    "receiveMessages": true,
    "manageTemplates": true,
    "accessInsights": true
  }
}

Sync WhatsApp Templates

Import approved message templates from WhatsApp Business API.

POST /api/whatsapp/templates/sync

Response:

{
  "success": true,
  "message": "Templates synced successfully",
  "imported": 5,
  "updated": 2,
  "skipped": 1,
  "templates": [
    {
      "id": 1,
      "name": "welcome_message",
      "status": "APPROVED",
      "language": "en",
      "category": "MARKETING",
      "components": [
        {
          "type": "BODY",
          "text": "Hello {{1}}, welcome to {{2}}!"
        }
      ]
    }
  ]
}

Send WhatsApp Message

Send a message using WhatsApp Business API.

POST /api/whatsapp/send

Request Body:

{
  "to": "+1234567890",
  "type": "template",
  "template": {
    "name": "welcome_message",
    "language": {
      "code": "en"
    },
    "components": [
      {
        "type": "body",
        "parameters": [
          {
            "type": "text",
            "text": "John"
          },
          {
            "type": "text",
            "text": "Acme Corp"
          }
        ]
      }
    ]
  }
}

Response:

{
  "success": true,
  "message": "Message sent successfully",
  "messageId": "wamid.ABC123...",
  "status": "sent",
  "timestamp": "2025-01-01T12:00:00.000Z"
}

cURL Example:

curl -X POST "https://waflow.edesy.in/api/whatsapp/send" \
  -H "Content-Type: application/json" \
  -b cookies.txt \
  -d '{
    "to": "+1234567890",
    "type": "template",
    "template": {
      "name": "welcome_message",
      "language": {"code": "en"},
      "components": [
        {
          "type": "body",
          "parameters": [
            {"type": "text", "text": "John"},
            {"type": "text", "text": "Acme Corp"}
          ]
        }
      ]
    }
  }'

List WhatsApp Templates

Get all approved WhatsApp message templates.

GET /api/whatsapp/templates

Response:

{
  "templates": [
    {
      "id": 1,
      "name": "welcome_message",
      "status": "APPROVED",
      "language": "en",
      "category": "MARKETING",
      "components": [
        {
          "type": "HEADER",
          "format": "TEXT",
          "text": "Welcome!"
        },
        {
          "type": "BODY",
          "text": "Hello {{1}}, welcome to {{2}}! We're excited to have you on board."
        },
        {
          "type": "FOOTER",
          "text": "Best regards, Team"
        }
      ]
    }
  ],
  "total": 1
}

Testing Your Setup

After completing the setup:

1. Go to Settings > WhatsApp Configuration in WAFlow
2. Enter your credentials and save
3. Check that the status indicator turns green
4. Try syncing templates from WhatsApp
5. Send a test message to verify