Canale
Șapte tipuri de canale în spatele unui singur endpoint
OmniMessage este un gateway la care veniți cu propriul canal. Conectați expeditorii pe care îi dețineți deja, iar fiecare dintre ei este adresat, urmărit și facturat în același fel.
Veniți cu propriul canal
Conectați o singură dată, din consolă sau prin API
Un expeditor conectat devine un canal cu un ID. Acest ID este singura valoare specifică canalului dintr-o cerere de trimitere.
Expeditorul vă aparține
Numărul, botul sau contul este înregistrat pe numele dvs. la furnizor. Dacă renunțați la OmniMessage, nu vă lăsați expeditorul în urmă.
Două facturi separate
OmniMessage percepe un tarif de gateway per mesaj de ieșire. Orice percepe Meta, Twilio sau alt furnizor pentru canal vă este facturat direct de către acesta.
Autentificați-vă sau introduceți datele de acces
WhatsApp, Messenger și Instagram se autorizează prin autentificarea cu Facebook în consolă, iar TikTok prin autentificarea cu TikTok. Telegram, SMS și SMS OTP primesc date de acces, din consolă sau prin API; la fel și un număr WhatsApp care este deja pe Cloud API.
Datele de acces pot fi doar scrise
Tokenurile, codurile și datele de acces sunt transmise stratului de livrare atunci când conectați un canal. Gateway-ul nu le stochează, iar API-ul nu le returnează niciodată.
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"
}Pentru WhatsApp, Telegram, SMS și SMS OTP. Necesită permisiunea channels:write. Abonați-vă la channel.connected și channel.disconnected pentru a urmări starea conexiunii.
WhatsApp Business
Trimiteți de pe un număr de telefon WhatsApp Business Platform (Cloud API) pe care îl dețineți. OmniMessage transmite mesajele dvs. către Cloud API și vă raportează stările trimis, livrat, citit și eșuat.
0,001 $ per mesaj de ieșire sau un credit din pachet
- De ce aveți nevoie
- Un cont Facebook cu acces la portofoliul dvs. de companie Meta. Continuați cu Facebook în consolă, iar Meta Embedded Signup configurează contul WhatsApp Business și numărul. Un număr aflat deja pe Cloud API poate fi conectat și cu ID-urile sale și cu un token de acces al unui utilizator de sistem, din consolă sau prin API.
- Date de acces API
wab_account_idphone_number_idaccess_token- Tip de canal
whatsapp- Identificatorul expeditorului
- Numărul de telefon al expeditorului în format E.164, de exemplu
+971800123456. - Destinatar (
to) - Număr de telefon în format E.164.
- Bine de știut
- În afara ferestrei de 24 de ore pentru asistența clienților, WhatsApp acceptă doar mesaje de tip șablon aprobate.
- Listați șabloanele aprobate ale unui canal cu
GET /v1/channels/:id/templates. - Tarifele Meta pentru conversații sunt percepute de Meta contului dvs. WhatsApp Business. Ele sunt separate de tariful de gateway.
SMS
Trimiteți SMS-uri de pe un număr de telefon Twilio din propriul cont Twilio. Folosiți-l pentru notificări, mementouri și conversații în ambele sensuri, cu mesajele de intrare livrate către webhookul dvs.
0,0005 $ per mesaj de ieșire sau un credit din pachet
- De ce aveți nevoie
- Un cont Twilio și un număr de telefon activat pentru mesagerie.
- Date de acces API
account_sidphone_number_sidauth_token- Tip de canal
sms- Identificatorul expeditorului
- Numărul de telefon al expeditorului în format E.164.
- Destinatar (
to) - Număr de telefon în format E.164.
- Tipuri de mesaje
- TextAtașamente
- Bine de știut
- Atașamentele media depind de ce acceptă numărul dvs. și rețeaua de destinație.
- Tarifele operatorilor și ale Twilio sunt percepute de Twilio contului dvs. Twilio. Ele sunt separate de tariful de gateway.
SMS OTP
Un tip de canal dedicat codurilor de verificare. Acceptă doar text simplu, astfel încât un flux de autentificare nu poate trimite din greșeală altceva prin el.
0,0005 $ per mesaj de ieșire sau un credit din pachet
- De ce aveți nevoie
- Un cont la furnizorul dvs. de SMS OTP și cheia sa API.
- Date de acces API
api_key- Tip de canal
sms_otp- Identificatorul expeditorului
- ID-ul de expeditor sau numărul înregistrat la furnizorul dvs.
- Destinatar (
to) - Număr de telefon în format E.164.
- Tipuri de mesaje
- Text
- Bine de știut
- Doar text. Atașamentele și tipurile interactive sunt respinse cu
unsupported_message_type. - Tarifele furnizorului sunt percepute de furnizorul dvs. Ele sunt separate de tariful de gateway.
- Doar text. Atașamentele și tipurile interactive sunt respinse cu
Telegram
Trimiteți printr-un bot Telegram creat de dvs. Tokenul botului este singura dată de acces, iar persoanele care îi scriu botului ajung la dvs. ca evenimente message.received.
0,0003 $ per mesaj de ieșire sau un credit din pachet
- De ce aveți nevoie
- Un bot Telegram și tokenul său de la
@BotFather. Numele de utilizator al botului este citit din Telegram la conectare. - Date de acces API
access_token- Tip de canal
telegram- Identificatorul expeditorului
- Numele de utilizator al botului, citit din Telegram cu ajutorul tokenului.
- Destinatar (
to) - ID-ul conversației Telegram (chat ID).
- Tipuri de mesaje
- TextAtașamenteButoane de răspunsLocațieContacteSondaj
- Bine de știut
- Un bot poate scrie doar unei persoane care a început o conversație cu el.
- ID-ul conversației fiecărei persoane este inclus în evenimentele
message.receivedpe care le declanșează.
Messenger
Răspundeți persoanelor care contactează Pagina dvs. de Facebook, cu text, conținut media și butoane de răspuns. Mesajele de intrare ajung la webhookul dvs. împreună cu ID-ul expeditorului, necesar pentru a răspunde.
0,0005 $ per mesaj de ieșire sau un credit din pachet
- De ce aveți nevoie
- O Pagină de Facebook și un cont Facebook cu control deplin asupra ei.
- Cum se conectează
- În consolă, continuați cu Facebook și alegeți Pagina de pe care se trimite.Pentru acest tip de canal nu există date de acces de copiat și nu poate fi creat cu o cheie API.
- Tip de canal
messenger- Identificatorul expeditorului
- Pagina de pe care trimite canalul.
- Destinatar (
to) - ID de utilizator specific Paginii (page-scoped).
- Tipuri de mesaje
- TextAtașamenteButoane de răspuns
- Bine de știut
- ID-urile specifice Paginii sunt emise pentru fiecare Pagină. Le primiți în evenimentele
message.received. - Politicile de mesagerie Meta stabilesc ce puteți trimite și când.
- ID-urile specifice Paginii sunt emise pentru fiecare Pagină. Le primiți în evenimentele
Răspundeți la mesajele directe trimise contului dvs. profesional de Instagram cu text, conținut media și butoane de răspuns, prin același endpoint ca pentru orice alt canal.
0,0005 $ per mesaj de ieșire sau un credit din pachet
- De ce aveți nevoie
- Un cont profesional de Instagram asociat unei Pagini de Facebook pe care o administrați.
- Cum se conectează
- În consolă, continuați cu Facebook și alegeți Pagina la care este asociat contul dvs. de Instagram. Paginile fără un cont profesional asociat nu pot fi conectate.Pentru acest tip de canal nu există date de acces de copiat și nu poate fi creat cu o cheie API.
- Tip de canal
instagram- Identificatorul expeditorului
- Contul de Instagram de pe care trimite canalul.
- Destinatar (
to) - ID de utilizator specific Paginii (page-scoped).
- Tipuri de mesaje
- TextAtașamenteButoane de răspuns
- Bine de știut
- ID-urile specifice sunt emise pentru fiecare cont. Le primiți în evenimentele
message.received. - Politicile de mesagerie Meta stabilesc ce puteți trimite și când.
- ID-urile specifice sunt emise pentru fiecare cont. Le primiți în evenimentele
TikTok
Răspundeți persoanelor care scriu contului dvs. de companie TikTok cu text, conținut media și butoane de răspuns și urmăriți fiecare mesaj cu aceleași stări și webhookuri.
0,0005 $ per mesaj de ieșire sau un credit din pachet
- De ce aveți nevoie
- Un cont TikTok Business în care vă puteți autentifica.
- Cum se conectează
- În consolă, continuați cu TikTok și aprobați accesul la mesajele contului dvs. de companie.Pentru acest tip de canal nu există date de acces de copiat și nu poate fi creat cu o cheie API.
- Tip de canal
tiktok- Identificatorul expeditorului
- Contul TikTok de pe care trimite canalul.
- Destinatar (
to) - ID-ul expeditorului dintr-un eveniment
message.received. - Tipuri de mesaje
- TextAtașamenteButoane de răspuns
- Bine de știut
- Politicile de mesagerie TikTok stabilesc ce puteți trimite și când.
Conectați primul canal
Creați un cont, adăugați un expeditor pe care îl dețineți deja și trimiteți prin el cu aceeași cerere pe care ați testat-o în sandbox.