IBA Platform logo

Какие каналы доступны в Multi API

13 каналов Multi API — SMS, RCS, Viber, WhatsApp, VK/OK, WeChat, Email, Telegram, Push (Mobile Push), TTS, FlashCall

Коротко: Multi API поддерживает 13 каналов. Номера каналов используются в параметре channel запроса.

Кому подходит

  • Роль: Клиент, Разработчик
  • Уровень: Новичок

Что это

Каждый канал в Multi API имеет свой номер. Номер указывается в параметре channel запроса к API — по нему платформа понимает, через какой канал отправлять сообщение.

В Multi API доступно 13 каналов — все, кроме Voice. Voice используется только в сервисе «Мой диалог».

Перед началом

  • У вас есть API-ключ.
  • У вас есть имя отправителя для нужного канала — со статусом Активно.
  • Вы определили, через какой канал будете отправлять.

Каналы для API-ключа определяются выбранными именами отправителей. Чтобы ключ мог отправлять по SMS — выберите имя для SMS. Чтобы по SMS и WhatsApp — выберите два имени.

Как зарегистрировать имя отправителя →

Список каналов

НомерКаналЧто этоЧто можно отправлять
1SMSКлассические текстовые сообщенияТекст
2RCSСовременный канал с медиа и кнопкамиТекст, ричкарта, карусель, файл
3ViberПопулярный мессенджерТекст, файл, кнопки
4WhatsAppСамый популярный мессенджерТекст, медиа, шаблоны, локации
5VK/OKМессенджер VK и OKУточняется в поддержке
6WeChatМессенджер для АзииТекст, файлы
7EmailЭлектронная почтаHTML, текст, изображения
8Telegram GatewayTelegram для кодов верификацииКоды
9Telegram botTelegram-бот для сообщенийТекст, медиа, документы
10, 13Push (Mobile Push)Единый канал с двумя способами подключенияЗаголовок, текст, изображение
11TTSТекст в речь, голосовое информированиеOTP/2FA, уведомления, напоминания, IVR, массовые рассылки
14FlashCallКод подтверждения в номере звонящегоOTP-коды

Push (Mobile Push) — единый канал с двумя способами подключения. Номер 10 — Push, номер 13 — Mobile Push. В документации используем название «Push (Mobile Push)».

Voice не входит в список каналов Multi API. Голосовые вызовы доступны только в сервисе «Мой диалог». Для отправки кодов голосом используйте TTS, для короткого звонка — FlashCall.

Канал 5 (VK/OK) — отправка через API поддерживается, но информацию по настройке и форматам нужно запросить в поддержке сервиса.

Как указать канал в запросе

Номер канала указывается в параметре channel:

{
  "contact": "79123456789",
  "channel": 1,
  "senderId": "ВАШ_ОТПРАВИТЕЛЬ",
  "payload": {
    "text": "Привет! Это тестовое сообщение."
  }
}
  • channel: 1 — SMS
  • channel: 4 — WhatsApp
  • channel: 11 — TTS
  • channel: 14 — FlashCall

Форматы payload для каждого канала описаны в статье Форматы payload по каналам →.

Общий список доступных каналов для вашей компании — через GET /channels. Подробнее: Справочные эндпоинты →.

Результат

Вы знаете номера каналов Multi API и умеете указывать канал в запросе.

Частые проблемы

Причина: указан неверный номер канала.

Решение: проверьте номер в таблице. Например, для SMS — 1, для WhatsApp — 4.

Форматы payload по каналам →

Причина: канал не подключён к вашей компании или к API-ключу не привязано имя отправителя этого канала.

Решение:

  1. Проверьте список каналов через GET /channels.
  2. Откройте ключ в разделе API Подключения и добавьте имя отправителя нужного канала.

Справочные эндпоинты →

Причина: для задачи подходит несколько каналов.

Решение: используйте статью Как выбрать канал для задачи → или настройте каскад для автоматического переключения.

Настройка каскада →

См. также

Как выбрать канал

Алгоритм выбора канала по задаче

Настройка каскада

Автоматическое переключение между каналами

Форматы payload

JSON-примеры для каждого канала

Обзор всех каналов платформы

14 каналов и доступность по сервисам

Сравнение каналов

Что выбрать для задачи

Справочные эндпоинты

Список каналов компании через GET /channels

Нужна помощь?