Канали
Сім типів каналів за одним ендпоінтом
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.
Підключіть свій перший канал
Створіть акаунт, додайте відправника, який у вас уже є, і надсилайте через нього тим самим запитом, який ви тестували в пісочниці.