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.
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": "..."
}
}'{
"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ę.
- Tylko tekst. Załączniki i typy interaktywne są odrzucane z błędem
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.
- Typy wiadomości
- TekstZałącznikiPrzyciski odpowiedzi
- 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.
- Identyfikatory przypisane do strony są nadawane osobno dla każdej strony. Otrzymujesz je w zdarzeniach
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.
- Typy wiadomości
- TekstZałącznikiPrzyciski odpowiedzi
- 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.
- Identyfikatory są nadawane osobno dla każdego konta. Otrzymujesz je w zdarzeniach
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. - Typy wiadomości
- TekstZałącznikiPrzyciski odpowiedzi
- 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.