REST API & Webhooks v1.0•Real-time Webhook Push

Connect Your Software Stack to WhatsApp API

Trigger custom templates via REST endpoints, receive live delivery receipts (message.read), and process incoming customer text/media webhooks securely with HMAC-SHA256 authentication.

HMAC-SHA256 Signed OpenAPI 3.0 Spec Managed Send Queue
curl -X POST https://api.vextro.net/public/v1/api/messages/send-template \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: order-1042-shipped" \
  -d '{
    "whatsappId": "YOUR_WHATSAPP_ID",
    "to": "919876543210",
    "template": { "name": "order_update", "language": "en" },
    "params": { "body": ["Alex Rivera", "Yes, please confirm my subscription"] }
  }'
API Status: 202 AcceptedEndpoint: /public/v1/api/messages/send-template
REST
Template Send Endpoint
OpenAPI
3.0 Specification
Queued
Sends Paced to Meta Limits
HMAC-256
Payload Security
Live Webhook Payload Simulator

Test Real-Time Webhook Payloads

Select a webhook event type, customize user inputs, and see the exact JSON payload sent to your server endpoint.

Select Webhook Event
⚡ Delivered via HTTP POST with `X-Vextro-Signature` header.
POST https://your-server.com/api/webhooks/vextro
200 OK
{
  "event": "message.received",
  "timestamp": 1790960087,
  "signature": "sha256=a8f9c10b92e817...",
  "data": {
    "message_id": "wmid.HBgLOTE5ODc2NTQzMjEw",
    "from": "919876543210",
    "type": "text",
    "body": "Yes, please confirm my subscription",
    "profile": {
      "name": "Alex Rivera"
    }
  }
}
Header: X-Vextro-Signature: sha256=a8f9...Retry Policy: 6 Scheduled Retries
Infrastructure Specs

Developer-Grade Messaging Platform

Built around signed payloads, scheduled retries, and scoped API keys.

HMAC SHA-256 Payload Signatures

Verify payload authenticity before executing business logic. Every webhook POST carries a cryptographic HMAC signature generated using your secret key.

Security ProtocolHMAC SHA-256
Exponential Backoff Retries

Scheduled Webhook Retry Engine

If your endpoint returns an HTTP 500 error or experiences network drops, Vextro automatically retries delivery up to 6 times, from 5 minutes to 48 hours apart, and logs deliveries that still fail as dead.

6 Retries
Backoff Schedule
DLQ Log
Dead-Letter Queue
3+ Days
Retry Window

Managed Send Queue

Send high-volume transactional messages through a managed queue that paces delivery to Meta Cloud API rate limits.

IP Whitelisting & Static IPs

Secure your firewall by configuring strict IP whitelisting using Vextro's static outbound proxy IP ranges.

Fine-Grained API Key Roles

Create restricted API tokens scoped specifically for sending messages, reading webhook logs, or managing templates.

How Vextro REST API & Webhooks Flow

Queued message dispatch and real-time event callbacks.

01
HTTPS POST

REST API Post Request

Your app calls POST /public/v1/api/messages/send-template with the template, its variables and the recipient's phone.

02
Meta Cloud API

Meta Pipeline Queue

Vextro authenticates API Token & dispatches to Meta Cloud API nodes.

03
End User Phone

WhatsApp Delivery

Recipient receives WhatsApp notification with interactive template buttons.

04
HMAC Webhook Callback

Webhook Callback Pushed

Vextro POSTs message.read status or user reply to your server with HMAC signature.

Legacy Polling / SMS Gateways vs. Vextro Webhooks API

Compare why developers build on Vextro REST API and real-time webhook callbacks.

Feature / SpecLegacy SMS / Polling APIVextro REST & Webhook API
How Status Reaches YouYour app has to poll for status changesPushed to your endpoint as events happen
Payload Security Unsigned plain text HTTP HMAC-SHA256 Signed Header
Status TrackingOnly basic Sent/Failed state Sent, Delivered, Read, & User Reply Webhooks
Failed Retry Policy Silent failure drop 6 Scheduled Retries + Dead-Letter Log
Developer ExperienceOutdated SOAP/XML endpoints OpenAPI 3.0 & Official SDKs (Node, Python, Go)

Start Building in 3 Simple Steps

Generate your API token, then point Vextro at your webhook URL.

1

Generate API Keys

Create a Bearer API Token & Webhook Signing Secret in the Vextro Developer Console.

2

Configure Webhook URL

Enter your HTTPS endpoint URL and subscribe to message.received and message.read events.

3

Verify & Launch

Validate HMAC signatures on your server and start processing live WhatsApp messages.

Frequently Asked Questions

Everything you need to know about Vextro and billing.

Ready to Build Your WhatsApp Messaging Integration?

Get your developer credentials, API tokens, and OpenAPI docs to launch in minutes.