Developers

Sends a free-form message to a WhatsApp user. Free-form messages are deliverable only inside the 24-hour customer-service window opened by the user's last inbound message; outside the window use a template.

type selects the payload kind. For text the text field is required. For media types (image, video, audio, document, sticker) the media.url field is required; text becomes the caption where WhatsApp supports it (image, video, document).

Supported media formats and size limits:

The media.url must be a public HTTPS URL.

Request body

Example request

curl -X POST 'https://qnnect.kz/api/v1/{channel_uuid}/message/?token=YOUR_API_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
  "type": "text",
  "phone": "77778866697",
  "text": "Hello! Your order is ready."
}'

Responses

• 202 — Message accepted and queued for delivery.
• 400 — Invalid input. error holds a machine-readable code.
• 401 — Token is missing (missing_token) or wrong (invalid_token).
• 403 — Sending is suspended — the company is blocked or out of funds (company_inactive).
• 404 — No channel with this channel_uuid (channel_not_found).

Sends an approved WhatsApp template. Templates work outside the 24-hour window and are the way to start a conversation.

values fills the numbered body placeholders {{1}}, {{2}}, … in order; the count must match the template exactly (see GET /api/v1/{channel_uuid}/templates/ → variables.body). header_values and button_values fill header/button placeholders when the template has them.

Media templates (IMAGE/VIDEO/DOCUMENT header): pass a public media_url (with optional media_mime_type) or a pre-registered media_id. Carousel templates: cards replaces card images by index; null keeps the sample image from the template.

Request body

Example request

curl -X POST 'https://qnnect.kz/api/v1/{channel_uuid}/template/?token=YOUR_API_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
  "phone": "77778866697",
  "template_name": "order_confirm",
  "values": [
    "Ivan",
    "12345"
  ]
}'

Responses

• 202 — Template accepted and queued for delivery.
• 400 — Invalid input. error holds a machine-readable code.
• 401 — Token is missing (missing_token) or wrong (invalid_token).
• 403 — Sending is suspended — the company is blocked or out of funds (company_inactive).
• 404 — Channel or template not found.

Returns the channel's template catalog with statuses and variable counts. Use it to discover what can be sent and how many values each template expects before calling the send endpoint.

All statuses are returned by default, including PENDING and REJECTED — only APPROVED templates can actually be sent.

Query parameters

• status — Filter by exact status (e.g. APPROVED, PENDING, REJECTED).
• category — Filter by category.
• type — Filter by template type (TEXT, IMAGE, VIDEO, DOCUMENT, CAROUSEL, …).

Example request

curl 'https://qnnect.kz/api/v1/{channel_uuid}/templates/?token=YOUR_API_TOKEN'

Responses

• 200 — Template catalog of the channel.
• 401 — Token is missing (missing_token) or wrong (invalid_token).
• 404 — No channel with this channel_uuid (channel_not_found).

Sent to your configured webhook URL when a WhatsApp user writes to the channel. Webhook URLs are configured in the cabinet (Integrations → Webhooks) and can be enabled per event type.

Delivery: POST with JSON body, Content-Type: application/json; charset=utf-8. Respond with any 2xx within 12 seconds; failed deliveries are retried in the background.

Payload

Sent when a message leaves the channel — from the QNNECT UI, the API or an integration. Same delivery contract as incoming_message.

Payload

Sent when WhatsApp reports a status change for a previously sent message (sent → delivered → read, or failed). Correlate by message_uuid. Same delivery contract as incoming_message.

Payload