Documentation Index
Fetch the complete documentation index at: https://orbit-docs.devotel.io/llms.txt
Use this file to discover all available pages before exploring further.
WhatsApp
Reach 2+ billion WhatsApp users through Orbit’s WhatsApp Business API integration. Send template messages, start interactive sessions, and handle rich media — all through a single API.
Send a Template Message
WhatsApp requires pre-approved templates for business-initiated conversations.
curl -X POST https://orbit-api.devotel.io/api/v1/messages/whatsapp \
-H "X-API-Key: dv_live_sk_..." \
-H "Content-Type: application/json" \
-d '{
"to": "+14155552671",
"type": "template",
"template": {
"name": "order_confirmation",
"language": "en",
"components": [
{
"type": "body",
"parameters": [
{ "type": "text", "text": "ORD-12345" }
]
}
]
}
}'
Send a Session Message
Once a user messages you, a 24-hour session window opens for free-form replies.
curl -X POST https://orbit-api.devotel.io/api/v1/messages/whatsapp \
-H "X-API-Key: dv_live_sk_..." \
-H "Content-Type: application/json" \
-d '{
"to": "+14155552671",
"type": "text",
"body": "Thanks for reaching out! How can we help?"
}'
Features
- Template messages — pre-approved message templates for outbound notifications
- Session messaging — free-form replies within the 24-hour conversation window
- Rich media — images, videos, documents, audio, stickers, and location sharing
- Interactive messages — buttons, list pickers, and quick replies
- Read receipts — know when messages are delivered and read
- Catalog & product messages — share product listings directly in chat
| Type | Max Size | Formats |
|---|
| Image | 5 MB | JPEG, PNG |
| Video | 16 MB | MP4, 3GPP |
| Document | 100 MB | PDF, DOC, XLSX, etc. |
| Audio | 16 MB | AAC, MP3, OGG |
Template Management
Manage templates through the Orbit dashboard under Channels > WhatsApp > Templates, or via the API:
curl https://orbit-api.devotel.io/api/v1/whatsapp/templates \
-H "X-API-Key: dv_live_sk_..."
Templates go through Meta’s approval process (typically 1–24 hours).