Salt la conținut

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ă.

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

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.

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).
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.received pe 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).
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.

Instagram

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).
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.

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.
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.