Kihagyás

Üzenet küldése

Üzenetek küldése SMSBAT API-n keresztül a `/bat/messagelist' végpont használatával.

Végpont

POST /bat/messagelist

Kérelem szerkezete

A kérés törzse üzenetobjektumok JSON-tömbje:

{
  "messages": [
    {
      "from": "YourSender",
      "to": "+380XXXXXXXXX",
      "type": "sms",
      "text": "Your message text",
      "customerMessageId": "your-internal-id",
      "ttl": 3600
    }
  ]
}

Paraméterek

Kötelező paraméterek

Paraméter Típus Leírás
"tól" húr Alfanumerikus feladóazonosító
"hoz" húr A címzett telefonszáma E.164 formátumban (pl. +380XXXXXXXXX)
"típus" húr Üzenet típusa: "sms", "viber_promo", "viber_trans", "viber_carousel", "viber_survey", "viber_otp", "rcs", "flashcall"
"szöveg" húr Üzenettartalom (a legtöbb típushoz kötelező, bizonyos esetekben opcionális)

Választható paraméterek

Paraméter Típus Leírás
customerMessageId húr Az Ön belső azonosítója a követéshez
"ttl" egész Élettartam másodpercben
messageData tárgy Típusspecifikus konfiguráció (üzenettípusonként változik)

Hitelesítés

Válasszon egyet a három hitelesítési mód közül:

curl -X POST https://restapi.smsbat.com/bat/messagelist \
  -H "X-Authorization-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "messages": [{
      "from": "YourSender",
      "to": "+380XXXXXXXXX",
      "type": "sms",
      "text": "Hello from SMSBAT!"
    }]
  }'

curl -X POST https://restapi.smsbat.com/bat/messagelist \
  -u "username:password" \
  -H "Content-Type: application/json" \
  -d '{
    "messages": [{
      "from": "YourSender",
      "to": "+380XXXXXXXXX",
      "type": "sms",
      "text": "Hello from SMSBAT!"
    }]
  }'

curl -X POST https://restapi.smsbat.com/bat/messagelist \
  -u "@:your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "messages": [{
      "from": "YourSender",
      "to": "+380XXXXXXXXX",
      "type": "sms",
      "text": "Hello from SMSBAT!"
    }]
  }'

Válasz

Sikerreakció

{
  "messagelistId": 123456,
  "messages": [
    {
      "messageId": "abc123def456",
      "status": "accepted",
      "parts": 1,
      "customerMessageId": "your-internal-id",
      "to": "+380XXXXXXXXX"
    }
  ]
}

Válaszmezők

Mező Típus Leírás
messagelistId egész Az üzenetlista egyedi azonosítója
messageId húr Egyedi azonosító minden üzenethez
"állapot" húr Üzenet állapota: "elfogadva", "elutasítva", "sikertelen"
"alkatrészek" egész Üzenetrészek száma (SMS-hez)
customerMessageId húr Az Ön belső azonosítója (ha van)
"hoz" húr Címzett telefonszáma

Üzenettípusok

SMS

Egyszerű szöveges üzenetek:

{
  "from": "YourSender",
  "to": "+380XXXXXXXXX",
  "type": "sms",
  "text": "Your SMS message text"
}

Viber Promo

Promóciós üzenetek multimédiával:

{
  "from": "YourSender",
  "to": "+380XXXXXXXXX",
  "type": "viber_promo",
  "text": "Check out our new product!",
  "messageData": {
    "image": "https://example.com/image.jpg",
    "button": {
      "text": "View Product",
      "url": "https://example.com/product"
    }
  }
}

Viber Tranzakció

Tranzakciós értesítések:

{
  "from": "YourSender",
  "to": "+380XXXXXXXXX",
  "type": "viber_trans",
  "text": "Your order #12345 has been confirmed"
}

Viber OTP

Egyszeri jelszóértesítések:

{
  "from": "YourSender",
  "to": "+380XXXXXXXXX",
  "type": "viber_otp",
  "messageData": {
    "code": "123456",
    "validity": 300
  }
}

Hibakezelés

HTTP állapotkódok

Kód Leírás
200 Sikeres kérés
400 Hibás kérés – érvénytelen paraméterek
401 Jogosulatlan – a hitelesítés sikertelen
429 Túl sok kérés – a sebességkorlát túllépve
500 Belső szerverhiba

Hibareakció

{
  "error": {
    "code": "INVALID_RECIPIENT",
    "message": "Invalid phone number format"
  }
}

Bevált gyakorlatok

Telefonszám formátum

Mindig E.164 formátumot használjon a telefonszámokhoz:

  • ✅ Helyesen: +380XXXXXXXXX
  • ❌ Helytelen: "380XXXXXXXXX", "0XXXXXXXXX".

Üzenet szövege

  • A több rész elkerülése érdekében az SMS-t 160 karakternél rövidebb ideig tartsa
  • Használjon UTF-8 kódolást a nemzetközi karakterekhez
  • Tömeges küldés előtt tesztelje a speciális karaktereket

TTL (Time-to-Live)

  • Állítsa be a megfelelő TTL-t az időérzékeny üzenetekhez
  • OTP üzenetek: 300-600 másodperc (5-10 perc)
  • Promóciós üzenetek: 3600-86400 másodperc (1-24 óra)

Ügyfél üzenetazonosítója

  • Minden üzenethez egyedi azonosítót használjon
  • Segíti a nyomkövetést és a hibakeresést
  • Hasznos a rendszer rekordjaival való korrelációhoz

Díjkorlátok

Lépjen kapcsolatba fiókkezelőjével a következőkről:

  • Üzenetek másodpercenként
  • Üzenetek naponta
  • Egyidejű kapcsolatok

Következő lépések