Przejdź do treści

Kanały

Siedem typów kanałów za jednym endpointem

OmniMessage to bramka, do której podłączasz własne kanały. Łączysz nadawców, którzy już należą do Ciebie, a każdy z nich jest adresowany, śledzony i rozliczany w ten sam sposób.

Podłącz własny kanał

Podłączasz raz – w konsoli lub przez API

Podłączony nadawca staje się kanałem z własnym identyfikatorem. Ten identyfikator to jedyna wartość w żądaniu wysyłki, która zależy od kanału.

  • Nadawca należy do Ciebie

    Numer, bot lub konto są zarejestrowane u dostawcy na Ciebie. Rezygnując z OmniMessage, nie tracisz swojego nadawcy.

  • Dwa osobne rachunki

    OmniMessage pobiera opłatę za bramkę od każdej wiadomości wychodzącej. Opłaty Meta, Twilio lub innego dostawcy za sam kanał dostawca nalicza bezpośrednio Tobie.

  • Zaloguj się lub wklej dane uwierzytelniające

    WhatsAppa, Messengera i Instagrama autoryzujesz, logując się w konsoli przez Facebooka, a TikToka – logując się przez TikToka. Telegram, SMS i SMS OTP wymagają podania danych uwierzytelniających w konsoli lub przez API; tak samo można podłączyć numer WhatsApp, który już działa w Cloud API.

  • Dane uwierzytelniające są tylko do zapisu

    Tokeny, kody i dane uwierzytelniające są przekazywane do warstwy dostarczania w chwili podłączania kanału. Bramka ich nie przechowuje, a API nigdy ich nie zwraca.

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

Dla WhatsAppa, Telegrama, SMS i SMS OTP. Wymaga uprawnienia channels:write. Zasubskrybuj zdarzenia channel.connected i channel.disconnected, aby śledzić stan połączenia.

WhatsApp Business

Wysyłaj z własnego numeru telefonu na platformie WhatsApp Business Platform (Cloud API). OmniMessage przekazuje Twoje wiadomości do Cloud API i zwraca Ci statusy: wysłana, dostarczona, przeczytana i nieudana.

0,001 $ za wiadomość wychodzącą albo jeden kredyt z pakietu

Czego potrzebujesz
Konto na Facebooku z dostępem do Twojego portfolio biznesowego Meta. Wybierz w konsoli „Kontynuuj przez Facebooka”, a Meta Embedded Signup skonfiguruje konto WhatsApp Business i numer. Numer, który już działa w Cloud API, można też podłączyć za pomocą jego identyfikatorów i tokenu dostępu użytkownika systemowego – w konsoli lub przez API.
Dane uwierzytelniające API
wab_account_idphone_number_idaccess_token
Typ kanału
whatsapp
Identyfikator nadawcy
Numer telefonu nadawcy w formacie E.164, na przykład +971800123456.
Odbiorca (to)
Numer telefonu w formacie E.164.
Warto wiedzieć
  • Poza 24-godzinnym oknem obsługi klienta WhatsApp przyjmuje wyłącznie zatwierdzone wiadomości szablonowe.
  • Listę zatwierdzonych szablonów kanału pobierzesz przez GET /v1/channels/:id/templates.
  • Opłaty Meta za konwersacje Meta nalicza na Twoim koncie WhatsApp Business. Są one niezależne od opłaty za bramkę.

SMS

Wysyłaj SMS-y z numeru telefonu Twilio na własnym koncie Twilio. Sprawdzi się przy powiadomieniach, przypomnieniach i rozmowach dwukierunkowych, a wiadomości przychodzące trafiają na Twój webhook.

0,0005 $ za wiadomość wychodzącą albo jeden kredyt z pakietu

Czego potrzebujesz
Konto Twilio i numer telefonu z włączoną obsługą wiadomości.
Dane uwierzytelniające API
account_sidphone_number_sidauth_token
Typ kanału
sms
Identyfikator nadawcy
Numer telefonu nadawcy w formacie E.164.
Odbiorca (to)
Numer telefonu w formacie E.164.
Typy wiadomości
TekstZałączniki
Warto wiedzieć
  • Obsługa załączników multimedialnych zależy od możliwości Twojego numeru i sieci docelowej.
  • Opłaty operatorów i Twilio nalicza Twilio na Twoim koncie Twilio. Są one niezależne od opłaty za bramkę.

SMS OTP

Osobny typ kanału przeznaczony dla kodów weryfikacyjnych. Przyjmuje wyłącznie zwykły tekst, więc proces logowania nie wyśle przez niego przypadkiem niczego innego.

0,0005 $ za wiadomość wychodzącą albo jeden kredyt z pakietu

Czego potrzebujesz
Konto u Twojego dostawcy SMS OTP i jego klucz API.
Dane uwierzytelniające API
api_key
Typ kanału
sms_otp
Identyfikator nadawcy
Nazwa nadawcy lub numer zarejestrowane u Twojego dostawcy.
Odbiorca (to)
Numer telefonu w formacie E.164.
Typy wiadomości
Tekst
Warto wiedzieć
  • Tylko tekst. Załączniki i typy interaktywne są odrzucane z błędem unsupported_message_type.
  • Opłaty dostawcy nalicza Twój dostawca. Są one niezależne od opłaty za bramkę.

Telegram

Wysyłaj przez utworzonego przez siebie bota Telegram. Token bota to jedyne dane uwierzytelniające, a wiadomości od osób piszących do bota docierają jako zdarzenia message.received.

0,0003 $ za wiadomość wychodzącą albo jeden kredyt z pakietu

Czego potrzebujesz
Bot Telegram i jego token od @BotFather. Nazwa użytkownika bota jest odczytywana z Telegrama podczas podłączania.
Dane uwierzytelniające API
access_token
Typ kanału
telegram
Identyfikator nadawcy
Nazwa użytkownika bota odczytana z Telegrama na podstawie tokenu.
Odbiorca (to)
Identyfikator czatu Telegram.
Warto wiedzieć
  • Bot może pisać tylko do osób, które same rozpoczęły z nim rozmowę.
  • Identyfikator czatu każdej osoby znajduje się w wywołanych przez nią zdarzeniach message.received.

Messenger

Odpowiadaj osobom kontaktującym się z Twoją stroną na Facebooku – tekstem, multimediami i przyciskami odpowiedzi. Wiadomości przychodzące trafiają na Twój webhook razem z identyfikatorem nadawcy potrzebnym do odpowiedzi.

0,0005 $ za wiadomość wychodzącą albo jeden kredyt z pakietu

Czego potrzebujesz
Strona na Facebooku i konto na Facebooku z pełną kontrolą nad tą stroną.
Jak podłączyć
Wybierz w konsoli „Kontynuuj przez Facebooka” i wskaż stronę, z której chcesz wysyłać.Dla tego typu kanału nie ma danych uwierzytelniających do skopiowania i nie można go utworzyć za pomocą klucza API.
Typ kanału
messenger
Identyfikator nadawcy
Strona, z której kanał wysyła wiadomości.
Odbiorca (to)
Identyfikator użytkownika przypisany do strony.
Warto wiedzieć
  • Identyfikatory przypisane do strony są nadawane osobno dla każdej strony. Otrzymujesz je w zdarzeniach message.received.
  • O tym, co i kiedy możesz wysyłać, decydują zasady Meta dotyczące wiadomości.

Instagram

Odpowiadaj na wiadomości prywatne wysyłane na Twoje profesjonalne konto na Instagramie – tekstem, multimediami i przyciskami odpowiedzi – przez ten sam endpoint co w każdym innym kanale.

0,0005 $ za wiadomość wychodzącą albo jeden kredyt z pakietu

Czego potrzebujesz
Profesjonalne konto na Instagramie połączone ze stroną na Facebooku, którą zarządzasz.
Jak podłączyć
Wybierz w konsoli „Kontynuuj przez Facebooka” i wskaż stronę, z którą połączone jest Twoje konto na Instagramie. Stron bez połączonego konta profesjonalnego nie można podłączyć.Dla tego typu kanału nie ma danych uwierzytelniających do skopiowania i nie można go utworzyć za pomocą klucza API.
Typ kanału
instagram
Identyfikator nadawcy
Konto na Instagramie, z którego kanał wysyła wiadomości.
Odbiorca (to)
Identyfikator użytkownika przypisany do strony.
Warto wiedzieć
  • Identyfikatory są nadawane osobno dla każdego konta. Otrzymujesz je w zdarzeniach message.received.
  • O tym, co i kiedy możesz wysyłać, decydują zasady Meta dotyczące wiadomości.

TikTok

Odpowiadaj osobom, które piszą do Twojego konta firmowego na TikToku – tekstem, multimediami i przyciskami odpowiedzi – i śledź każdą wiadomość za pomocą tych samych statusów i webhooków.

0,0005 $ za wiadomość wychodzącą albo jeden kredyt z pakietu

Czego potrzebujesz
Konto TikTok Business, na które możesz się zalogować.
Jak podłączyć
Wybierz w konsoli „Kontynuuj przez TikToka” i zezwól na dostęp do wiadomości Twojego konta firmowego.Dla tego typu kanału nie ma danych uwierzytelniających do skopiowania i nie można go utworzyć za pomocą klucza API.
Typ kanału
tiktok
Identyfikator nadawcy
Konto na TikToku, z którego kanał wysyła wiadomości.
Odbiorca (to)
Identyfikator nadawcy ze zdarzenia message.received.
Warto wiedzieć
  • O tym, co i kiedy możesz wysyłać, decydują zasady TikToka dotyczące wiadomości.

Podłącz pierwszy kanał

Załóż konto, dodaj nadawcę, który już należy do Ciebie, i wysyłaj przez niego tym samym żądaniem, które zostało przetestowane w sandboksie.