Preskoči na sadržaj

Kanali

Sedam vrsta kanala iza jedne krajnje točke

OmniMessage je pristupnik na koji donosite vlastiti kanal. Povezujete pošiljatelje koje već posjedujete, a svaki se od njih adresira, prati i naplaćuje na isti način.

Vlastiti kanal

Povežite jednom, u konzoli ili putem API-ja

Povezani pošiljatelj postaje kanal s ID-jem. Taj je ID jedina vrijednost u zahtjevu za slanje koja ovisi o kanalu.

  • Pošiljatelj je vaš

    Broj, bot ili račun registriran je na vas kod pružatelja usluge. Odlazak iz OmniMessagea ne znači da ostajete bez svojeg pošiljatelja.

  • Dvije zasebne naplate

    OmniMessage naplaćuje naknadu pristupnika po odlaznoj poruci. Sve što Meta, Twilio ili drugi pružatelj usluga naplaćuje za kanal, taj pružatelj naplaćuje izravno vama.

  • Prijavite se ili zalijepite vjerodajnice

    WhatsApp, Messenger i Instagram autoriziraju se prijavom putem Facebooka u konzoli, a TikTok prijavom putem TikToka. Telegram, SMS i SMS OTP primaju vjerodajnice, u konzoli ili putem API-ja, a isto vrijedi i za WhatsApp broj koji je već na Cloud API-ju.

  • Vjerodajnice se samo upisuju

    Tokeni, kodovi i vjerodajnice prosljeđuju se sloju za isporuku kada povezujete kanal. Pristupnik ih ne pohranjuje i API ih nikada ne vraća.

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

Za WhatsApp, Telegram, SMS i SMS OTP. Potreban je opseg channels:write. Pretplatite se na channel.connected i channel.disconnected da biste pratili status veze.

WhatsApp Business

Šaljite s telefonskog broja na WhatsApp Business Platformi (Cloud API) čiji ste vlasnik. OmniMessage prosljeđuje vaše poruke Cloud API-ju i javlja vam statuse: poslana, isporučena, pročitana i neuspjela.

0,001 $ po odlaznoj poruci ili jedan kredit iz paketa

Što vam je potrebno
Facebook prijava s pristupom vašem poslovnom portfelju na Meti. U konzoli nastavite putem Facebooka i Meta Embedded Signup postavit će WhatsApp Business račun i broj. Broj koji je već na Cloud API-ju možete povezati i pomoću njegovih ID-jeva i pristupnog tokena sistemskog korisnika, u konzoli ili putem API-ja.
API vjerodajnice
wab_account_idphone_number_idaccess_token
Vrsta kanala
whatsapp
Identifikator pošiljatelja
Telefonski broj pošiljatelja u formatu E.164, primjerice +971800123456.
Primatelj (to)
Telefonski broj u formatu E.164.
Dobro je znati
  • Izvan 24-satnog prozora korisničke podrške WhatsApp prihvaća samo odobrene poruke iz predložaka.
  • Odobrene predloške kanala dohvatite pozivom GET /v1/channels/:id/templates.
  • Metine naknade za razgovore Meta naplaćuje vašem WhatsApp Business računu. Odvojene su od naknade pristupnika.

SMS

Šaljite SMS s Twilio telefonskog broja na vlastitom Twilio računu. Koristite ga za obavijesti, podsjetnike i dvosmjerne razgovore, a dolazne poruke isporučuju se na vaš webhook.

0,0005 $ po odlaznoj poruci ili jedan kredit iz paketa

Što vam je potrebno
Twilio račun i telefonski broj kojem je omogućena razmjena poruka.
API vjerodajnice
account_sidphone_number_sidauth_token
Vrsta kanala
sms
Identifikator pošiljatelja
Telefonski broj pošiljatelja u formatu E.164.
Primatelj (to)
Telefonski broj u formatu E.164.
Vrste poruka
TekstPrivici
Dobro je znati
  • Medijski privici ovise o tome što podržavaju vaš broj i odredišna mreža.
  • Naknade operatera i Twilija Twilio naplaćuje vašem Twilio računu. Odvojene su od naknade pristupnika.

SMS OTP

Namjenska vrsta kanala za kodove za potvrdu. Prihvaća samo običan tekst, pa postupak prijave kroz nju ne može slučajno poslati ništa drugo.

0,0005 $ po odlaznoj poruci ili jedan kredit iz paketa

Što vam je potrebno
Račun kod vašeg pružatelja OTP SMS usluge i njegov API ključ.
API vjerodajnice
api_key
Vrsta kanala
sms_otp
Identifikator pošiljatelja
ID pošiljatelja ili broj registriran kod vašeg pružatelja usluge.
Primatelj (to)
Telefonski broj u formatu E.164.
Vrste poruka
Tekst
Dobro je znati
  • Samo tekst. Privici i interaktivne vrste odbijaju se uz unsupported_message_type.
  • Naknade pružatelja usluge naplaćuje vaš pružatelj. Odvojene su od naknade pristupnika.

Telegram

Šaljite putem Telegram bota koji ste sami izradili. Token bota jedina je vjerodajnica, a poruke osoba koje pišu botu stižu kao događaji message.received.

0,0003 $ po odlaznoj poruci ili jedan kredit iz paketa

Što vam je potrebno
Telegram bot i njegov token od @BotFather. Korisničko ime bota čita se s Telegrama pri povezivanju.
API vjerodajnice
access_token
Vrsta kanala
telegram
Identifikator pošiljatelja
Korisničko ime bota, pročitano s Telegrama pomoću tokena.
Primatelj (to)
ID Telegram razgovora.
Dobro je znati
  • Bot može slati poruke samo osobi koja je s njim započela razgovor.
  • ID razgovora svake osobe nalazi se u događajima message.received koje ta osoba pokrene.

Messenger

Odgovarajte osobama koje se jave vašoj Facebook stranici tekstom, medijima i gumbima za odgovor. Dolazne poruke stižu na vaš webhook s ID-jem pošiljatelja koji vam je potreban za odgovor.

0,0005 $ po odlaznoj poruci ili jedan kredit iz paketa

Što vam je potrebno
Facebook stranica i Facebook prijava s potpunom kontrolom nad njom.
Kako se povezati
U konzoli nastavite putem Facebooka i odaberite stranicu s koje želite slati.Za ovu vrstu kanala nema vjerodajnica koje biste kopirali i nije je moguće izraditi API ključem.
Vrsta kanala
messenger
Identifikator pošiljatelja
Stranica s koje kanal šalje.
Primatelj (to)
ID korisnika vezan uz stranicu.
Dobro je znati
  • ID-jevi vezani uz stranicu izdaju se za svaku stranicu zasebno. Dobivate ih u događajima message.received.
  • Na to što i kada možete slati primjenjuju se Metina pravila o razmjeni poruka.

Instagram

Odgovarajte na izravne poruke poslane vašem profesionalnom Instagram računu tekstom, medijima i gumbima za odgovor, kroz istu krajnju točku kao i na svakom drugom kanalu.

0,0005 $ po odlaznoj poruci ili jedan kredit iz paketa

Što vam je potrebno
Profesionalni Instagram račun povezan s Facebook stranicom kojom upravljate.
Kako se povezati
U konzoli nastavite putem Facebooka i odaberite stranicu s kojom je povezan vaš Instagram račun. Stranice bez povezanog profesionalnog računa nije moguće povezati.Za ovu vrstu kanala nema vjerodajnica koje biste kopirali i nije je moguće izraditi API ključem.
Vrsta kanala
instagram
Identifikator pošiljatelja
Instagram račun s kojeg kanal šalje.
Primatelj (to)
ID korisnika vezan uz stranicu.
Dobro je znati
  • ID-jevi se izdaju za svaki račun zasebno. Dobivate ih u događajima message.received.
  • Na to što i kada možete slati primjenjuju se Metina pravila o razmjeni poruka.

TikTok

Odgovarajte osobama koje pišu vašem poslovnom TikTok računu tekstom, medijima i gumbima za odgovor te pratite svaku poruku uz iste statuse i webhookove.

0,0005 $ po odlaznoj poruci ili jedan kredit iz paketa

Što vam je potrebno
TikTok Business račun na koji se možete prijaviti.
Kako se povezati
U konzoli nastavite putem TikToka i odobrite pristup porukama svojeg poslovnog računa.Za ovu vrstu kanala nema vjerodajnica koje biste kopirali i nije je moguće izraditi API ključem.
Vrsta kanala
tiktok
Identifikator pošiljatelja
TikTok račun s kojeg kanal šalje.
Primatelj (to)
ID pošiljatelja iz događaja message.received.
Dobro je znati
  • Na to što i kada možete slati primjenjuju se TikTokova pravila o razmjeni poruka.

Povežite svoj prvi kanal

Izradite račun, dodajte pošiljatelja kojeg već posjedujete i šaljite kroz njega istim zahtjevom koji ste testirali u sandboxu.