Разработчикам

Отправляет свободное сообщение пользователю WhatsApp. Свободные сообщения доставляются только внутри 24-часового сервисного окна, открытого последним входящим сообщением пользователя; вне окна используйте шаблон.

type выбирает вид сообщения. Для text обязательно поле text. Для медиа-типов (image, video, audio, document, sticker) обязателен media.url; text становится подписью там, где WhatsApp её поддерживает (image, video, document).

Поддерживаемые форматы и лимиты размера:

media.url должен быть публичным HTTPS-URL.

Тело запроса

Пример запроса

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."
}'

Ответы

• 202 — Сообщение принято и поставлено в очередь доставки.
• 400 — Неверный ввод. В error — машиночитаемый код.
• 401 — Токен отсутствует (missing_token) или неверен (invalid_token).
• 403 — Отправка приостановлена — компания заблокирована или нет средств (company_inactive).
• 404 — Канала с таким channel_uuid нет (channel_not_found).

Отправляет одобренный WhatsApp-шаблон. Шаблоны работают вне 24-часового окна — это способ начать диалог первым.

values заполняет нумерованные плейсхолдеры тела {{1}}, {{2}}, … по порядку; количество должно точно совпадать с шаблоном (см. GET /api/v1/{channel_uuid}/templates/ → variables.body). header_values и button_values заполняют плейсхолдеры заголовка/кнопок, если они есть в шаблоне.

Медиа-шаблоны (заголовок IMAGE/VIDEO/DOCUMENT): передайте публичный media_url (опционально с media_mime_type) или заранее зарегистрированный media_id. Карусели: cards подменяет картинки карточек по индексу; null оставляет образец из шаблона.

Тело запроса

Пример запроса

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"
  ]
}'

Ответы

• 202 — Шаблон принят и поставлен в очередь доставки.
• 400 — Неверный ввод. В error — машиночитаемый код.
• 401 — Токен отсутствует (missing_token) или неверен (invalid_token).
• 403 — Отправка приостановлена — компания заблокирована или нет средств (company_inactive).
• 404 — Канал или шаблон не найден.

Возвращает каталог шаблонов канала со статусами и количеством переменных. Используйте его, чтобы узнать, что можно отправить и сколько values ждёт каждый шаблон, до вызова отправки.

По умолчанию возвращаются все статусы, включая PENDING и REJECTED — реально отправить можно только APPROVED.

Query-параметры

• status — Фильтр по точному статусу (например APPROVED, PENDING, REJECTED).
• category — Фильтр по категории.
• type — Фильтр по типу шаблона (TEXT, IMAGE, VIDEO, DOCUMENT, CAROUSEL, …).

Пример запроса

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

Ответы

• 200 — Каталог шаблонов канала.
• 401 — Токен отсутствует (missing_token) или неверен (invalid_token).
• 404 — Канала с таким channel_uuid нет (channel_not_found).

Отправляется на настроенный вами webhook-URL, когда пользователь WhatsApp пишет в канал. Webhook-URL настраиваются в кабинете (Интеграции → Webhooks) и включаются по типам событий.

Доставка: POST с JSON-телом, Content-Type: application/json; charset=utf-8. Ответьте любым 2xx за 12 секунд; неуспешные доставки ретраятся в фоне.

Payload

Отправляется, когда сообщение уходит из канала — из интерфейса QNNECT, по API или из интеграции. Контракт доставки как у incoming_message.

Payload

Отправляется, когда WhatsApp сообщает об изменении статуса ранее отправленного сообщения (sent → delivered → read или failed). Сопоставляйте по message_uuid. Контракт доставки как у incoming_message.

Payload