API v1.4 REST & Webhooks•Meta Cloud API v21.0 Certified

The WhatsApp Business API & Real-Time Webhooks Engine Built for Developers

Connect WhatsX to any stack in minutes. Dispatch high-throughput transactional broadcasts, stream customer conversations via signed HMAC webhooks, and automate complex workflows with sub-85ms latency.

< 85ms
P99 Dispatch Latency
99.99%
Uptime SLA Guaranteed
10,000+
Max Req/Sec Burst Rate
HMAC-SHA256
Tamper-Proof Webhooks
INTERACTIVE API SIMULATOR

Test Endpoints in Real-Time

Inspect request syntax across languages, simulate network roundtrips, and view instantaneous server responses.

POST /v1/messages/template
curl -X POST "https://api.whatsx.in/v1/messages/template" \ -H "Authorization: Bearer s7_live_948a7c2901ef" \ -H "Content-Type: application/json" \ -d '{ "to": "+919876543210", "template_name": "order_confirmed", "language": "en_US", "components": [ { "type": "body", "parameters": [ { "type": "text", "text": "Aarav Sharma" }, { "type": "text", "text": "ORD-94821" }, { "type": "text", "text": "₹2,499.00" } ] }, { "type": "button", "sub_type": "url", "index": "0", "parameters": [{ "type": "text", "text": "ORD-94821" }] } ] }'
200 OK ~64ms
Response Payload
{ "status": "success", "data": { "id": "wamid.HBgMOTE5ODc2NTQzMjEwFQIAERgSRjQyNDk5NTUzNjA4OTk5Q0ZBAA==", "recipient": "+919876543210", "template": "order_confirmed", "delivery_status": "enqueued", "latency_ms": 64, "pricing": { "category": "utility", "currency": "INR", "billable": true }, "created_at": "2026-11-05T12:45:00.124Z" } }
ARCHITECTURE & PERFORMANCE

Engineered for Massive Scale

Every millisecond counts. Built with zero-loss queue backpressure, high concurrency, and enterprise security.

High-Throughput Message Queue

Redis-backed persistent queues deliver messages with sub-85ms latency. Smart rate-limiting prevents Meta policy violations while maintaining maximum dispatch velocity.

10,000+ msg/sec peak bursts
Automatic deduplication by idempotent key

Real-Time Signed Webhooks

Stream inbound messages, delivery receipts, and button clicks straight to your backend HTTP endpoints with HMAC-SHA256 signature verification.

Sub-120ms webhook dispatch
Automatic 24h exponential backoff retries

Parametric Meta HSM Templates

Dynamic placeholder hydration for utility notifications, authentication OTPs, and promotional campaigns with automated multi-language fallback.

Dynamic URL CTA buttons
Media header hydration (PDF, JPG, MP4)

24h Session Window Tracking

Built-in conversation timers track the Meta 24-hour customer service window so your backend always knows whether to send free-form session messages or HSM templates.

Automatic session expiration warnings
Two-way human agent handoff logic

Media & Invoice Pipelines

Directly stream generated PDF tax invoices, order packing slips, voice recordings, and product catalogs with high-speed CDN caching.

Up to 100MB document support
Automatic format transcode & compression

Bank-Grade Enterprise Security

End-to-end 256-bit AES encryption in transit and at rest. Granular scoped API tokens, static IP whitelisting, and full compliance with GDPR and SOC-2.

Scoped Bearer API tokens
Static egress IP whitelisting
REAL-TIME EVENT STREAM

Interactive Webhook Inspector

Inspect real-time JSON payloads for every event lifecycle, and verify HMAC-SHA256 signatures with copy-paste code.

SUBSCRIBED EVENT TYPES
messages.receivedTriggered instantly when a customer sends an inbound text, audio message, image, or document to your number.
{ "event": "messages.received", "timestamp": 1730811900, "data": { "message_id": "wamid.HBgMOTE5ODc2NTQzMjEwFQIAERgSMzEyNzE4MjM4OTAw", "from": "+919876543210", "sender_name": "Aarav Sharma", "type": "text", "text": { "body": "Hi, I want to track my order #ORD-94821 and verify the delivery slot." }, "context": { "is_forwarded": false, "frequently_forwarded": false } } }
Automatic Exponential Backoff Retry Policy:
0s (Immediate)➔1m➔5m➔15m➔1h➔24h DLQ
HMAC SHA-256 Signature Header: Every webhook request contains an X-WhatsX-Signature-256 header. Verify it with your Webhook Secret using crypto.createHmac('sha256', secret).
LIBRARIES & PACKAGES

Developer SDKs & Tooling

Install lightweight, typed SDKs for your programming language or test directly via Postman.

Official SDKv2.4.0

Node.js & TypeScript

npm install @whatsx/sdk
Official SDKv2.1.2

Python

pip install whatsx-sdk
Communityv1.8.0

PHP / Laravel

composer require whatsx/whatsapp-sdk
Official SDKv1.2.0

Go Lang

go get github.com/whatsx/whatsx-go
1-Click RunnerUpdated Weekly

Postman Collection

Import WhatsX_v1.postman_collection.json
Dev ToolLocal Tunnel

Docker Webhook Relay

docker pull whatsx/webhook-relay:latest
GET STARTED IN MINUTES

From Zero to Production in 4 Steps

No endless paperwork or complex Meta Cloud onboarding. Test right away in our developer sandbox.

01

Generate API Key

Sign up in 30 seconds and grab your secret s7_live_... API token from the WhatsX dashboard.

02

Set Webhook URL

Paste your HTTPS endpoint to receive instant callbacks for message deliveries, reads, and customer replies.

03

Test in Sandbox

Fire test messages to your own WhatsApp number using our interactive playground or Postman collection.

04

Go Live on WABA

Attach your verified business phone number and scale campaigns to millions of users with zero friction.

RELIABILITY SPECIFICATIONS

Rate Limits & SLA Tiers

Transparent throughput limits designed to scale smoothly from early development to enterprise traffic.

CapabilityDeveloper SandboxScale TierEnterprise High-Volume
Max Dispatch Throughput10 msg/sec80 msg/sec1,000+ msg/sec (Dedicated)
P99 API Response Latency<100ms<85ms<50ms (Direct VPC Route)
Webhook Backoff Retries3 Retries (1h)8 Retries (12h)24h Queue Retries + Dead Letter
Guaranteed Uptime SLA99.9%99.95%99.99% Financial SLA
Static IP WhitelistingShared IPsStandard EgressDedicated Static IPs
Support & Solutions ArchitectCommunity DiscordPriority EmailDedicated Slack Channel & 15m SLA
DEVELOPER FAQS

Frequently Asked Technical Questions

Detailed answers on webhook security, rate limits, sandbox testing, and architecture.

WhatsX is built on official Meta Cloud API infrastructure with our proprietary global routing layer and Redis edge queues. P99 message ingestion latency is sub-85ms, with direct webhook callbacks firing in under 120ms.

FREE INSTANT DEVELOPER SANDBOX

Start Building WhatsApp Flows Today

Generate your API key in under 60 seconds. 1,000 free test messages included, zero credit card required.

1,000 Free Test Messages• Official Meta Cloud API• No Credit Card Required