Üzenetküldő átjáró API

Egyetlen API minden üzenetküldő csatornához

Küldjön WhatsApp Business-, SMS-, Telegram-, Messenger-, Instagram- és TikTok-üzeneteket egyetlen REST-végponton keresztül. Előre fizetett, kimenő üzenetenkénti díjazás, kézbesítési webhookokkal és tesztmóddal.

API-kulcs igénylése Dokumentáció megnyitása

Kezdőár: 0,0003 $; kimenő üzenetenként
Regisztrációkor: 100; ingyenes üzenet
Hűségidő: Nincs; előre fizetett, szerződés nélkül

curl https://api.omnimessage.co/v1/messages \
  -H "Authorization: Bearer om_live_..." \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: order-1042-shipped" \
  -d '{
    "channel": "ch_7Hq2mN5vB8cX1zL0pK3j",
    "to": "+971501234567",
    "type": "text",
    "text": { "body": "Your order #1042 has shipped." },
    "reference": "order-1042"
  }'

202 Accepted

{
  "id": "msg_2b1Xw9aQ3rT8yU0pL4kZ",
  "object": "message",
  "mode": "live",
  "channel_id": "ch_7Hq2mN5vB8cX1zL0pK3j",
  "channel_type": "whatsapp",
  "direction": "outbound",
  "to": "+971501234567",
  "from": "+971800123456",
  "type": "text",
  "content": {
    "text": { "body": "Your order #1042 has shipped." }
  },
  "status": "queued",
  "error": null,
  "reference": "order-1042",
  "metadata": {},
  "billing": {
    "source": "wallet",
    "amount_micros": 1000,
    "package_grant_id": null,
    "refunded": false
  },
  "created_at": "2026-10-05T09:30:00.000Z",
  "sent_at": null,
  "delivered_at": null,
  "read_at": null,
  "failed_at": null
}

Csatornatípusok7 egyetlen végpont mögött
Üzenettípusok9, a szövegtől az interaktív listákig
Kezdőár0,0003 $ kimenő üzenetenként
KéréskorlátKulcsonként 100 kérés másodpercenként
KötegméretKérésenként legfeljebb 100 üzenet
Webhook-újrapróbálkozások8, növekvő várakozással 30 másodperctől 24 óráig
Idempotenciaablak24 óra
TesztmódIngyenes, csatorna nélkül is működik
Sikertelen üzenetekAutomatikus visszatérítés
Bejövő üzenetekIngyenes

Csatornatípusok7 egyetlen végpont mögött
Üzenettípusok9, a szövegtől az interaktív listákig
Kezdőár0,0003 $ kimenő üzenetenként
KéréskorlátKulcsonként 100 kérés másodpercenként
KötegméretKérésenként legfeljebb 100 üzenet
Webhook-újrapróbálkozások8, növekvő várakozással 30 másodperctől 24 óráig
Idempotenciaablak24 óra
TesztmódIngyenes, csatorna nélkül is működik
Sikertelen üzenetekAutomatikus visszatérítés
Bejövő üzenetekIngyenes

Csatornák

Hét csatornatípus, egyetlen kérésformátum

Csatlakoztassa a már meglévő küldőit. Mindegyikből csatornaazonosító lesz, amelyet ugyanannak a végpontnak ad át, és mindegyik ugyanazokat az állapotokat jelzi vissza.

Csatornák összehasonlítása

Így működik

A regisztrációtól a kézbesített üzenetig négy lépésben

Nincs értékesítői hívás és nincs minimális vállalás. A fiók létrehozása után egy perccel már el is indíthatja első API-hívását tesztmódban.

01. lépés
Hozzon létre fiókot
Regisztráljon, erősítse meg e-mail-címét, és hozzon létre API-kulcsot a konzolban. A tesztkulcsok azonnal működnek, még mielőtt bármilyen csatornát csatlakoztatna.
02. lépés
Csatlakoztasson egy csatornát
WhatsApp-szám, oldal vagy üzleti fiók csatlakoztatásához jelentkezzen be a konzolban Facebookkal vagy TikTokkal. Telegram-botot vagy Twilio-számot a hitelesítő adataival adhat hozzá a konzolban vagy a POST /v1/channels hívással.
03. lépés
Küldjön egyetlen végponton keresztül
A POST /v1/messages egy csatornaazonosítót, egy címzettet és egy típusos tartalomobjektumot vár. A kérés formátuma minden csatornán ugyanaz.
04. lépés
Kövessen minden kézbesítést
Aláírt webhookok jelzik az elküldve, kézbesítve, elolvasva és sikertelen állapotot. Ugyanezek az előzmények a konzolban és a GET /v1/messages végponton is elérhetők.

Üzenettípusok

Amit elküld, azt látja a címzett

Minden üzenetnek van egy típusa és egy tartalomobjektuma a típus nevével megegyező kulcs alatt. Válasszon egyet, és a kérés törzse mellett megjelenik az üzenet, amelyet eredményez.

Minden üzenettípus

POST /v1/messages

{
  "channel": "ch_7Hq2mN5vB8cX1zL0pK3j",
  "to": "+971501234567",
  "type": "text",
  "text": {
    "body": "#1042 számú rendelését feladtuk. Itt követheti: https://example.com/t/1042",
    "preview_url": true
  },
  "reference": "order-1042"
}

Egyszerű szöveg, amelyet minden csatornatípus fogad. Állítsa be a preview_url mezőt, ha azt szeretné, hogy a csatorna megjelenítse a hivatkozás előnézetét.

CsatornákWhatsApp Business, SMS, SMS OTP, Telegram, Messenger, Instagram és TikTok

Konzol

Konzol mindahhoz, ami nem kód

Hozzon létre kulcsokat, csatlakoztasson csatornákat, keressen az üzenetnaplóban, küldje újra a webhook-kézbesítéseket, és kezelje a számlázást. Minden, ami a konzolban látható, az API-n keresztül is elérhető.

omnimessage.co/console

KonzolÁttekintésÜzenetekCsatornákAPI-kulcsokWebhookokHasználatSzámlázás

ÁttekintésÉlesTesztFeltöltés

Pénztárca egyenlege48,25 $Automatikus feltöltés bekapcsolva

Csomagkreditek81 2341 aktív csomag

Elküldve, elmúlt 30 nap18 766Kimenő üzenetek

Sikertelen és visszatérítve212Visszaírva

Kimenő üzenetek napontaElmúlt 30 nap

szept. 06.szept. 16.szept. 26.Ma

Ügyfélszolgálati vonalWhatsApp BusinessCsatlakoztatva

Riasztási botTelegramCsatlakoztatva

Belépési kódokSMS OTPCsatlakoztatva

Áttekintés. A pénztárca egyenlege, a fennmaradó csomagkreditek és az elmúlt 30 nap kimenő forgalma, fiókonként és módonként. Az oldalon látható képernyők mintaadatokkal készültek.

omnimessage.co/console/messages

Üzenetekhivatkozás, címzett vagy azonosító

CímzettCsatornaTípusÁllapotDíj

+971 50 123 4567WhatsApptemplateKézbesítve1 kredit

+971 55 987 6543SMS OTPtextKézbesítve1 kredit

584201337TelegrambuttonElolvasva1 kredit

+44 7700 900123WhatsAppattachmentsSikertelenVisszatérítve

+971 52 222 0101WhatsApplistElküldve1 kredit

+1 415 555 0132SMStextSorban áll1 kredit

+971 56 700 4410WhatsApptextElolvasva1 kredit

Üzenetnapló. Szűrjön csatornára, állapotra, címzettre vagy saját hivatkozására, és bármelyik üzenetet megnyitva megnézheti az állapotelőzményeit és a díját.

Számlázás. Töltse fel a pénztárcát, vásároljon csomagokat, állítson be automatikus feltöltést, és töltse le a nyugtákat. A csomagkrediteknél látható, mennyi maradt, és mikor jár le.

Árak

Fizessen üzenetenként, vagy vásároljon üzeneteket nagy tételben

Töltsön fel egy előre fizetett pénztárcát (a legkisebb feltöltés 10 $), és fizesse az egyes csatornák üzenetenkénti árát, vagy vásároljon üzenetkredit-csomagot a legdrágább csatornáin bonyolított nagyobb forgalomhoz.

Részletes árak

10 E üzenet

8 $

0,0008 $ üzenetenként

10 000 kimenő üzenet
A vásárlástól számítva 3 hónapig érvényes
Minden csatornatípuson érvényes

Kezdés ezzel: 10 E

100 E üzenet

Kiemelt

60 $

0,0006 $ üzenetenként

100 000 kimenő üzenet
A vásárlástól számítva 6 hónapig érvényes
Minden csatornatípuson érvényes

Kezdés ezzel: 100 E

1 M üzenet

400 $

0,0004 $ üzenetenként

1 000 000 kimenő üzenet
A vásárlástól számítva 12 hónapig érvényes
Minden csatornatípuson érvényes

Kezdés ezzel: 1 M

Használatalapú fizetés

Használatalapú ár kimenő üzenetenként, csatornatípusok szerint, amerikai dollárban
Csatorna	Üzenetenként
WhatsApp Business	0,001 $
Telegram	0,0003 $
SMS	0,0005 $
SMS OTP	0,0005 $
Messenger	0,0005 $
Instagram	0,0005 $
TikTok	0,0005 $

Mit tartalmaz az ár?

DíjkötelesAz API által elfogadott kimenő üzenetek, az elfogadás pillanatában.
IngyenesA bejövő üzenetek, a tesztmódú üzenetek, a webhookok és a konzol.
VisszatérítjükMinden sikertelenül záruló üzenet díját, abba a csomagba vagy pénztárcába, amelyből levontuk.
Külön fizetendőAzok a díjak, amelyeket a Meta, a mobilszolgáltatók vagy más szolgáltatók magáért a csatornáért számítanak fel.

Fejlesztői élmény

Egyszer integrálja, utána nem kell hozzányúlnia

Aláírt webhookok, biztonságos újrapróbálkozás, az éles környezettel azonosan viselkedő sandbox és olyan hibák, amelyekre a kódjában el tud ágazni.

API-referencia

Ellenőrizhető webhookok

Minden kézbesítést HMAC-SHA256 aláírással látunk el, amely az időbélyegre és a nyers törzsre számítva az OmniMessage-Signature fejlécben érkezik. Válaszoljon bármilyen 2xx kóddal 10 másodpercen belül. A sikertelen kézbesítéseket nyolcszor próbáljuk újra, 30 másodperctől 24 óráig növekvő várakozással.

verify-signature.js

import { createHmac, timingSafeEqual } from 'node:crypto';

// header is "t=<unix seconds>,v1=<hex hmac-sha256>"
export function verifySignature(rawBody, header, secret) {
  const parts = header.split(',').map((part) => part.split('='));
  const { t, v1 = '' } = Object.fromEntries(parts);

  const expected = createHmac('sha256', secret)
    .update(`${t}.${rawBody}`)
    .digest('hex');

  const fresh = Math.abs(Date.now() / 1000 - Number(t)) < 300;
  const matches =
    v1.length === expected.length &&
    timingSafeEqual(Buffer.from(v1), Buffer.from(expected));

  return fresh && matches;
}

message.delivered esemény

{
  "id": "evt_8Kd2pQ7wN4xB1zR6mT3c",
  "object": "event",
  "type": "message.delivered",
  "mode": "live",
  "created_at": "2026-10-05T09:30:02.900Z",
  "data": {
    "object": {
      "id": "msg_2b1Xw9aQ3rT8yU0pL4kZ",
      "object": "message",
      "status": "delivered",
      "reference": "order-1042",
      "delivered_at": "2026-10-05T09:30:02.871Z"
    }
  }
}

Tesztmód, amely semmibe sem kerül

A tesztkulcsok beépített sandbox csatornákat használnak, így semmit sem kell csatlakoztatni. A szimulált kimenetelt a címzett utolsó számjegyei döntik el, a webhookjai pedig ugyanúgy futnak le, mint éles környezetben.

Sandbox kérés, a végállapota: elolvasva

curl https://api.omnimessage.co/v1/messages \
  -H "Authorization: Bearer om_test_..." \
  -H "Content-Type: application/json" \
  -d '{
    "channel": "ch_test_whatsapp",
    "to": "+971501230002",
    "type": "text",
    "text": { "body": "Hello from the sandbox" }
  }'

Hibák típussal és kóddal

Minden nem 2xx válasz törzse azonos felépítésű: a type a hiba osztályát adja meg, a stabil code alapján elágazhat, a param a hibás paramétert nevezi meg, ha van ilyen, a request_id pedig az ügyfélszolgálatnak szól.

402 Payment Required

{
  "error": {
    "type": "billing_error",
    "code": "insufficient_balance",
    "message": "Not enough wallet balance or package credits.",
    "request_id": "req_5Vn1cH8jL3qW6yD9sF2k",
    "doc_url": "https://omnimessage.co/docs/errors#insufficient_balance"
  }
}

Idempotens POST-kérések
Küldjön Idempotency-Key fejlécet, és a 24 órán belüli ismétlés a tárolt választ adja vissza Idempotent-Replayed: true fejléccel, kétszeri küldés és kétszeri terhelés nélkül.
Kiszámítható korlátok
Kulcsonként 100 kérés másodpercenként a POST /v1/messages végponton, máshol 20. Minden válasz tartalmazza a RateLimit-Remaining fejlécet, a 429-es válasz pedig a Retry-After fejlécet.
Kötegelt küldés
A POST /v1/messages/batch legfeljebb 100 üzenetet fogad. Minden elemet külön fogadunk el, utasítunk el és számlázunk, a 207-es válasz pedig index szerint számol be róluk.
Hatókörökre szűkített kulcsok
Minden kulcsnak csak azokat a hatóköröket adja meg, amelyekre szüksége van, például messages:write vagy billing:read, és korlátozza IP-engedélyezőlistára.

Kérdések

Mielőtt integrálná

Itt a rövid válaszok. A hosszabbak a dokumentációban vannak.

Szükségem van saját WhatsApp-számra, botra vagy SMS-számra?

Igen. Az OmniMessage olyan átjáró, amelyhez saját csatornáit csatlakoztatja: saját WhatsApp Cloud API-számát, Telegram-botját, Twilio-számát vagy közösségimédia-fiókját kapcsolja hozzá, és az továbbra is az Öné marad. A csatornák oldalán megtalálja, mire van szükség az egyes típusokhoz.

Pontosan miért kell fizetnem?

Minden kimenő üzenetért, amelyet az API elfogad, egyszer fizet: egy csomagkreditet, ha van, egyébként a csatornatípus üzenetenkénti árát a pénztárcájából. A bejövő és a tesztmódú üzenetek ingyenesek, a sikertelenül záruló üzenet díját pedig automatikusan visszatérítjük.

Az ár tartalmazza a Meta, a mobilszolgáltatók vagy más szolgáltatók díjait?

Nem. Az átjárói díj az API-t, a kézbesítés követését, a webhookokat és a konzolt fedezi. Azok a díjak, amelyeket a Meta, a Twilio vagy más szolgáltató magáért a csatornáért számít fel, Ön és az adott szolgáltató között maradnak.

Hogyan tesztelhetek valódi üzenetek küldése nélkül?

Használjon om_test_ előtagú kulcsot. Minden fiókhoz típusonként tartozik egy sandbox csatorna, például ch_test_whatsapp. Semmit sem kézbesítünk és semmit sem számlázunk, az állapotok pedig szimuláltak: a 0000 végű címzettnél az üzenet sikertelen lesz, a 0001 végűnél elküldve állapotban marad, a 0002 végűnél el is olvassák, minden más esetben pedig körülbelül két másodpercen belül kézbesítve lesz.

Mi történik, ha elfogy az egyenlegem?

Az API 402 insufficient_balance választ ad, és semmi sem kerül a sorba, így utólag soha nem keletkezik tartozása. Feliratkozhat a balance.low eseményre, vagy bekapcsolhatja az automatikus feltöltést, amely feltölti a pénztárcát, ha az egyenleg az Ön által megadott küszöb alá csökken.

Szükségem van SDK-ra?

Nem. Az API HTTPS feletti JSON, bearer hitelesítéssel, így bármilyen HTTP-kliens megfelel. A dokumentációban cURL-, Node-, Python- és PHP-példákat talál.

Küldje el első üzenetét tesztmódban még ma

Hozzon létre fiókot, másolja ki a tesztkulcsot, és hívja meg az API-t, mielőtt egyetlen csatornát is csatlakoztatna. Minden új fiók 100 ingyenes üzenettel indul.

API-kulcs igénylése Dokumentáció megnyitása

Egyetlen API minden üzenetküldő csatornához

Hét csatornatípus, egyetlen kérésformátum

A regisztrációtól a kézbesített üzenetig négy lépésben

Hozzon létre fiókot

Csatlakoztasson egy csatornát

Küldjön egyetlen végponton keresztül

Kövessen minden kézbesítést