Skip to main content

​
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

​
Media Support

TypeMax SizeFormats
Image5 MBJPEG, PNG
Video16 MBMP4, 3GPP
Document100 MBPDF, DOC, XLSX, etc.
Audio16 MBAAC, 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).