WABA Proxy API Docs

Complete programmatic control over your WhatsApp Business Account. Use a single API Key to manage messages, templates, media uploads, interactive flows, QR codes, profiles, and analytics.

Base API URL

All resource queries are prefixed with:

https://api.taqwashield.com

API Token Key

Create Key

Authorize sandbox calls (headers: x-api-key):

Phone Override

Override default sender (header: x-from-phone-number-id):

API Guides & Developer Guidelines

Welcome to R&B Solutions WABA Proxy API! Follow these 4 simple steps to send your first message:

1

Get API Key

Go to Developer → API Keys tab and generate a new key. Keep this key secret.

2

Authenticate

Include your API Key in the headers of all HTTP requests as x-api-key: rb_sk_....

3

Send Message

Post to /api/v1/messages/send. Check out the copy-pasteable snippets below for JS, Python, and Curl.

4

Webhooks

Go to Developer → Webhooks to configure your payload callback URL for real-time delivery status.

Quick Start & Implementation Snippets

# Send a text message
curl -X POST https://api.taqwashield.com/api/v1/messages/send \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "x-from-phone-number-id: OPTIONAL_PHONE_NUMBER_ID" \
  -d '{
    "to": "923001234567",
    "type": "text",
    "message": { "body": "Hello from R&B API!" }
  }'

# Send a template message
curl -X POST https://api.taqwashield.com/api/v1/messages/send \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
    "to": "923001234567",
    "type": "template",
    "message": {
      "name": "hello_world",
      "language": { "code": "en_US" }
    }
  }'

API Categories

Endpoints (45)

Receiving Webhooks (Event Dispatcher)

Configure your endpoint URL in the Webhooks tab in the sidebar. R&B will proxy raw Meta Cloud API payloads to your URL asynchronously.

Webhook Event Logic

R&B triggers an HTTP POST request to your URL upon any incoming activity.
Each request includes an X-RB-Business-Id and optionally X-Webhook-Secret header.
Your handler must return a 2xx response within 30 seconds.
If delivery fails, R&B retries up to 3 times with exponential backoff.

Event payload Structure

The payload follows the official WhatsApp Cloud Webhook schema:

{
  "object": "whatsapp_business_account",
  "entry": [{
    "id": "WABA_ID",
    "changes": [{
      "value": {
        "messaging_product": "whatsapp",
        "metadata": { "phone_number_id": "PHONE_ID" },
        "messages": [{
          "from": "923001234567",
          "id": "wamid.xxxx",
          "type": "text",
          "text": { "body": "Hi there!" }
        }]
      },
      "field": "messages"
    }]
  }]
}