Send WhatsApp messages from your system. Follow the conversation after delivery.
Connect your website, order system, or CRM to your authorized WhatsApp Business number. Send approved templates or service-window messages, see status in MatnBot conversations, and receive signed webhook events.
curl -X POST https://api.matnbot.com/api/v1/integrations/messages \
-H "Authorization: Bearer <MATNBOT_API_KEY>" \
-H "Idempotency-Key: order-1042-notification" \
-H "Content-Type: application/json" \
-d '{
"channel_id": "<channel-id>",
"recipient": { "type": "phone", "value": "+962790000000" },
"message": {
"type": "template",
"template_id": "<approved-template-id>",
"language": "en",
"parameters": { "order_number": "1042" }
},
"opt_in": {
"confirmed": true,
"source": "checkout",
"captured_at": "2026-09-26T09:00:00Z"
},
"client_reference": "order-1042"
}'Illustrative example: keep your key on your server and use an approved template with its actual parameter schema. HTTP 202 means accepted for processing, not delivered.
One path from request to conversation
Create an API client
Create a client and key in the dashboard. Select scopes and channels, and allowlist your server's exact public outbound IPs.
Send within WhatsApp policy
Use an approved template to start contact or outside the 24-hour customer service window. Send supported text and media within the window.
Observe and respond
The request appears in the conversation with API attribution and status. Poll the status or receive message, ticket, and lead events.
What can you build?
Order notifications
Send updates about an order or booking with an approved WhatsApp template and a searchable client reference.
Human or AI follow-up
Choose the conversation mode. Workspace and bot policy and human ownership continue to govern the effective behavior.
CRM handoff
Receive signed events when a message arrives, a ticket changes, or an idle rule produces an eligible lead snapshot.
Media when needed
Upload a file, wait until it is ready, then send an image or document within channel capabilities and plan limits.
Control from the first request
Keys require exact public caller IPs and explicit scopes and channel grants. Disable or rotate access from your account. Webhook destinations are configured in the dashboard and every delivery attempt is signed. Keep secrets out of browser code.
WhatsApp first
The initial release serves connected WhatsApp Cloud API channels. Instagram and Messenger are planned for later; the API lists each channel's currently enabled capabilities.
Need to connect your number first?
Learn how to connect WhatsApp Business and how MatnBot handles the conversation.