Send Message

The Connexease Gateway exposes a single endpoint for all outbound WhatsApp messages. You send one HTTP request — the Gateway authenticates you, checks your rate limits and balance, and forwards the payload to Meta on your behalf. The response contains a wamid that you can use to track delivery status via webhooks. This page covers text, media, and interactive messages, plus a basic template example. The full template reference lives under Templates.

Sending a template?

Templates are required to start a conversation or to reach a customer outside the 24-hour window. See the Templates section for the component reference and an example for every template type.

Endpoint

POST https://api.gateway.connexease.com/v1/wa/message

string

required

API key in Bearer sk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx format. See Authentication.

string

required

Always application/json.

Query Parameters

boolean

default:"false"

When true, routes the request through the Meta Marketing Messages Lite endpoint. Applies to marketing templates — see Marketing Messages Lite.

boolean

default:"false"

Sandbox mode. When true, auth, rate limiting, and billing checks run normally; the Meta API call is skipped and a fake wamid is returned. Ideal for development and load testing.

Request Body

string

required

Always "whatsapp".

string

required

Recipient phone number including country code, without +, spaces, or dashes. E.g. 905321234567, 14155552671.

string

required

Message type. Values: text, image, audio, document, interactive, template. For template, see Templates.

Message Types

Text Message

string

required

Message text. Maximum 4096 characters.

boolean

default:"false"

Show a link preview if the message contains a URL.

curl -X POST https://api.gateway.connexease.com/v1/wa/message \
  -H "Authorization: Bearer sk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "messaging_product": "whatsapp",
    "to": "905321234567",
    "type": "text",
    "text": {
      "body": "Hello! Your order has been confirmed.",
      "preview_url": false
    }
  }'

import requests

requests.post(
    "https://api.gateway.connexease.com/v1/wa/message",
    headers={"Authorization": "Bearer sk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx", "Content-Type": "application/json"},
    json={
        "messaging_product": "whatsapp",
        "to": "905321234567",
        "type": "text",
        "text": {"body": "Hello! Your order has been confirmed.", "preview_url": False}
    }
)

await fetch('https://api.gateway.connexease.com/v1/wa/message', {
  method: 'POST',
  headers: { 'Authorization': 'Bearer sk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx', 'Content-Type': 'application/json' },
  body: JSON.stringify({
    messaging_product: 'whatsapp',
    to: '905321234567',
    type: 'text',
    text: { body: 'Hello! Your order has been confirmed.', preview_url: false }
  }),
});

payload := map[string]any{
    "messaging_product": "whatsapp",
    "to":   "905321234567",
    "type": "text",
    "text": map[string]any{"body": "Hello! Your order has been confirmed.", "preview_url": false},
}
body, _ := json.Marshal(payload)
req, _ := http.NewRequest("POST", "https://api.gateway.connexease.com/v1/wa/message", bytes.NewReader(body))
req.Header.Set("Authorization", "Bearer sk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx")
req.Header.Set("Content-Type", "application/json")
http.DefaultClient.Do(req)

Image Message

string

required

Publicly accessible image URL. Maximum 5 MB. Supported formats: JPG, PNG.

string

Caption text displayed below the image.

curl -X POST https://api.gateway.connexease.com/v1/wa/message \
  -H "Authorization: Bearer sk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "messaging_product": "whatsapp",
    "to": "905321234567",
    "type": "image",
    "image": {
      "link": "https://example.com/images/order-summary.jpg",
      "caption": "Your order summary"
    }
  }'

requests.post(
    "https://api.gateway.connexease.com/v1/wa/message",
    headers={"Authorization": "Bearer sk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx", "Content-Type": "application/json"},
    json={
        "messaging_product": "whatsapp",
        "to": "905321234567",
        "type": "image",
        "image": {"link": "https://example.com/images/order-summary.jpg", "caption": "Your order summary"}
    }
)

await fetch('https://api.gateway.connexease.com/v1/wa/message', {
  method: 'POST',
  headers: { 'Authorization': 'Bearer sk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx', 'Content-Type': 'application/json' },
  body: JSON.stringify({
    messaging_product: 'whatsapp',
    to: '905321234567',
    type: 'image',
    image: { link: 'https://example.com/images/order-summary.jpg', caption: 'Your order summary' }
  }),
});

Audio Message

string

required

Publicly accessible audio file URL. Maximum 16 MB. Supported formats: MP3, AAC, AMR, OGG (Opus codec).

curl -X POST https://api.gateway.connexease.com/v1/wa/message \
  -H "Authorization: Bearer sk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "messaging_product": "whatsapp",
    "to": "905321234567",
    "type": "audio",
    "audio": {
      "link": "https://example.com/audio/welcome.mp3"
    }
  }'

requests.post(
    "https://api.gateway.connexease.com/v1/wa/message",
    headers={"Authorization": "Bearer sk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx", "Content-Type": "application/json"},
    json={
        "messaging_product": "whatsapp",
        "to": "905321234567",
        "type": "audio",
        "audio": {"link": "https://example.com/audio/welcome.mp3"}
    }
)

await fetch('https://api.gateway.connexease.com/v1/wa/message', {
  method: 'POST',
  headers: { 'Authorization': 'Bearer sk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx', 'Content-Type': 'application/json' },
  body: JSON.stringify({
    messaging_product: 'whatsapp',
    to: '905321234567',
    type: 'audio',
    audio: { link: 'https://example.com/audio/welcome.mp3' }
  }),
});

Document Message

string

required

Publicly accessible file URL. Maximum 100 MB.

string

Caption text displayed above the document.

string

File name shown to the recipient (e.g. invoice_march_2025.pdf).

curl -X POST https://api.gateway.connexease.com/v1/wa/message \
  -H "Authorization: Bearer sk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "messaging_product": "whatsapp",
    "to": "905321234567",
    "type": "document",
    "document": {
      "link": "https://example.com/docs/invoice.pdf",
      "caption": "Your March 2025 Invoice",
      "filename": "invoice_march_2025.pdf"
    }
  }'

requests.post(
    "https://api.gateway.connexease.com/v1/wa/message",
    headers={"Authorization": "Bearer sk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx", "Content-Type": "application/json"},
    json={
        "messaging_product": "whatsapp",
        "to": "905321234567",
        "type": "document",
        "document": {
            "link": "https://example.com/docs/invoice.pdf",
            "caption": "Your March 2025 Invoice",
            "filename": "invoice_march_2025.pdf"
        }
    }
)

await fetch('https://api.gateway.connexease.com/v1/wa/message', {
  method: 'POST',
  headers: { 'Authorization': 'Bearer sk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx', 'Content-Type': 'application/json' },
  body: JSON.stringify({
    messaging_product: 'whatsapp',
    to: '905321234567',
    type: 'document',
    document: {
      link: 'https://example.com/docs/invoice.pdf',
      caption: 'Your March 2025 Invoice',
      filename: 'invoice_march_2025.pdf'
    }
  }),
});

Interactive Button — Quick Reply Buttons

Presents up to 3 tappable buttons. When a user taps a button, an interactive.button_reply webhook event is sent to your endpoint.

string

required

For buttons: "button"

string

required

Message body text.

array

required

Maximum 3 buttons. Each button: type: "reply", reply.id (unique ID, max 256 chars), reply.title (max 20 chars).

curl -X POST https://api.gateway.connexease.com/v1/wa/message \
  -H "Authorization: Bearer sk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "messaging_product": "whatsapp",
    "to": "905321234567",
    "type": "interactive",
    "interactive": {
      "type": "button",
      "body": {
        "text": "Your order is out for delivery. Choose your delivery preference:"
      },
      "action": {
        "buttons": [
          { "type": "reply", "reply": { "id": "home_delivery",    "title": "Home Delivery" } },
          { "type": "reply", "reply": { "id": "cash_on_delivery", "title": "Cash on Delivery" } },
          { "type": "reply", "reply": { "id": "pickup",           "title": "Pick Up In Store" } }
        ]
      }
    }
  }'

requests.post(
    "https://api.gateway.connexease.com/v1/wa/message",
    headers={"Authorization": "Bearer sk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx", "Content-Type": "application/json"},
    json={
        "messaging_product": "whatsapp",
        "to": "905321234567",
        "type": "interactive",
        "interactive": {
            "type": "button",
            "body": {"text": "Your order is out for delivery. Choose your delivery preference:"},
            "action": {
                "buttons": [
                    {"type": "reply", "reply": {"id": "home_delivery",    "title": "Home Delivery"}},
                    {"type": "reply", "reply": {"id": "cash_on_delivery", "title": "Cash on Delivery"}},
                    {"type": "reply", "reply": {"id": "pickup",           "title": "Pick Up In Store"}}
                ]
            }
        }
    }
)

await fetch('https://api.gateway.connexease.com/v1/wa/message', {
  method: 'POST',
  headers: { 'Authorization': 'Bearer sk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx', 'Content-Type': 'application/json' },
  body: JSON.stringify({
    messaging_product: 'whatsapp',
    to: '905321234567',
    type: 'interactive',
    interactive: {
      type: 'button',
      body: { text: 'Your order is out for delivery. Choose your delivery preference:' },
      action: {
        buttons: [
          { type: 'reply', reply: { id: 'home_delivery',    title: 'Home Delivery' } },
          { type: 'reply', reply: { id: 'cash_on_delivery', title: 'Cash on Delivery' } },
          { type: 'reply', reply: { id: 'pickup',           title: 'Pick Up In Store' } }
        ]
      }
    }
  }),
});

Interactive List — Selection List

Displays a scrollable, sectioned list of options. When a user selects an option, an interactive.list_reply webhook event is sent.

string

required

For lists: "list"

string

required

Description text shown above the list.

string

required

Label for the button that opens the list. Maximum 20 characters.

array

required

Array of sections. Each section has a title and rows (options). Row id max 200 chars, title max 24 chars.

curl -X POST https://api.gateway.connexease.com/v1/wa/message \
  -H "Authorization: Bearer sk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "messaging_product": "whatsapp",
    "to": "905321234567",
    "type": "interactive",
    "interactive": {
      "type": "list",
      "body": { "text": "How can we help you today?" },
      "action": {
        "button": "View Options",
        "sections": [
          {
            "title": "Order Management",
            "rows": [
              { "id": "track_order",  "title": "Track Order",  "description": "Find out where your order is" },
              { "id": "cancel_order", "title": "Cancel Order", "description": "Cancel my order" }
            ]
          },
          {
            "title": "Support",
            "rows": [
              { "id": "live_support", "title": "Live Support", "description": "Connect with an agent" }
            ]
          }
        ]
      }
    }
  }'

requests.post(
    "https://api.gateway.connexease.com/v1/wa/message",
    headers={"Authorization": "Bearer sk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx", "Content-Type": "application/json"},
    json={
        "messaging_product": "whatsapp",
        "to": "905321234567",
        "type": "interactive",
        "interactive": {
            "type": "list",
            "body": {"text": "How can we help you today?"},
            "action": {
                "button": "View Options",
                "sections": [
                    {
                        "title": "Order Management",
                        "rows": [
                            {"id": "track_order",  "title": "Track Order",  "description": "Find out where your order is"},
                            {"id": "cancel_order", "title": "Cancel Order", "description": "Cancel my order"}
                        ]
                    },
                    {
                        "title": "Support",
                        "rows": [{"id": "live_support", "title": "Live Support", "description": "Connect with an agent"}]
                    }
                ]
            }
        }
    }
)

await fetch('https://api.gateway.connexease.com/v1/wa/message', {
  method: 'POST',
  headers: { 'Authorization': 'Bearer sk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx', 'Content-Type': 'application/json' },
  body: JSON.stringify({
    messaging_product: 'whatsapp',
    to: '905321234567',
    type: 'interactive',
    interactive: {
      type: 'list',
      body: { text: 'How can we help you today?' },
      action: {
        button: 'View Options',
        sections: [
          {
            title: 'Order Management',
            rows: [
              { id: 'track_order',  title: 'Track Order',  description: 'Find out where your order is' },
              { id: 'cancel_order', title: 'Cancel Order', description: 'Cancel my order' }
            ]
          },
          {
            title: 'Support',
            rows: [{ id: 'live_support', title: 'Live Support', description: 'Connect with an agent' }]
          }
        ]
      }
    }
  }),
});

Template Message

Templates must be approved by Meta before you send them. They are required to start a conversation or to reach a user outside the 24-hour service window.

string

required

The name of the approved template.

string

required

The language the template was approved in. E.g. en_US, tr. Must exactly match the approved template.

array

Values for the template’s variables, media, and buttons. Omit it when the template has nothing to fill in.

curl -X POST https://api.gateway.connexease.com/v1/wa/message \
  -H "Authorization: Bearer sk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "messaging_product": "whatsapp",
    "to": "905321234567",
    "type": "template",
    "template": {
      "name": "hello_world",
      "language": { "code": "en_US" }
    }
  }'

requests.post(
    "https://api.gateway.connexease.com/v1/wa/message",
    headers={"Authorization": "Bearer sk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx", "Content-Type": "application/json"},
    json={
        "messaging_product": "whatsapp",
        "to": "905321234567",
        "type": "template",
        "template": {"name": "hello_world", "language": {"code": "en_US"}}
    }
)

await fetch('https://api.gateway.connexease.com/v1/wa/message', {
  method: 'POST',
  headers: { 'Authorization': 'Bearer sk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx', 'Content-Type': 'application/json' },
  body: JSON.stringify({
    messaging_product: 'whatsapp',
    to: '905321234567',
    type: 'template',
    template: { name: 'hello_world', language: { code: 'en_US' } }
  }),
});

For templates with variables, media headers, or buttons — and examples of every template type — see Templates.

Response

Success (HTTP 200)

{
  "isSuccess": true,
  "data": {
    "messaging_product": "whatsapp",
    "contacts": [
      {
        "input": "905321234567",
        "wa_id": "905321234567"
      }
    ],
    "messages": [
      {
        "id": "wamid.HBgNOTA1Mzk5ODc2NTQzFQIAERgSM0Y3RDg5NjREOUNBMkFFNEE3AA=="
      }
    ]
  }
}

Response Fields:

boolean

true = message accepted. Does not mean the message was delivered.

string

Always "whatsapp".

string

The phone number you sent in the request.

string

The WhatsApp-normalized phone number. Usually the same as input.

string

The unique wamid for this message. Store this to correlate with incoming delivery status webhooks.

Error Response

{
  "isSuccess": false,
  "errors": {
    "code": "BILL_001",
    "group": "PAYMENT_REQUIRED",
    "description": "Insufficient balance. Please top up your account to continue sending messages."
  }
}

See Error Codes for the full list.

Key Notes

HTTP 200 ≠ Delivered. The response confirms the message was accepted, not that it reached the recipient. Listen to message_status webhook events for actual delivery confirmation.

Store data.messages[0].id in your database. You’ll need this wamid to match it against incoming message_status and read webhooks.

24-hour window: The message types on this page can only be sent within 24 hours of the last message from the user. Outside this window, send a template.

Sandbox

WhatsApp

Templates

Webhooks

Reference

Sending a template?

Endpoint

Query Parameters

Request Body

Message Types

Response

Success (HTTP 200)

Error Response

Key Notes

Sending a template?

​Endpoint

​Query Parameters

​Request Body

​Message Types

​Response

​Success (HTTP 200)

​Error Response

​Key Notes

Endpoint

Query Parameters

Request Body

Message Types

Response

Success (HTTP 200)

Error Response

Key Notes