POST /v1/messages/send
Отправка текстового или медиа-сообщения через подключённый канал.
URL
POST /functions/v1/api-gateway/v1/messages/send
Заголовки
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
Тело запроса
{
"channelId": "uuid-канала",
"chatId": "79991234567",
"text": "Привет! Это тестовое сообщение."
}
Параметры
| Параметр | Тип | Обязательный | Описание |
|---|
channelId | string (UUID) | ✅ | ID канала для отправки |
chatId | string | ✅ | Номер телефона (WhatsApp) или chat_id (Telegram) |
text | string | ⚠️ | Текст сообщения (обязателен если нет mediaUrl) |
mediaUrl | string | ⚠️ | URL медиафайла (обязателен если нет text) |
mediaType | string | ❌ | Тип медиа: photo, video, document, audio |
caption | string | ❌ | Подпись к медиафайлу |
Ответ (202 Accepted)
{
"success": true,
"queued": true,
"queueId": "uuid-очереди",
"message": "Сообщение поставлено в очередь на отправку"
}
Поддерживаемые каналы
- WhatsApp QR — chatId = номер телефона (79991234567)
- WhatsApp WABA — chatId = номер телефона
- Telegram Bot — chatId = числовой chat_id
- Telegram Personal — chatId = числовой chat_id или username
Ошибки
| Код | Описание |
|---|
400 | Отсутствуют обязательные поля или канал неактивен |
403 | Канал не привязан к интеграции |
404 | Канал не найден |
