Перейти к содержимому

Каналы

Семь типов каналов за одним эндпоинтом

OmniMessage — шлюз, к которому вы подключаете собственные каналы. Вы добавляете отправителей, которые у вас уже есть, и каждый из них адресуется, отслеживается и оплачивается одинаково.

Подключайте собственные каналы

Подключите один раз — в консоли или через API

Подключённый отправитель становится каналом с идентификатором. Этот идентификатор — единственное значение в запросе на отправку, которое зависит от канала.

  • Отправитель принадлежит вам

    Номер, бот или аккаунт зарегистрирован у провайдера на вас. Если вы уйдёте из OmniMessage, отправитель останется с вами.

  • Два отдельных счёта

    OmniMessage взимает плату за шлюз за каждое исходящее сообщение. Всё, что Meta, Twilio или другой провайдер взимает за канал, они выставляют вам сами.

  • Войдите или вставьте учётные данные

    WhatsApp, Messenger и Instagram авторизуются входом через Facebook в консоли, а TikTok — входом через TikTok. Для Telegram, SMS и SMS OTP нужны учётные данные — в консоли или через API; так же можно подключить номер WhatsApp, который уже работает с Cloud API.

  • Учётные данные доступны только для записи

    Токены, коды и учётные данные передаются на уровень доставки при подключении канала. Шлюз их не хранит, а API никогда их не возвращает.

POST /v1/channels
curl https://api.omnimessage.co/v1/channels \
  -H "Authorization: Bearer om_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "type": "whatsapp",
    "name": "Support line",
    "identifier": "+971800123456",
    "credentials": {
      "wab_account_id": "...",
      "phone_number_id": "...",
      "access_token": "..."
    }
  }'
201 Created
{
  "id": "ch_7Hq2mN5vB8cX1zL0pK3j",
  "object": "channel",
  "mode": "live",
  "type": "whatsapp",
  "name": "Support line",
  "identifier": "+971800123456",
  "status": "active",
  "connection_status": "pending",
  "capabilities": ["text", "attachments", "template", "button", "list", "location", "contacts", "cta_url"],
  "created_at": "2026-10-01T08:00:00.000Z"
}

Для WhatsApp, Telegram, SMS и SMS OTP. Требуется разрешение channels:write. Чтобы следить за состоянием подключения, подпишитесь на события channel.connected и channel.disconnected.

WhatsApp Business

Отправляйте сообщения с собственного номера телефона WhatsApp Business Platform (Cloud API). OmniMessage пересылает ваши сообщения в Cloud API и возвращает вам статусы «отправлено», «доставлено», «прочитано» и «ошибка».

0,001 $ за исходящее сообщение или один кредит пакета

Что нужно
Аккаунт Facebook с доступом к вашему бизнес-портфолио Meta. Нажмите в консоли «Продолжить с Facebook», и Meta Embedded Signup настроит аккаунт WhatsApp Business и номер. Номер, который уже работает с Cloud API, также можно подключить по его идентификаторам и токену доступа системного пользователя — в консоли или через API.
Учётные данные API
wab_account_idphone_number_idaccess_token
Тип канала
whatsapp
Идентификатор отправителя
Номер телефона отправителя в формате E.164, например +971800123456.
Получатель (to)
Номер телефона в формате E.164.
Полезно знать
  • За пределами 24-часового окна обслуживания клиентов WhatsApp принимает только одобренные шаблонные сообщения.
  • Список одобренных шаблонов канала можно получить запросом GET /v1/channels/:id/templates.
  • Плату за переписки Meta взимает с вашего аккаунта WhatsApp Business. Она не входит в плату за шлюз.

SMS

Отправляйте SMS с номера телефона Twilio в собственном аккаунте Twilio. Используйте его для уведомлений, напоминаний и двусторонней переписки; входящие сообщения доставляются на ваш вебхук.

0,0005 $ за исходящее сообщение или один кредит пакета

Что нужно
Аккаунт Twilio и номер телефона, для которого включён обмен сообщениями.
Учётные данные API
account_sidphone_number_sidauth_token
Тип канала
sms
Идентификатор отправителя
Номер телефона отправителя в формате E.164.
Получатель (to)
Номер телефона в формате E.164.
Типы сообщений
ТекстВложения
Полезно знать
  • Возможность отправлять медиавложения зависит от того, что поддерживают ваш номер и сеть получателя.
  • Плату операторов связи и Twilio взимает Twilio с вашего аккаунта Twilio. Она не входит в плату за шлюз.

SMS OTP

Отдельный тип канала для кодов подтверждения. Он принимает только обычный текст, поэтому сценарий входа не сможет случайно отправить через него что-то другое.

0,0005 $ за исходящее сообщение или один кредит пакета

Что нужно
Аккаунт у вашего провайдера SMS OTP и его API-ключ.
Учётные данные API
api_key
Тип канала
sms_otp
Идентификатор отправителя
Имя отправителя или номер, зарегистрированные у вашего провайдера.
Получатель (to)
Номер телефона в формате E.164.
Типы сообщений
Текст
Полезно знать
  • Только текст. Вложения и интерактивные типы отклоняются с кодом unsupported_message_type.
  • Плату провайдера взимает ваш провайдер. Она не входит в плату за шлюз.

Telegram

Отправляйте сообщения через созданного вами бота Telegram. Токен бота — единственные учётные данные, а сообщения от людей, которые пишут боту, приходят как события message.received.

0,0003 $ за исходящее сообщение или один кредит пакета

Что нужно
Бот Telegram и его токен от @BotFather. Имя пользователя бота считывается из Telegram при подключении.
Учётные данные API
access_token
Тип канала
telegram
Идентификатор отправителя
Имя пользователя бота, полученное из Telegram по токену.
Получатель (to)
Идентификатор чата Telegram.
Полезно знать
  • Бот может писать только человеку, который сам начал с ним разговор.
  • Идентификатор чата каждого человека содержится в событиях message.received, которые он вызывает.

Messenger

Отвечайте людям, которые обращаются на вашу Страницу Facebook, текстом, медиа и кнопками ответа. Входящие сообщения приходят на ваш вебхук вместе с идентификатором отправителя, который нужен для ответа.

0,0005 $ за исходящее сообщение или один кредит пакета

Что нужно
Страница Facebook и аккаунт Facebook с полным контролем над ней.
Как подключить
В консоли нажмите «Продолжить с Facebook» и выберите Страницу, с которой будут отправляться сообщения.Для этого типа канала нет учётных данных, которые нужно копировать, и его нельзя создать с помощью API-ключа.
Тип канала
messenger
Идентификатор отправителя
Страница, с которой канал отправляет сообщения.
Получатель (to)
Идентификатор пользователя в пределах Страницы.
Полезно знать
  • Идентификаторы в пределах Страницы выдаются отдельно для каждой Страницы. Вы получаете их в событиях message.received.
  • То, что и когда можно отправлять, определяют правила обмена сообщениями Meta.

Instagram

Отвечайте на личные сообщения, отправленные на ваш профессиональный аккаунт Instagram, текстом, медиа и кнопками ответа — через тот же эндпоинт, что и для остальных каналов.

0,0005 $ за исходящее сообщение или один кредит пакета

Что нужно
Профессиональный аккаунт Instagram, связанный со Страницей Facebook, которой вы управляете.
Как подключить
В консоли нажмите «Продолжить с Facebook» и выберите Страницу, с которой связан ваш аккаунт Instagram. Страницы без связанного профессионального аккаунта подключить нельзя.Для этого типа канала нет учётных данных, которые нужно копировать, и его нельзя создать с помощью API-ключа.
Тип канала
instagram
Идентификатор отправителя
Аккаунт Instagram, с которого канал отправляет сообщения.
Получатель (to)
Идентификатор пользователя в пределах Страницы.
Полезно знать
  • Такие идентификаторы выдаются отдельно для каждого аккаунта. Вы получаете их в событиях message.received.
  • То, что и когда можно отправлять, определяют правила обмена сообщениями Meta.

TikTok

Отвечайте людям, которые пишут на ваш бизнес-аккаунт TikTok, текстом, медиа и кнопками ответа и отслеживайте каждое сообщение по тем же статусам и вебхукам.

0,0005 $ за исходящее сообщение или один кредит пакета

Что нужно
Аккаунт TikTok Business, в который вы можете войти.
Как подключить
В консоли нажмите «Продолжить с TikTok» и предоставьте доступ к сообщениям вашего бизнес-аккаунта.Для этого типа канала нет учётных данных, которые нужно копировать, и его нельзя создать с помощью API-ключа.
Тип канала
tiktok
Идентификатор отправителя
Аккаунт TikTok, с которого канал отправляет сообщения.
Получатель (to)
Идентификатор отправителя из события message.received.
Полезно знать
  • То, что и когда можно отправлять, определяют правила обмена сообщениями TikTok.

Подключите свой первый канал

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