The Riffre API lets your own systems send WhatsApp Business messages on behalf of one of your connected phone numbers: plain text, approved templates, media (image, video, audio, document) and interactive list or button messages. It is a plain JSON REST API secured with a per-phone-number API key, with no SDK required to get started.

Base URL

Every account has its own API base URL, shown on the API Keys page for each WhatsApp phone number in your dashboard (WhatsApp Accounts -> a phone number -> API Keys). It looks like this:

https://riffrechat.com/api/v1

All endpoints in this documentation are relative to that base URL, for example POST /messages.php means POST https://riffrechat.com/api/v1/messages.php.

What the API can do

• Send a plain text message, optionally with a link preview.
• Send an approved template message, in any language your WhatsApp Business Account supports.
• Send image, video, audio or document messages, either from a public HTTPS link or from a file you uploaded through the Media API.
• Send an interactive list message (a scrollable menu of selectable rows) or an interactive button message (up to three quick-reply buttons).
• Upload media ahead of time and reuse the returned media ID across multiple messages.

A minimal request

curl -X POST "https://riffrechat.com/api/v1/messages.php" \
  -H "Authorization: Bearer rf_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "919876543210",
    "type": "text",
    "text": { "body": "Hello from Riffre!" }
  }'

A successful call returns 202 Accepted immediately with a queue_id - see Send a Text Message for the full response shape. The message is queued and delivered asynchronously; it is not sent synchronously within the request.

Where to go next

1. Authentication - how API keys work and how to get one.
2. Rate Limits - per-minute and per-day request limits.
3. Send a Text Message - the simplest message type.
4. SDKs & Code Samples - ready-to-run client libraries for PHP, Python, Node.js, Java, C#, C++, Shopify, WordPress, Flutter, Cordova, Capacitor and React.