Kanály

Sedem typov kanálov za jedným endpointom

OmniMessage je brána, do ktorej si prinášate vlastné kanály. Pripojíte odosielateľov, ktorých už vlastníte, a každý z nich sa adresuje, sleduje a účtuje rovnakým spôsobom.

Získať kľúč API Prečítať dokumentáciu

Pripojte vlastný kanál

Pripojíte raz, v konzole alebo cez API

Z pripojeného odosielateľa sa stane kanál s vlastným ID. Toto ID je jediná hodnota v požiadavke na odoslanie, ktorá závisí od kanála.

Odosielateľ patrí vám
Číslo, bot alebo účet je u poskytovateľa registrovaný na vás. Ak odídete z OmniMessage, o svojho odosielateľa neprídete.
Dve samostatné vyúčtovania
OmniMessage účtuje poplatok za bránu za každú odchádzajúcu správu. Všetko, čo si za kanál účtuje Meta, Twilio alebo iný poskytovateľ, vám fakturujú priamo oni.
Prihláste sa alebo vložte prístupové údaje
WhatsApp, Messenger a Instagram sa autorizujú prihlásením cez Facebook v konzole a TikTok prihlásením cez TikTok. Telegram, SMS a SMS OTP vyžadujú prístupové údaje, ktoré zadáte v konzole alebo cez API. Rovnako možno pripojiť aj číslo WhatsApp, ktoré už používa Cloud API.
Prístupové údaje sú určené iba na zápis
Tokeny, kódy a prístupové údaje sa pri pripojení kanála odovzdajú doručovacej vrstve. Brána ich neukladá a API ich nikdy nevracia.

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"
}

Pre WhatsApp, Telegram, SMS a SMS OTP. Vyžaduje rozsah channels:write. Ak chcete sledovať stav pripojenia, prihláste sa na odber udalostí channel.connected a channel.disconnected.

WhatsApp Business

Posielajte správy z telefónneho čísla platformy WhatsApp Business Platform (Cloud API), ktoré vlastníte. OmniMessage preposiela vaše správy do Cloud API a hlási vám stavy odoslaná, doručená, prečítaná a neúspešná.

0,001 $ za odchádzajúcu správu alebo jeden kredit z balíka

Čo potrebujete: Prihlásenie do Facebooku s prístupom k vášmu firemnému portfóliu Meta. V konzole pokračujte cez Facebook a Meta Embedded Signup nastaví účet WhatsApp Business aj číslo. Číslo, ktoré už používa Cloud API, možno pripojiť aj pomocou jeho ID a prístupového tokenu systémového používateľa, a to v konzole alebo cez API.
Prístupové údaje API: wab_account_idphone_number_idaccess_token
Typ kanála: whatsapp
Identifikátor odosielateľa: Telefónne číslo odosielateľa vo formáte E.164, napríklad +971800123456.
Príjemca (to): Telefónne číslo vo formáte E.164.
Typy správ: Text Prílohy Šablóna Tlačidlá odpovede Zoznam Tlačidlo s URL Poloha Kontakty
Dobré vedieť: Mimo 24-hodinového okna zákazníckej podpory prijíma WhatsApp iba schválené šablónové správy.
Zoznam schválených šablón kanála získate volaním GET /v1/channels/:id/templates.
Poplatky spoločnosti Meta za konverzácie účtuje Meta vášmu účtu WhatsApp Business. Sú oddelené od poplatku za bránu.

SMS

Posielajte SMS z telefónneho čísla Twilio vo vašom vlastnom účte Twilio. Využijete ho na notifikácie, pripomienky aj obojsmerné konverzácie, pričom prichádzajúce správy sa doručujú na váš webhook.

0,0005 $ za odchádzajúcu správu alebo jeden kredit z balíka

Čo potrebujete: Účet Twilio a telefónne číslo s povoleným posielaním správ.
Prístupové údaje API: account_sidphone_number_sidauth_token
Typ kanála: sms
Identifikátor odosielateľa: Telefónne číslo odosielateľa vo formáte E.164.
Príjemca (to): Telefónne číslo vo formáte E.164.
Typy správ: Text Prílohy
Dobré vedieť: Multimediálne prílohy závisia od toho, čo podporuje vaše číslo a cieľová sieť.
Poplatky operátorov a spoločnosti Twilio účtuje Twilio vášmu účtu Twilio. Sú oddelené od poplatku za bránu.

SMS OTP

Vyhradený typ kanála pre overovacie kódy. Prijíma iba obyčajný text, takže prihlasovací proces cezeň nemôže omylom odoslať nič iné.

0,0005 $ za odchádzajúcu správu alebo jeden kredit z balíka

Čo potrebujete: Účet u vášho poskytovateľa OTP SMS a jeho kľúč API.
Prístupové údaje API: api_key
Typ kanála: sms_otp
Identifikátor odosielateľa: ID odosielateľa alebo číslo registrované u vášho poskytovateľa.
Príjemca (to): Telefónne číslo vo formáte E.164.
Typy správ: Text
Dobré vedieť: Iba text. Prílohy a interaktívne typy sa odmietnu s chybou unsupported_message_type.
Poplatky poskytovateľa účtuje váš poskytovateľ. Sú oddelené od poplatku za bránu.

Posielajte správy cez bota Telegramu, ktorého ste vytvorili. Token bota je jediný prístupový údaj a ľudia, ktorí botovi napíšu, prichádzajú ako udalosti message.received.

0,0003 $ za odchádzajúcu správu alebo jeden kredit z balíka

Čo potrebujete: Bot Telegramu a jeho token od @BotFather. Používateľské meno bota sa pri pripojení načíta z Telegramu.
Prístupové údaje API: access_token
Typ kanála: telegram
Identifikátor odosielateľa: Používateľské meno bota načítané z Telegramu pomocou tokenu.
Príjemca (to): ID četu v Telegrame.
Typy správ: Text Prílohy Tlačidlá odpovede Poloha Kontakty Anketa
Dobré vedieť: Bot môže napísať iba človeku, ktorý s ním začal konverzáciu.
ID četu každého človeka je súčasťou udalostí message.received, ktoré vyvolá.

Messenger

Odpovedajte ľuďom, ktorí kontaktujú vašu stránku na Facebooku, textom, médiami a tlačidlami odpovede. Prichádzajúce správy dorazia na váš webhook spolu s ID odosielateľa, ktoré potrebujete na odpoveď.

0,0005 $ za odchádzajúcu správu alebo jeden kredit z balíka

Čo potrebujete: Stránka na Facebooku a prihlásenie do Facebooku s plnou kontrolou nad ňou.
Ako sa pripojiť: V konzole pokračujte cez Facebook a vyberte stránku, z ktorej sa má odosielať.Pre tento typ kanála neexistujú prístupové údaje, ktoré by sa dali skopírovať, a nemožno ho vytvoriť pomocou kľúča API.
Typ kanála: messenger
Identifikátor odosielateľa: Stránka, z ktorej kanál odosiela.
Príjemca (to): ID používateľa v rámci stránky.
Typy správ: Text Prílohy Tlačidlá odpovede
Dobré vedieť: ID v rámci stránky sa vydávajú pre každú stránku osobitne. Dostanete ich v udalostiach message.received.
Na to, čo a kedy môžete posielať, sa vzťahujú pravidlá spoločnosti Meta pre posielanie správ.

Instagram

Odpovedajte na priame správy poslané na váš profesionálny účet na Instagrame textom, médiami a tlačidlami odpovede, cez rovnaký endpoint ako pri všetkých ostatných kanáloch.

0,0005 $ za odchádzajúcu správu alebo jeden kredit z balíka

Čo potrebujete: Profesionálny účet na Instagrame prepojený so stránkou na Facebooku, ktorú spravujete.
Ako sa pripojiť: V konzole pokračujte cez Facebook a vyberte stránku, s ktorou je prepojený váš účet na Instagrame. Stránky bez prepojeného profesionálneho účtu nemožno pripojiť.Pre tento typ kanála neexistujú prístupové údaje, ktoré by sa dali skopírovať, a nemožno ho vytvoriť pomocou kľúča API.
Typ kanála: instagram
Identifikátor odosielateľa: Účet na Instagrame, z ktorého kanál odosiela.
Príjemca (to): ID používateľa v rámci stránky.
Typy správ: Text Prílohy Tlačidlá odpovede
Dobré vedieť: ID v rámci účtu sa vydávajú pre každý účet osobitne. Dostanete ich v udalostiach message.received.
Na to, čo a kedy môžete posielať, sa vzťahujú pravidlá spoločnosti Meta pre posielanie správ.

TikTok

Odpovedajte ľuďom, ktorí píšu na váš firemný účet na TikToku, textom, médiami a tlačidlami odpovede a každú správu sledujte pomocou rovnakých stavov a webhookov.

0,0005 $ za odchádzajúcu správu alebo jeden kredit z balíka

Čo potrebujete: Účet TikTok Business, do ktorého sa môžete prihlásiť.
Ako sa pripojiť: V konzole pokračujte cez TikTok a schváľte prístup k správam svojho firemného účtu.Pre tento typ kanála neexistujú prístupové údaje, ktoré by sa dali skopírovať, a nemožno ho vytvoriť pomocou kľúča API.
Typ kanála: tiktok
Identifikátor odosielateľa: Účet na TikToku, z ktorého kanál odosiela.
Príjemca (to): ID odosielateľa z udalosti message.received.
Typy správ: Text Prílohy Tlačidlá odpovede
Dobré vedieť: Na to, čo a kedy môžete posielať, sa vzťahujú pravidlá TikToku pre posielanie správ.

Pripojte svoj prvý kanál

Vytvorte si účet, pridajte odosielateľa, ktorého už vlastníte, a posielajte cezeň rovnakou požiadavkou, akú ste otestovali v sandboxe.

Získať kľúč API Prečítať dokumentáciu

Pripojíte raz, v konzole alebo cez API

Odosielateľ patrí vám

Dve samostatné vyúčtovania

Prihláste sa alebo vložte prístupové údaje

Prístupové údaje sú určené iba na zápis

WhatsApp Business

SMS

SMS OTP

Telegram

Messenger

Instagram

TikTok

Pripojte svoj prvý kanál