Перейти до вмісту

Канали

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

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.

Підключіть свій перший канал

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