Kanály

Sedm typů kanálů za jedním endpointem

OmniMessage je brána, ke které si přinášíte vlastní kanál. Připojíte odesílatele, které už vlastníte, a každý z nich se adresuje, sleduje i účtuje stejným způsobem.

Získat klíč API Přečíst dokumentaci

Přineste si vlastní kanál

Připojte jednou, v konzoli nebo přes API

Z připojeného odesílatele se stane kanál s vlastním ID. Toto ID je jediná hodnota v požadavku na odeslání, která se váže ke kanálu.

Odesílatel patří vám
Číslo, bot nebo účet je u poskytovatele registrován na vás. Odchod z OmniMessage neznamená, že o svého odesílatele přijdete.
Dvě oddělená vyúčtování
OmniMessage účtuje poplatek za bránu za každou odchozí zprávu. Cokoli si za kanál účtuje Meta, Twilio nebo jiný poskytovatel, vám fakturuje přímo tento poskytovatel.
Přihlaste se, nebo vložte přihlašovací údaje
WhatsApp, Messenger a Instagram se autorizují přihlášením přes Facebook v konzoli, TikTok přihlášením přes TikTok. Telegram, SMS a SMS OTP vyžadují přihlašovací údaje, zadané v konzoli nebo přes API; stejně lze připojit i číslo WhatsApp, které už Cloud API používá.
Přihlašovací údaje jsou jen pro zápis
Tokeny, kódy a přihlašovací údaje se při připojení kanálu předávají doručovací vrstvě. Brána je neukládá a API je nikdy nevrací.

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

Pro WhatsApp, Telegram, SMS a SMS OTP. Vyžaduje oprávnění channels:write. Stav připojení můžete sledovat odběrem událostí channel.connected a channel.disconnected.

WhatsApp Business

Odesílejte z telefonního čísla WhatsApp Business Platform (Cloud API), které vlastníte. OmniMessage předává vaše zprávy do Cloud API a hlásí vám zpět stavy odesláno, doručeno, přečteno a selhalo.

0,001 $ za odchozí zprávu, nebo jeden kredit z balíčku

Co potřebujete: Přihlášení k Facebooku s přístupem k vašemu firemnímu portfoliu Meta. V konzoli pokračujte přes Facebook a Meta Embedded Signup nastaví účet WhatsApp Business i číslo. Číslo, které už Cloud API používá, lze připojit také pomocí jeho ID a přístupového tokenu systémového uživatele, v konzoli nebo přes API.
Přihlašovací údaje k API: wab_account_idphone_number_idaccess_token
Typ kanálu: whatsapp
Identifikátor odesílatele: Telefonní číslo odesílatele ve formátu E.164, například +971800123456.
Příjemce (to): Telefonní číslo ve formátu E.164.
Typy zpráv: Text Přílohy Šablona Tlačítka odpovědí Seznam Tlačítko s URL Poloha Kontakty
Dobré vědět: Mimo 24hodinové okno zákaznické podpory přijímá WhatsApp jen schválené šablony zpráv.
Schválené šablony kanálu vypíšete voláním GET /v1/channels/:id/templates.
Poplatky společnosti Meta za konverzace účtuje Meta vašemu účtu WhatsApp Business. S poplatkem za bránu nesouvisejí.

SMS

Odesílejte SMS z telefonního čísla Twilio ve vlastním účtu Twilio. Hodí se pro oznámení, připomínky i obousměrné konverzace; příchozí zprávy se doručují na váš webhook.

0,0005 $ za odchozí zprávu, nebo jeden kredit z balíčku

Co potřebujete: Účet Twilio a telefonní číslo s povoleným odesíláním zpráv.
Přihlašovací údaje k API: account_sidphone_number_sidauth_token
Typ kanálu: sms
Identifikátor odesílatele: Telefonní číslo odesílatele ve formátu E.164.
Příjemce (to): Telefonní číslo ve formátu E.164.
Typy zpráv: Text Přílohy
Dobré vědět: Multimediální přílohy závisejí na tom, co podporuje vaše číslo a cílová síť.
Poplatky operátorů a společnosti Twilio účtuje Twilio vašemu účtu Twilio. S poplatkem za bránu nesouvisejí.

SMS OTP

Vyhrazený typ kanálu pro ověřovací kódy. Přijímá jen prostý text, takže přihlašovací proces přes něj nemůže omylem odeslat nic jiného.

0,0005 $ za odchozí zprávu, nebo jeden kredit z balíčku

Co potřebujete: Účet u vašeho poskytovatele OTP SMS a jeho klíč API.
Přihlašovací údaje k API: api_key
Typ kanálu: sms_otp
Identifikátor odesílatele: ID odesílatele nebo číslo registrované u vašeho poskytovatele.
Příjemce (to): Telefonní číslo ve formátu E.164.
Typy zpráv: Text
Dobré vědět: Jen text. Přílohy a interaktivní typy se odmítají s kódem unsupported_message_type.
Poplatky poskytovatele účtuje váš poskytovatel. S poplatkem za bránu nesouvisejí.

Odesílejte přes bota na Telegramu, kterého jste vytvořili. Token bota je jediný přihlašovací údaj a lidé, kteří botovi napíšou, k vám dorazí jako události message.received.

0,0003 $ za odchozí zprávu, nebo jeden kredit z balíčku

Co potřebujete: Bot na Telegramu a jeho token od @BotFather. Uživatelské jméno bota se při připojení načte z Telegramu.
Přihlašovací údaje k API: access_token
Typ kanálu: telegram
Identifikátor odesílatele: Uživatelské jméno bota, načtené z Telegramu pomocí tokenu.
Příjemce (to): ID chatu na Telegramu.
Typy zpráv: Text Přílohy Tlačítka odpovědí Poloha Kontakty Anketa
Dobré vědět: Bot může psát jen člověku, který s ním sám zahájil konverzaci.
ID chatu každého člověka je součástí událostí message.received, které vyvolá.

Messenger

Odpovídejte lidem, kteří kontaktují vaši stránku na Facebooku, textem, médii a tlačítky odpovědí. Příchozí zprávy dorazí na váš webhook spolu s ID odesílatele, které potřebujete k odpovědi.

0,0005 $ za odchozí zprávu, nebo jeden kredit z balíčku

Co potřebujete: Stránka na Facebooku a přihlášení k Facebooku s plnou kontrolou nad ní.
Jak se připojit: V konzoli pokračujte přes Facebook a vyberte stránku, ze které se má odesílat.U tohoto typu kanálu nejsou žádné přihlašovací údaje ke zkopírování a kanál nelze vytvořit pomocí klíče API.
Typ kanálu: messenger
Identifikátor odesílatele: Stránka, ze které kanál odesílá.
Příjemce (to): ID uživatele platné v rámci stránky (page-scoped ID).
Typy zpráv: Text Přílohy Tlačítka odpovědí
Dobré vědět: ID platná v rámci stránky se vydávají pro každou stránku zvlášť. Dostanete je v událostech message.received.
Co a kdy můžete odesílat, určují zásady společnosti Meta pro zasílání zpráv.

Instagram

Odpovídejte na soukromé zprávy zaslané vašemu profesionálnímu účtu na Instagramu textem, médii a tlačítky odpovědí, a to stejným endpointem jako u všech ostatních kanálů.

0,0005 $ za odchozí zprávu, nebo jeden kredit z balíčku

Co potřebujete: Profesionální účet na Instagramu propojený se stránkou na Facebooku, kterou spravujete.
Jak se připojit: V konzoli pokračujte přes Facebook a vyberte stránku, se kterou je váš účet na Instagramu propojen. Stránky bez propojeného profesionálního účtu připojit nelze.U tohoto typu kanálu nejsou žádné přihlašovací údaje ke zkopírování a kanál nelze vytvořit pomocí klíče API.
Typ kanálu: instagram
Identifikátor odesílatele: Účet na Instagramu, ze kterého kanál odesílá.
Příjemce (to): ID uživatele platné v rámci stránky (page-scoped ID).
Typy zpráv: Text Přílohy Tlačítka odpovědí
Dobré vědět: Tato ID se vydávají pro každý účet zvlášť. Dostanete je v událostech message.received.
Co a kdy můžete odesílat, určují zásady společnosti Meta pro zasílání zpráv.

TikTok

Odpovídejte lidem, kteří píšou vašemu firemnímu účtu na TikToku, textem, médii a tlačítky odpovědí a sledujte každou zprávu pomocí stejných stavů a webhooků.

0,0005 $ za odchozí zprávu, nebo jeden kredit z balíčku

Co potřebujete: Účet TikTok Business, ke kterému se můžete přihlásit.
Jak se připojit: V konzoli pokračujte přes TikTok a schvalte přístup ke zprávám svého firemního účtu.U tohoto typu kanálu nejsou žádné přihlašovací údaje ke zkopírování a kanál nelze vytvořit pomocí klíče API.
Typ kanálu: tiktok
Identifikátor odesílatele: Účet na TikToku, ze kterého kanál odesílá.
Příjemce (to): ID odesílatele z události message.received.
Typy zpráv: Text Přílohy Tlačítka odpovědí
Dobré vědět: Co a kdy můžete odesílat, určují zásady TikToku pro zasílání zpráv.

Připojte svůj první kanál

Vytvořte si účet, přidejte odesílatele, kterého už vlastníte, a odesílejte přes něj stejným požadavkem, jaký jste otestovali v sandboxu.

Získat klíč API Přečíst dokumentaci

Připojte jednou, v konzoli nebo přes API

Odesílatel patří vám

Dvě oddělená vyúčtování

Přihlaste se, nebo vložte přihlašovací údaje

Přihlašovací údaje jsou jen pro zápis

WhatsApp Business

SMS

SMS OTP

Telegram

Messenger

Instagram

TikTok

Připojte svůj první kanál