Към съдържанието

Канали

Седем типа канали зад една крайна точка

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 за разговори се начисляват от 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 $ на изходящо съобщение или един кредит от пакет

Какво ви е нужно
Акаунт при вашия доставчик на OTP SMS и неговият 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 за съобщенията определят какво и кога можете да изпращате.

Свържете първия си канал

Създайте акаунт, добавете подател, който вече притежавате, и изпращайте през него със същата заявка, която сте тествали в sandbox средата.