Mga Mensahe sa SMS

Magpadala ng mga karaniwang text message gamit ang SMSBAT API. Ang SMS ay ang pinaka-unibersal na channel ng pagmemensahe na may pinakamataas na rate ng paghahatid sa lahat ng mga mobile device.

Pangkalahatang-ideya

Ang SMS (Short Message Service) ay mainam para sa:

Mga abiso na kritikal sa oras
Fallback para sa mga mensahe ng Viber/RCS
Pag-abot sa mga user na walang mga smartphone
Universal compatibility sa lahat ng mga mobile network
Mataas na rate ng paghahatid (95%+)

Pangunahing Mensahe sa SMS

Kahilingan

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

Mga Parameter

Parameter	Uri	Kinakailangan	Paglalarawan
`mula sa`	string	Oo	Alphanumeric sender ID (hanggang 11 character)
`sa`	string	Oo	Numero ng telepono ng tatanggap sa format na E.164
`uri`	string	Oo	Itakda sa `"sms"`
`teksto`	string	Oo	Nilalaman ng mensahe
`customerMessageId`	string	Hindi	Ang iyong panloob na tracking ID
`ttl`	integer	Hindi	Time-to-live sa ilang segundo

Mga halimbawa

Simpleng SMS

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

SMS na may Customer ID

{
  "messages": [{
    "from": "YourStore",
    "to": "+380XXXXXXXXX",
    "type": "sms",
    "text": "Your order #12345 has been shipped.",
    "customerMessageId": "order-12345-notification"
  }]
}

SMS na may TTL

{
  "messages": [{
    "from": "YourApp",
    "to": "+380XXXXXXXXX",
    "type": "sms",
    "text": "Your verification code is: 123456",
    "ttl": 300
  }]
}

Pag-encode ng Character

GSM 7-bit Encoding

Karaniwang alpabeto ng GSM (160 character bawat SMS):

A-Z a-z 0-9
@ £ $ ¥ è é ù ì ò Ç Ø ø Å å
Δ _ Φ Γ Λ Ω Π Ψ Σ Θ Ξ
! " # % & ' ( ) * + , - . / : ; < = > ?

Mga Pinahabang GSM na Character

Ang mga character na ito ay binibilang bilang 2 character:

| ^ € { } [ ] ~ \

Unicode (UCS-2) Encoding

Ang mga mensaheng may mga espesyal na character ay gumagamit ng Unicode encoding (70 character bawat SMS):

Emoji: 😀 🎉 ❤️
Cyrillic: А Б В Г Д Е Ж
Mga espesyal na simbolo: ✓ ✗ ★ ♥

Haba ng Mensahe

Isang SMS

GSM 7-bit: 160 character
Unicode: 70 character

Maramihang bahagi na SMS

Kapag lumampas ang iyong mensahe sa limitasyon, nahahati ito sa maraming bahagi:

GSM 7-bit: 153 character bawat bahagi
Unicode: 67 character bawat bahagi

Halimbawa

{
  "messages": [{
    "from": "YourBrand",
    "to": "+380XXXXXXXXX",
    "type": "sms",
    "text": "This is a very long message that will be split into multiple parts. Each part will be delivered separately but will appear as a single message on the recipient's phone. The system automatically handles the splitting and reassembly."
  }]
}

Ang mensaheng ito (201 character) ay hahatiin sa 2 bahagi.

Tugon

Tagumpay na Tugon

{
  "messagelistId": 123456,
  "messages": [
    {
      "messageId": "abc123def456",
      "status": "accepted",
      "parts": 2,
      "customerMessageId": "order-12345-notification",
      "to": "+380XXXXXXXXX"
    }
  ]
}

Mga Patlang ng Tugon

Patlang	Paglalarawan
`messageId`	Natatanging identifier para sa pagsubaybay
`status`	Status ng mensahe (`tinanggap`, `tinanggihan`)
`mga bahagi`	Bilang ng mga bahagi ng SMS
`sa`	Numero ng telepono ng tatanggap

Sender ID

Alphanumeric Sender

Gamitin ang iyong brand name bilang nagpadala (hanggang 11 character):

{
  "from": "YourBrand",
  "to": "+380XXXXXXXXX",
  "type": "sms",
  "text": "Hello from YourBrand!"
}

Mga Paghihigpit:

Maximum na 11 character
Mga titik at numero lamang
Walang mga puwang o mga espesyal na character
Hindi makakasagot ang tatanggap sa mga alphanumeric na nagpadala

Numeric Sender

Gumamit ng numero ng telepono bilang nagpadala (para sa two-way na SMS):

{
  "from": "+380123456789",
  "to": "+380XXXXXXXXX",
  "type": "sms",
  "text": "Hello! You can reply to this message."
}

Mga Kaso ng Paggamit

Pag-verify ng OTP

{
  "from": "YourApp",
  "to": "+380XXXXXXXXX",
  "type": "sms",
  "text": "Your verification code is: 123456. Valid for 5 minutes.",
  "ttl": 300
}

Mga Notification ng Order

{
  "from": "YourStore",
  "to": "+380XXXXXXXXX",
  "type": "sms",
  "text": "Your order #12345 has been delivered. Thank you for shopping with us!"
}

Mga Paalala sa Paghirang

{
  "from": "YourClinic",
  "to": "+380XXXXXXXXX",
  "type": "sms",
  "text": "Reminder: Your appointment is scheduled for tomorrow at 2:00 PM."
}

Mga Kumpirmasyon sa Pagbabayad

{
  "from": "YourBank",
  "to": "+380XXXXXXXXX",
  "type": "sms",
  "text": "Payment of 100 USD to Merchant ABC was successful. Transaction ID: 789xyz"
}

Pinakamahuhusay na Kasanayan

Nilalaman ng Mensahe

✅ Panatilihing maikli at malinaw ang mga mensahe
✅ Isama ang pagkakakilanlan ng nagpadala
✅ Magdagdag ng call-to-action kung kinakailangan
✅ Gumamit ng wastong grammar at spelling
❌ Iwasan ang labis na bantas!!!
❌ Huwag gamitin ang lahat ng CAPS
❌ Iwasan ang mga URL shortener na mukhang kahina-hinala

Paggamit ng Character

Suriin ang bilang ng character bago ipadala
Magkaroon ng kamalayan sa mga pinahabang GSM na character (bilang 2)
Subukan gamit ang mga espesyal na character bago maramihang pagpapadala
Isaalang-alang ang paggamit ng GSM encoding para sa mas mahahabang mensahe

Mga Numero ng Telepono

Palaging gumamit ng E.164 na format: +380XXXXXXXXX
I-validate ang mga numero ng telepono bago ipadala
Alisin ang mga di-wastong numero sa iyong listahan
Panatilihing na-update ang iyong listahan ng contact

Timing

Igalang ang mga lokal na time zone
Iwasang magpadala sa gabi (10 PM - 8 AM)
Isaalang-alang ang mga oras ng negosyo para sa mga komersyal na mensahe
Itakda ang naaangkop na TTL para sa mga mensaheng sensitibo sa oras

Pagsunod

Kumuha ng pahintulot bago magpadala ng mga mensahe sa marketing
Isama ang mga tagubilin sa pag-opt out para sa pang-promosyon na SMS
Sundin ang mga lokal na regulasyon (GDPR, atbp.)
Igalang ang mga listahan ng "Huwag Istorbohin."

Error sa Paghawak

Mga Karaniwang Error

Error	Dahilan	Solusyon
`INVALID_RECIPIENT`	Maling format ng telepono	Gamitin ang format na E.164
`INVALID_SENDER`	Di-wastong ID ng nagpadala	Tingnan ang mga panuntunan sa ID ng nagpadala
`MESSAGE_TOO_LONG`	Lampas sa max na haba	Hatiin o paikliin ang mensahe
`INVALID_ENCODING`	Mga hindi sinusuportahang character	Gumamit ng GSM o Unicode

Pag-optimize ng Gastos

Bawasan ang Mga Bahagi ng Mensahe

Panatilihin ang mga mensahe sa ilalim ng 160 character (GSM) o 70 (Unicode)
Iwasan ang mga espesyal na character na nagpapalitaw ng Unicode
Gumamit ng mga pagdadaglat kung naaangkop
Alisin ang mga hindi kinakailangang espasyo

Halimbawang Pag-optimize

❌ Noon (171 character, 2 SMS):

Hello John! Your order #12345 has been successfully delivered to your address at 123 Main Street. Thank you for shopping with us! We hope to see you again soon.

✅ Pagkatapos (156 character, 1 SMS):

Hi John! Order #12345 delivered to 123 Main St. Thanks for shopping with us! Visit example.com/order/12345 for details.

Bultuhang Pagpapadala

Magpadala ng maraming mensahe sa isang kahilingan:

{
  "messages": [
    {
      "from": "YourBrand",
      "to": "+380111111111",
      "type": "sms",
      "text": "Message 1"
    },
    {
      "from": "YourBrand",
      "to": "+380222222222",
      "type": "sms",
      "text": "Message 2"
    },
    {
      "from": "YourBrand",
      "to": "+380333333333",
      "type": "sms",
      "text": "Message 3"
    }
  ]
}

Mga Susunod na Hakbang

Viber Messages - Rich media messaging
RCS Messages - Rich Communication Services
Suriin ang Katayuan - Subaybayan ang katayuan ng paghahatid
Mga Diskarte sa Fallback - I-configure ang mga fallback