Quick Start

Follow this flow when setting up a new integration. It starts in the customer dashboard, then moves to a public v2 request using POST /api/v2/chat.

Before You Call the API

1. Sign in to the Whats91 customer dashboard.
2. Complete WhatsApp Cloud API setup for at least one sender number under WhatsApp -> WhatsApp Setup or the current onboarding flow.
3. Confirm the active sender in the dashboard number selector.
4. Generate a public API token from Developer -> API Tokens.
5. Use Authorization: Bearer <token> on all public v2 requests.

Send a Text Message

Start with a free-form text message through POST /api/v2/chat. Include senderId when your token can access more than one connected WhatsApp sender.

curl -X POST "https://graph.whats91.com/api/v2/chat" \
  -H "Authorization: Bearer w91_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "senderId": "919999999999",
    "to": "918888888888",
    "type": "text",
    "text": "Hello from Whats91"
  }'

Expected Response

{
  "success": true,
  "message": "Message accepted by Meta",
  "data": {
    "messageId": "wamid.xxxxx",
    "message_id": "wamid.xxxxx",
    "queued": false,
    "status": "accepted",
    "senderId": "919999999999",
    "phoneNumberId": "1234567890",
    "receiverId": "918888888888",
    "messageType": "text",
    "templateName": null,
    "apiResponse": {}
  },
  "metadata": {
    "apiVersion": "v2",
    "requestId": "request-uuid",
    "processingTimeMs": 120
  }
}

Next Steps

1. Create or sync templates under WhatsApp -> Templates.
2. After Meta approval, send templates through POST /api/v2/send.
3. Configure status webhooks under Settings -> Webhooks.
4. Monitor delivery and failures under Reports -> All Messages, Reports -> All Events, and Developer -> Logger.