Каналы
Семь типов каналов за одним эндпоинтом
OmniMessage — шлюз, к которому вы подключаете собственные каналы. Вы добавляете отправителей, которые у вас уже есть, и каждый из них адресуется, отслеживается и оплачивается одинаково.
Подключайте собственные каналы
Подключите один раз — в консоли или через API
Подключённый отправитель становится каналом с идентификатором. Этот идентификатор — единственное значение в запросе на отправку, которое зависит от канала.
Отправитель принадлежит вам
Номер, бот или аккаунт зарегистрирован у провайдера на вас. Если вы уйдёте из OmniMessage, отправитель останется с вами.
Два отдельных счёта
OmniMessage взимает плату за шлюз за каждое исходящее сообщение. Всё, что Meta, Twilio или другой провайдер взимает за канал, они выставляют вам сами.
Войдите или вставьте учётные данные
WhatsApp, Messenger и Instagram авторизуются входом через Facebook в консоли, а TikTok — входом через TikTok. Для Telegram, SMS и SMS OTP нужны учётные данные — в консоли или через API; так же можно подключить номер WhatsApp, который уже работает с Cloud API.
Учётные данные доступны только для записи
Токены, коды и учётные данные передаются на уровень доставки при подключении канала. Шлюз их не хранит, а API никогда их не возвращает.
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": "..."
}
}'{
"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, текстом, медиа и кнопками ответа — через тот же эндпоинт, что и для остальных каналов.
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.
Подключите свой первый канал
Создайте аккаунт, добавьте отправителя, который у вас уже есть, и отправляйте через него тем же запросом, который вы тестировали в песочнице.