I-skip tungo sa nilalaman

Magpadala ng Mensahe

Magpadala ng mga mensahe sa pamamagitan ng SMSBAT API gamit ang /bat/messagelist endpoint.

Endpoint

POST /bat/messagelist

Istraktura ng Kahilingan

Ang request body ay isang JSON array ng mga message object:

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

Mga Parameter

Mga Kinakailangang Parameter

Parameter Uri Paglalarawan
mula sa string Alphanumeric sender ID
sa string Numero ng telepono ng tatanggap sa format na E.164 (hal., +380XXXXXXXXX)
uri string Uri ng mensahe: sms, viber_promo, viber_trans, viber_carousel, viber_survey, viber_otp, rcs, flashcall
teksto string Nilalaman ng mensahe (kinakailangan para sa karamihan ng mga uri, opsyonal para sa ilan)

Mga Opsyonal na Parameter

Parameter Uri Paglalarawan
customerMessageId string Ang iyong panloob na identifier para sa pagsubaybay
ttl integer Time-to-live sa ilang segundo
messageData bagay Configuration na partikular sa uri (nag-iiba ayon sa uri ng mensahe)

Pagpapatotoo

Pumili ng isa sa tatlong paraan ng pagpapatunay:

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!"
    }]
  }'

Tugon

Tagumpay na Tugon

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

Mga Patlang ng Tugon

Patlang Uri Paglalarawan
messagelistId integer Natatanging identifier para sa listahan ng mensahe
messageId string Natatanging identifier para sa bawat mensahe
status string Status ng mensahe: tinanggap, tinanggihan, bigo
mga bahagi integer Bilang ng mga bahagi ng mensahe (para sa SMS)
customerMessageId string Ang iyong panloob na identifier (kung ibinigay)
sa string Numero ng telepono ng tatanggap

Mga Uri ng Mensahe

SMS

Mga simpleng text message:

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

Viber Promo

Mga mensaheng pang-promosyon sa rich media:

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

Transaksyonal sa Viber

Mga notification sa transaksyon:

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

Viber OTP

Isang beses na mga abiso sa password:

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

Error sa Paghawak

Mga HTTP Status Code

Code Paglalarawan
200 Matagumpay ang kahilingan
400 Masamang kahilingan - di-wastong mga parameter
401 Hindi awtorisado - nabigo ang pagpapatunay
429 Masyadong maraming kahilingan - lumampas sa limitasyon sa rate
500 Error sa panloob na server

Error na Tugon

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

Pinakamahuhusay na Kasanayan

Format ng Numero ng Telepono

Palaging gumamit ng E.164 na format para sa mga numero ng telepono:

  • ✅ Tama: +380XXXXXXXXX
  • ❌ Mali: 380XXXXXXXXX, 0XXXXXXXXX

Teksto ng Mensahe

  • Panatilihin ang SMS na wala pang 160 character upang maiwasan ang maraming bahagi
  • Gumamit ng UTF-8 encoding para sa mga internasyonal na character
  • Subukan ang mga espesyal na character bago maramihang pagpapadala

TTL (Time-to-Live)

  • Itakda ang naaangkop na TTL para sa mga mensaheng sensitibo sa oras
  • Mga mensahe ng OTP: 300-600 segundo (5-10 minuto)
  • Mga mensaheng pang-promosyon: 3600-86400 segundo (1-24 na oras)

Customer Message ID

  • Gumamit ng mga natatanging identifier para sa bawat mensahe
  • Tumutulong sa pagsubaybay at pag-debug
  • Kapaki-pakinabang para sa pag-uugnay sa mga talaan ng iyong system

Mga Limitasyon sa Rate

Makipag-ugnayan sa iyong account manager para sa impormasyon tungkol sa:

  • Mga mensahe bawat segundo
  • Mga mensahe bawat araw
  • Kasabay na mga koneksyon

Mga Susunod na Hakbang