API каналы WazzaBee: получение списка подключённых линий

GET /v1/channels

Получение списка подключённых линий связи (каналов), доступных для текущей интеграции.

URL

GET https://api.wazzabee.com/api-gateway/v1/channels

Заголовки

Authorization: Bearer ВАШ_API_КЛЮЧ

Параметры запроса

Нет. Эндпоинт не принимает параметров — возвращает все каналы, доступные для текущего API-ключа.

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

curl -X GET "https://api.wazzabee.com/api-gateway/v1/channels" \
  -H "Authorization: Bearer ВАШ_API_КЛЮЧ"

Успешный ответ (200 OK)

{
  "success": true,
  "channels": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "name": "WhatsApp Основной",
      "type": "whatsapp_qr",
      "status": "active"
    },
    {
      "id": "6ba7b810-9dad-11d1-80b4-00c04fd430c8",
      "name": "WhatsApp WABA",
      "type": "whatsapp_waba",
      "status": "active"
    },
    {
      "id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
      "name": "Telegram Бот",
      "type": "telegram_bot",
      "status": "active"
    }
  ]
}

Описание полей ответа

Поле	Тип	Описание
`channels`	array	Массив доступных каналов
`channels[].id`	string (UUID)	Уникальный ID канала. Используйте его в других запросах (`channelId`)
`channels[].name`	string	Название канала, заданное пользователем
`channels[].type`	string	Тип канала (см. таблицу ниже)
`channels[].status`	string	Статус: `active`, `inactive`, `error`

Типы каналов

Тип (`type`)	Описание
`whatsapp_qr`	WhatsApp через QR-код (личный номер)
`whatsapp_waba`	WhatsApp Business API (официальный)
`telegram_bot`	Telegram через бота
`telegram_personal`	Telegram через личный аккаунт

Фильтрация каналов по интеграции

В настройках интеграции можно указать, какие каналы доступны через конкретный API-ключ:

Каналы не указаны — API-ключ видит все каналы аккаунта
Каналы указаны — API-ключ видит только перечисленные каналы

Это удобно, если у вас несколько интеграций с разными правами доступа.

💡 Совет: Вызывайте этот эндпоинт первым делом, чтобы получить id каналов для использования в остальных запросах.

Возможные ошибки

Этот эндпоинт может вернуть только ошибки авторизации (401, 403). Если каналов нет — возвращается пустой массив, а не ошибка.