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 AEC 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: aec_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 AEC 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. AEC will proxy raw Meta Cloud API payloads to your URL asynchronously.

Webhook Event Logic

AEC triggers an HTTP POST request to your URL upon any incoming activity.
Each request includes an X-AEC-Business-Id and optionally X-Webhook-Secret header.
Your handler must return a 2xx response within 30 seconds.
If delivery fails, AEC 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"
    }]
  }]
}