Help Center މެސެޖް ފޮނުވުން

މެސެޖް ފޮނުވުން

/bat/messagelist އެންޑްޕޮއިންޓް ބޭނުންކޮށްގެން އެސްއެމްއެސްބީއޭޓީ އެޕީއައި މެދުވެރިކޮށް މެސެޖުތައް ފޮނުވުން.

އެންޑްޕޮއިންޓް

POST /bat/messagelist

ރިކުއެސްޓް ސްޓްރަކްޗަރ

ރިކުއެސްޓް ބޮޑީ އަކީ މެސެޖް އޮބްޖެކްޓްތަކުގެ ޖޭއެސްއޯއެން އެރޭއެކެވެ:

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

ޕެރެމިޓަރސް

ބޭނުންވާ ޕެރެމިޓަރސް

ޕެރެމިޓަރވައްތަރުތަފްސީލު
އިންސްޓްރިންގްއަލްފާނިއުމެރިކް ސެންޑަރ އައިޑީ
އަށްސްޓްރިންގްލިބޭ ފަރާތުގެ ފޯނު ނަންބަރު އީ.164 ފޯމެޓުގައި (އެބަހީ، +380XXXXXXXXXX)
ވައްތަރުސްޓްރިންގްމެސެޖް ޓައިޕް: އެސްއެމްއެސް، ވައިބަރ_ޕްރޮމޯ، ވައިބަރ_ޓްރާންސް، ވައިބަރ_ކެރޮސެލް، ވައިބަރ_ސަރވޭ، ވައިބަރ_އޯޓީޕީ، އާރްސީއެސް، ފްލެޝްކޯލް
ޓެކްސްޓްސްޓްރިންގްމެސެޖް ކޮންޓެންޓް (ގިނަ ވައްތަރުތަކަށް ބޭނުންވާ، ބައެއް ވައްތަރުތަކަށް އިޚްތިޔާރީ)

އިޚްތިޔާރީ ޕެރެމިޓަރސް

ޕެރެމިޓަރވައްތަރުތަފްސީލު
ކަސްޓަމަރމެސެޖްއައިޑީސްޓްރިންގްޓްރެކިންގ އަށް ތިބާގެ އިންޓަރނަލް އައިޑެންޓިފައިޓަރ
ttlއިންޓިޖަރސިކުންތުކޮޅެއްގެ ތެރޭގައި ދިރިއުޅެން ޖެހޭ ވަގުތު
މެސެޖްޑޭޓާއެއްޗެއްވައްތަރަކަށް ޚާއްޞަ ކޮންފިގްރޭޝަން (މެސެޖް ވައްތަރަށް ބަލާފައި ތަފާތުވެއެވެ)

އޮތެންޓިކޭޝަން

އޮތެންޓިކޭޝަން ތިން ގޮތުގެ ތެރެއިން އެއް މެތޯޑެއް ހޮވާށެވެ:

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

ޖަވާބު

ކާމިޔާބީގެ ރައްދު

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

ޖަވާބުދާރީވުމުގެ ދާއިރާތައް

ދަނޑުވައްތަރުތަފްސީލު
މެސެޖެލިސްޓްއައިޑީއިންޓިޖަރމެސެޖް ލިސްޓަށް ޚާއްޞަ އައިޑެންޓިފައިޓަރ
މެސެޖްއައިޑީސްޓްރިންގްކޮންމެ މެސެޖަކަށް ޔުނިކް އައިޑެންޓިފައިޓަރ
ސްޓޭޓަސްސްޓްރިންގްމެސެޖް ސްޓޭޓަސް: އެކްސެޕްޓް، ރިޖެކްޓް، ފޭލް
ބައިތައްއިންޓިޖަރމެސެޖް ބައިތަކުގެ އަދަދު (އެސްއެމްއެސް އަށް)
ކަސްޓަމަރމެސެޖްއައިޑީސްޓްރިންގްތިބާގެ އެތެރޭގެ އައިޑެންޓިފައިޓަރ (ފޯރުކޮށްދީފައިވާނަމަ)
އަށްސްޓްރިންގްލިބޭ ފަރާތުގެ ފޯނު ނަންބަރު

މެސެޖް ވައްތަރުތައް

އެސްއެމްއެސް

ސާދާ ޓެކްސްޓް މެސެޖުތައް:

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

ވައިބަރ ޕްރޮމޯ

ރިޗް މީޑިއާ އާއި އެކު ޕްރޮމޯޝަނަލް މެސެޖުތައް:

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

ވައިބަރ ޓްރާންސެކްޝަނަލް

މުއާމަލާތުގެ ނޮޓިފިކޭޝަންތައް:

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

ވައިބަރ އޯޓީޕީ

އެއްފަހަރު ޕާސްވޯޑް ނޮޓިފިކޭޝަން ދިނުން:

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

އެރަރ ހެންޑްލިންގ

އެޗްޓީޓީޕީ ސްޓޭޓަސް ކޯޑްސް

ކޯޑްތަފްސީލު
200ރިކުއެސްޓް ކާމިޔާބު
400 ރުފިޔާނުބައި ރިކުއެސްޓް - ސައްހަ ނޫން ޕެރެމިޓަރުތައް
401 ރުފިޔާހުއްދަ ނެތި - ތަސްދީގުކުރުން ނާކާމިޔާބު
429މާ ގިނައިން ރިކުއެސްޓް - ރޭޓް ލިމިޓް ފަހަނައަޅައި ދިޔައީ
500 ރުފިޔާއެތެރޭގެ ސަރވަރ އެރަރ

އެރަރ ރެސްޕޮންސް

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

އެންމެ ރަނގަޅު އުސޫލުތައް

ފޯނު ނަންބަރު ފޯމެޓް

ފޯނު ނަންބަރުތަކަށް އަބަދުވެސް އީ.164 ފޯމެޓް ބޭނުންކުރުން:

  • ✅ ރަނގަޅު: +380XXXXXXXXX
  • ❌ ގޯސް: 380XXXXXXXXXX، 0XXXXXXXXXX

މެސެޖް ޓެކްސްޓް

  • އެސްއެމްއެސް 160 އަކުރުގެ ދަށުގައި ބެހެއްޓުމަކީ އެތައް ބައިތަކެއް ނުހިމެނޭނެ ގޮތަށް ބެހެއްޓުން
  • ބައިނަލްއަޤްވާމީ އަކުރުތަކަށް ޔޫޓީއެފް-8 އެންކޯޑިންގ ބޭނުންކުރުން
  • ބަލްކް ފޮނުވުމުގެ ކުރިން ޚާއްޞަ އަކުރުތައް ޓެސްޓްކުރުން

ޓީޓީއެލް (ޓައިމް-ޓު-ލައިވް)

  • ވަގުތަށް ނާޒުކު މެސެޖުތަކަށް އެކަށީގެންވާ ޓީޓީއެލް ސެޓްކުރުން
  • އޯޓީޕީ މެސެޖުތައް: 300-600 ސިކުންތު (5-10 މިނެޓް)
  • ޕްރޮމޯޝަނަލް މެސެޖުތައް: 3600-86400 ސިކުންތު (1-24 ގަޑިއިރު)

ކަސްޓަމަރ މެސެޖް އައިޑީ

  • ކޮންމެ މެސެޖަކަށް ޔުނިކް އައިޑެންޓިފައިޓަރސް ބޭނުންކުރުން
  • ޓްރެކިންގ އަދި ޑިބަގިންގ އަށް އެހީތެރިވެދެއެވެ
  • ތިމާގެ ސިސްޓަމްގެ ރެކޯޑްތަކާ ގުޅިގެން މަސައްކަތް ކުރުމަށް ބޭނުންތެރި

ރޭޓް ލިމިޓްސް

މިކަމާ ބެހޭ މައުލޫމާތު ހޯދުމަށް އެކައުންޓް މެނޭޖަރާ ގުޅާށެވެ:

  • ސިކުންތަކަށް މެސެޖުތައް
  • ދުވާލަކު މެސެޖުތައް ފޮނުވުން
  • އެއްފަހަރާ ގުޅުންތައް

ދެން އަޅަންޖެހޭ ފިޔަވަޅުތައް