Help Center Magpadala ng Mensahe

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:

=== “API Key Header”

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

=== “HTTP Basic Auth”

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

=== “API Key bilang Password”

```bash
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"
}

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

Viber Messages - Galugarin ang mga uri ng mensahe ng Viber
SMS Messages - Matuto pa tungkol sa SMS
Tingnan ang Katayuan - Subaybayan ang paghahatid ng mensahe

Search Results