Preskoči na vsebino
OmniMessage

Kanali

Sedem vrst kanalov prek ene končne točke

OmniMessage je prehod, v katerega prinesete lasten kanal. Povežete pošiljatelje, ki jih že imate, in vsak od njih se naslavlja, spremlja in obračunava na enak način.

Pridobite ključ APIPreberite dokumentacijo

Lasten kanal

Povežite enkrat, v konzoli ali prek API-ja

Povezani pošiljatelj postane kanal z ID-jem. Ta ID je edina vrednost v zahtevi za pošiljanje, ki je odvisna od kanala.

  • Pošiljatelj je vaš

    Številka, bot ali račun je pri ponudniku registriran na vas. Če zapustite OmniMessage, svojega pošiljatelja ne pustite za seboj.

  • Dva ločena obračuna

    OmniMessage zaračuna pristojbino prehoda za vsako odhodno sporočilo. Vse, kar za kanal zaračuna Meta, Twilio ali drug ponudnik, vam ta ponudnik zaračuna neposredno.

  • Prijavite se ali prilepite poverilnice

    WhatsApp, Messenger in Instagram se avtorizirajo s prijavo s Facebookom v konzoli, TikTok pa s prijavo s TikTokom. Telegram, SMS in SMS OTP sprejmejo poverilnice, v konzoli ali prek API-ja, enako pa velja tudi za številko WhatsApp, ki je že v Cloud API-ju.

  • Poverilnice se samo zapisujejo

    Žetoni, kode in poverilnice se ob povezovanju kanala posredujejo dostavni plasti. Prehod jih ne shranjuje in API jih nikoli ne vrne.

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 in SMS OTP. Zahteva obseg channels:write. Naročite se na channel.connected in channel.disconnected, da spremljate stanje povezave.

WhatsApp Business

Pošiljajte s telefonske številke na platformi WhatsApp Business Platform (Cloud API), ki je v vaši lasti. OmniMessage vaša sporočila posreduje Cloud API-ju in vam sporoča statuse: poslano, dostavljeno, prebrano in neuspešno.

0,001 $ na odhodno sporočilo ali en kredit iz paketa

Kaj potrebujete
Prijava v Facebook z dostopom do vašega poslovnega portfelja Meta. V konzoli nadaljujte s Facebookom in Meta Embedded Signup nastavi račun WhatsApp Business in številko. Številko, ki je že v Cloud API-ju, lahko povežete tudi z njenimi ID-ji in dostopnim žetonom sistemskega uporabnika, v konzoli ali prek API-ja.
Poverilnice API
wab_account_idphone_number_idaccess_token
Vrsta kanala
whatsapp
Identifikator pošiljatelja
Telefonska številka pošiljatelja v obliki E.164, na primer +971800123456.
Prejemnik (to)
Telefonska številka v obliki E.164.
Vrste sporočil
BesediloPrilogePredlogaGumbi za odgovorSeznamGumb URLLokacijaStiki
Dobro je vedeti
  • Zunaj 24-urnega okna za podporo strankam WhatsApp sprejema samo odobrena sporočila iz predlog.
  • Odobrene predloge kanala pridobite s klicem GET /v1/channels/:id/templates.
  • Pristojbine družbe Meta za pogovore Meta zaračuna vašemu računu WhatsApp Business. Ločene so od pristojbine prehoda.

SMS

Pošiljajte SMS-e s telefonske številke Twilio v svojem računu Twilio. Uporabite jo za obvestila, opomnike in dvosmerne pogovore, dohodna sporočila pa so dostavljena na vaš webhook.

0,0005 $ na odhodno sporočilo ali en kredit iz paketa

Kaj potrebujete
Račun Twilio in telefonska številka, ki ima omogočeno sporočanje.
Poverilnice API
account_sidphone_number_sidauth_token
Vrsta kanala
sms
Identifikator pošiljatelja
Telefonska številka pošiljatelja v obliki E.164.
Prejemnik (to)
Telefonska številka v obliki E.164.
Vrste sporočil
BesediloPriloge
Dobro je vedeti
  • Medijske priloge so odvisne od tega, kaj podpirata vaša številka in ciljno omrežje.
  • Pristojbine operaterjev in družbe Twilio zaračuna Twilio vašemu računu Twilio. Ločene so od pristojbine prehoda.

SMS OTP

Namenska vrsta kanala za potrditvene kode. Sprejema samo navadno besedilo, zato postopek prijave prek nje ne more po pomoti poslati ničesar drugega.

0,0005 $ na odhodno sporočilo ali en kredit iz paketa

Kaj potrebujete
Račun pri vašem ponudniku storitve OTP SMS in njegov ključ API.
Poverilnice API
api_key
Vrsta kanala
sms_otp
Identifikator pošiljatelja
ID pošiljatelja ali številka, registrirana pri vašem ponudniku.
Prejemnik (to)
Telefonska številka v obliki E.164.
Vrste sporočil
Besedilo
Dobro je vedeti
  • Samo besedilo. Priloge in interaktivne vrste so zavrnjene z unsupported_message_type.
  • Pristojbine ponudnika zaračuna vaš ponudnik. Ločene so od pristojbine prehoda.

Telegram

Pošiljajte prek bota Telegram, ki ste ga ustvarili sami. Žeton bota je edina poverilnica, sporočila ljudi, ki pišejo botu, pa prispejo kot dogodki message.received.

0,0003 $ na odhodno sporočilo ali en kredit iz paketa

Kaj potrebujete
Bot Telegram in njegov žeton, ki ga izda @BotFather. Uporabniško ime bota se ob povezovanju prebere iz Telegrama.
Poverilnice API
access_token
Vrsta kanala
telegram
Identifikator pošiljatelja
Uporabniško ime bota, prebrano iz Telegrama z žetonom.
Prejemnik (to)
ID klepeta v Telegramu.
Vrste sporočil
BesediloPrilogeGumbi za odgovorLokacijaStikiAnketa
Dobro je vedeti
  • Bot lahko piše samo osebi, ki je z njim začela pogovor.
  • ID klepeta posamezne osebe je vključen v dogodke message.received, ki jih ta oseba sproži.

Messenger

Ljudem, ki se obrnejo na vašo Facebookovo stran, odgovarjajte z besedilom, mediji in gumbi za odgovor. Dohodna sporočila prispejo na vaš webhook z ID-jem pošiljatelja, ki ga potrebujete za odgovor.

0,0005 $ na odhodno sporočilo ali en kredit iz paketa

Kaj potrebujete
Facebookova stran in prijava v Facebook s popolnim nadzorom nad njo.
Kako povezati
V konzoli nadaljujte s Facebookom in izberite stran, s katere želite pošiljati.Za to vrsto kanala ni poverilnic, ki bi jih kopirali, in je ni mogoče ustvariti s ključem API.
Vrsta kanala
messenger
Identifikator pošiljatelja
Stran, s katere kanal pošilja.
Prejemnik (to)
ID uporabnika, vezan na stran.
Vrste sporočil
BesediloPrilogeGumbi za odgovor
Dobro je vedeti
  • ID-ji, vezani na stran, se izdajo za vsako stran posebej. Prejmete jih v dogodkih message.received.
  • Za to, kaj in kdaj lahko pošiljate, veljajo pravila družbe Meta o sporočanju.

Instagram

Na neposredna sporočila, poslana vašemu profesionalnemu računu Instagram, odgovarjajte z besedilom, mediji in gumbi za odgovor, skozi isto končno točko kot na vseh drugih kanalih.

0,0005 $ na odhodno sporočilo ali en kredit iz paketa

Kaj potrebujete
Profesionalni račun Instagram, povezan s Facebookovo stranjo, ki jo upravljate.
Kako povezati
V konzoli nadaljujte s Facebookom in izberite stran, s katero je povezan vaš račun Instagram. Strani brez povezanega profesionalnega računa ni mogoče povezati.Za to vrsto kanala ni poverilnic, ki bi jih kopirali, in je ni mogoče ustvariti s ključem API.
Vrsta kanala
instagram
Identifikator pošiljatelja
Račun Instagram, s katerega kanal pošilja.
Prejemnik (to)
ID uporabnika, vezan na stran.
Vrste sporočil
BesediloPrilogeGumbi za odgovor
Dobro je vedeti
  • ID-ji se izdajo za vsak račun posebej. Prejmete jih v dogodkih message.received.
  • Za to, kaj in kdaj lahko pošiljate, veljajo pravila družbe Meta o sporočanju.

TikTok

Ljudem, ki pišejo vašemu poslovnemu računu TikTok, odgovarjajte z besedilom, mediji in gumbi za odgovor ter vsako sporočilo spremljajte z enakimi statusi in webhooki.

0,0005 $ na odhodno sporočilo ali en kredit iz paketa

Kaj potrebujete
Račun TikTok Business, v katerega se lahko prijavite.
Kako povezati
V konzoli nadaljujte s TikTokom in odobrite dostop do sporočil svojega poslovnega računa.Za to vrsto kanala ni poverilnic, ki bi jih kopirali, in je ni mogoče ustvariti s ključem API.
Vrsta kanala
tiktok
Identifikator pošiljatelja
Račun TikTok, s katerega kanal pošilja.
Prejemnik (to)
ID pošiljatelja iz dogodka message.received.
Vrste sporočil
BesediloPrilogeGumbi za odgovor
Dobro je vedeti
  • Za to, kaj in kdaj lahko pošiljate, veljajo pravila družbe TikTok o sporočanju.

Povežite svoj prvi kanal

Ustvarite račun, dodajte pošiljatelja, ki ga že imate, in pošiljajte prek njega z isto zahtevo, ki ste jo preizkusili v peskovniku.

Pridobite ključ APIPreberite dokumentacijo