GET/features/webhooks—200OK

WhatsApp Webhook API

// Receive instant notifications for incoming messages, delivery receipts, presence updates, and group events. Choose webhooks for push delivery or SSE for persistent streaming.

No credit card required · 14-day free trial
GET/features/webhooks/use-cases—200OK

Use Cases

use-case/customer-support-bots.ts
ready

Customer Support Bots

Instantly route incoming messages to your helpdesk or chatbot. React to customer queries in milliseconds, not minutes.

use-case/order-notifications.ts
ready

Order Notifications

Trigger real-time order updates when customers reply with confirmation codes or shipping preferences.

use-case/crm-integration.ts
ready

CRM Integration

Push every WhatsApp conversation into Salesforce, HubSpot, or your custom CRM. Keep contact history synced automatically.

use-case/analytics-pipelines.ts
ready

Analytics Pipelines

Stream message events to your data warehouse. Track delivery rates, response times, and engagement metrics in real time.

POST/features/webhooks/example—200OK

Code Examples

// Copy, paste, ship

configure-webhook.sh
curl -X PUT https://api.wsapi.chat/account/instances/{instanceId}/settings \
  -H "x-api-key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "webhookUrl": "https://your-app.com/webhooks/whatsapp",
    "eventFilters": ["message", "message_read", "user_presence"]
  }'

Key Features

Two Delivery Modes

HTTP webhooks (push) or SSE (persistent stream). The events overview compares them, and you can use both simultaneously

Event Filtering

Subscribe only to events you need, and cut noise and bandwidth. See how to filter events by type

Automatic Retries

Failed webhook deliveries retry with exponential backoff (up to 5 attempts)

Signature Verification

HMAC-SHA256 signatures on every webhook payload. The message event reference documents what you sign over

Low Latency

Events delivered within 100ms of WhatsApp server receipt

No Extra Cost

Webhooks and SSE included in every plan, no per-event fees

GET/features/webhooks/faq—200OK

Frequently Asked Questions

$ wsapi cloud --start

Get started today

// Start a 14-day free trial with no credit card required

Related reading

Explore more