Help Center SMSBAT ރެސްޓްފުލް އެޕީއައި ގައިޑް

SMSBAT ރެސްޓްފުލް އެޕީއައި ގައިޑް

އެސްއެމްއެސްބީއޭޓީ ރެސްޓްފުލް އެޕީއައި އަށް ފުރިހަމަ ގައިޑް – ތިބާއަށް އެނގެން ޖެހޭ ހުރިހާ ކަމެއް.

އެންމެ ފަހުން އަޕްޑޭޓް ކޮށްފައިވަނީ: އޮގަސްޓް 29، 2025

އެސްއެމްއެސްބީއޭޓީ ރެސްޓްފުލް އެޕީއައި އިން އެކި މެސެޖް ވައްތަރުތައް ފޮނުވޭނެ: ވައިބަރ-ކެރޮސެލް، ވައިބަރ-ސާރވޭ، ވައިބަރ-ޕްރޮމޯ (އިމޭޖް، ވީޑިއޯ)، ވައިބަރ ބިޒްނަސް ޗެޓް، އޯޓީޕީ މެސެޖް (ވައިބަރ އޯޓީޕީ، ފްލެޝް ކޯލް)، އަދި އެތަކެތީގެ ފޯލްބެކް ވެރިއަންޓްސް.

ނޯޓް: މިއީ އައުޓްބައުންޑް މެސެޖިންގ އަށް ޔުނިފައިޑް އެޗްޓީޓީޕީ އެޕީއައި އެވެ. އިންބައުންޑް ބޮޓްތަކާ (ވައިބަރ ބޮޓް / ޓެލެގްރާމް ބޮޓް) އިންޓަގްރޭޝަންތައް ބޭނުންވާނަމަ ކެސްކޭޑް އެޕީއައި އަށް ރިއާޔަތް ކުރައްވާށެވެ.

1. ޕްރޮޓޮކޯލް

ޕްރޮޓޮކޯލް: އެޗްޓީޓީޕީއެސް
ރިކުއެސްޓް ބޮޑީ: މެސެޖްސް ގެ އެރޭއެއް ހިމެނޭ ޖޭއެސްއޯއެން އޮބްޖެކްޓް.
ގޮތްތައް:
- ޑޭޓާ ހޯދުމަށް GET (މެސެޖް ސްޓޭޓަސް، ބެލެންސް، ފަދަ)
- އެއްޗެހި އުފެއްދުމަށް POST (އެބަހީ، ބްރޯޑްކާސްޓް/ޑިސްޕެޗެއް އިސްނަގައިގެން)
- އެއްޗެހި ބަދަލުކުރުމަށް PATCH

2. ހުއްދަ ދިނުން

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

އެޗްޓީޓީޕީ ބޭސިކް އޮތެންޓިކޭޝަން (ލޮގިން އަދި ޕާސްވޯޑް ތިބާގެ ޑޭޝްބޯޑުން) އެވެ.
އެޕީއައި ޓޯކަން އެއް ހިމެނޭ ކަސްޓަމް އެޗްޓީޓީޕީ ހެޑަރ އެކްސް-އޮތޮރައިޒޭޝަން-ކީ.
އެޕީއައި ޓޯކަން ހިފަހައްޓާފައިވާ އެޗްޓީޓީޕީ ބޭސިކް އޮތެންޓިކޭޝަން ޕާސްވޯޑް ފީލްޑް (ލޮގިންގެ ގޮތުގައި @ ފާސްކުރުން).

އޭޕީއައި ޓޯކަން ޑޭޝްބޯޑުގައި ޔޫޒަރ ޕްރޮފައިލް ގެ ދަށުން ޖެނެރޭޓް ކުރެވޭނެއެވެ.

ރިކުއެސްޓް މިސާލުތައް

އަސާސީ އޮތު އާއި އެކު:

curl -H "Content-Type: application/json" \
  -X POST -d @/path/to/data.json https://api.smsbat.com/bat/messagelist \
  --user user:password

އެކްސް-އޮތޮރައިޒޭޝަން-ކީ އާއެކު:

curl -H "X-Authorization-Key: <token>" \
  -H "Content-Type: application/json" \
  -X POST -d @/path/to/data.json https://api.smsbat.com/bat/messagelist

3. މެސެޖުތައް ފޮނުވުން

އެސްއެމްއެސްބީއޭޓީ ޕްލެޓްފޯމްގައި ކޮންމެ މެސެޖް ޑިސްޕެޗެއް (އެއް މެސެޖެއް ވެސް) ބެލެވެނީ “ބްރޯޑްކާސްޓް” (މެސެޖެލިސްޓް) އެއްގެ ގޮތުގައެވެ.

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

ގޮތް: ޕޯސްޓް
ޔޫއާރްއެލް: https://api.smsbat.com/bat/messagelist
ހެޑަރސް: ކޮންޓެންޓް-ޓައިޕް: އެޕްލިކޭޝަން/ޖޭއެސްއޯއެން

އަސާސީ ޕޭލޯޑް ސްޓްރަކްޗަރ:

{
  "messages": [
    {
      "from": "ALPHANAME",
      "to": "380936670003",
      "text": "Check out our new products!",
      "type": "viber_carousel",
      "ttl": 300,
      "messageData": { ... }
    }
  ]
}

ކޮންމެ މެސެޖް އޮބްޖެކްޓަކަށް ބޭނުންވާ ފީލްޑްތައް:

from: ވެރިފައިޑް ސެންޑަރ އަލްފާ-ނަން.
to: ލިބޭ ފަރާތުގެ ފޯނު ނަންބަރު (E.164 ފޯމެޓް) އެވެ.
type: މެސެޖް ޓައިޕް enum.
text: މެސެޖުގެ މައިގަނޑު ޓެކްސްޓް (ވައްތަރަށް ޓެކްސްޓް ބޭނުން ނުވާނަމަ އިޚްތިޔާރީ) އެވެ.

ސަޕޯޓް ކުރެވޭ ވައްތަރު އަގުތައް:

އެސްއެމްއެސް
ވައިބަރ_ސަރވިސް (ނުވަތަ ވައިބަރ_ޓްރާންސް)
ވައިބަރ_ޕްރޮމޯ
ވައިބަރ_ކެރޮސެލް
ވައިބަރ_ސަރވޭ
ވައިބަރ_އޯޓީޕީ
ވައިބަރ_ސެޝަން
ފްލެޝްކޯލް_ކޯލްބެކް
ފްލެޝްކޯލް

އިޚްތިޔާރީ އާންމު ދާއިރާތައް:

customerMessageId: އަމިއްލަ ސިސްޓަމްގެ ތެރޭގައި ހުންނަ ސްޓްރިންގް އައިޑީ (ކޯލްބެކްސް ޓްރެކް ކުރުމަށް ބޭނުންކުރާ) އެވެ. މެސެޖަކަށް ޔުނިކް ވާންޖެހޭނެއެވެ.
dtSend: ISO8601 ކުރިއަށް އޮތްތަނުގައި ފޮނުވުމަށް ހަމަޖެހިފައިވާ ތާރީޚް/ވަގުތު.
dtExpire: ISO8601 ޑެލިވަރީ ކުރުމުގެ ސުންގަޑިގެ ތާރީޚު/ގަޑި.
ttl: ޓައިމް-ޓު-ލައިވް ސިކުންތުކޮޅެއްގެ ތެރޭގައި. (dtExpire ފޯރުކޮށްދީފައި ނުވާނަމަ، އެޕީއައި އިން ޑިފޯލްޓް މެޕިންގ ޙިސާބުކުރަނީ ޓައިޕް އިންނެވެ).

ޑިފޯލްޓް ޓީޓީއެލްސް (ސިކުންތު):

އެސްއެމްއެސް - 86400 (24ގަޑިއިރު)
ވައިބަރ_ޓްރާންސް / ވައިބަރ_ސަރވިސް - 345600
ވައިބަރ_ޕްރޮމޯ - 604800
ވައިބަރ_ސެޝަން - 604800

4. ފޯލްބެކް ރޫޓިންގ (ކެސްކޭޑިންގ) .

ޕްރައިމަރީ ޗެނަލް ފޭލްވެއްޖެނަމަ ނުވަތަ މުއްދަތު ހަމަވެއްޖެނަމަ މެސެޖު ޑެލިވަރީ ކުރެވޭނެކަން ޔަގީންކުރުމަށް ފޯލްބެކް ކިއުއެއް ކަނޑައެޅިދާނެއެވެ.

{
  "messages": [
    {
      "from": "ALPHANAME",
      "to": "380500505051",
      "text": "test message",
      "type": "viber_service",
      "ttl": 60,
      "fallbacks": [
        {
          "from": "ALPHANAME",
          "to": "380936670003",
          "text": "test sms fallback message2",
          "type": "sms"
        }
      ]
    }
  ]
}

ފޯލްބެކްސް ޓްރިގަރ ކުރެވެނީ ޕްރޮވައިޑަރ އިން މައިގަނޑު މެސެޖު ރިޖެކްޓް ކުރުމުން ނުވަތަ ޓީޓީއެލް މުއްދަތު ހަމަވުމުންނެވެ.

5. މެސެޖް ޓައިޕްސް & messageData ގެ އޯވަރވިއު

ކޮމްޕްލެކްސް މެސެޖް ޓައިޕްތަކުގައި messageData ޕްރޮޕަޓީއަށް އިންޖެކްޓް ކުރެވޭ އިތުރު ކޮންފިގްރޭޝަންތައް ބޭނުންވެއެވެ.

5.1 ވައިބަރ ޕްރޮމޯ (`viber_promo`)

އިމޭޖް އޮންލީ

"messageData":{
  "img":"https://domain.com/image.png"
}

ޓެކްސްޓް + ބަޓަން

"messageData":{
  "buttonText":"Save Now",
  "buttonAction":"https://help.smsbat.com"
}

އިމޭޖް + ޓެކްސްޓް + ބަޓަން img، buttonText، އަދި buttonAction އެއްކޮށްލައެވެ.

ވީޑިއޯ ޕޭލޯޑް:

"messageData":{
  "video": "https://domain.com/test.mp4",
  "thumbnail": "https://domain.com/carusel.png",
  "fileSize": 12000000,
  "duration": 30
}

(ވީޑިއޯ ޕްރޮޕަޓީސް buttonText އަދި buttonAction އާއެކު ވެސް ގުޅުވައިލެވޭނެ).

5.2 ވައިބަރ ޓްރާންސެކްޝަނަލް / ސާވިސް (`viber_trans`, `viber_service`)

އެޓޭޗްކޮށްފައިވާ ފައިލްއެއް ހިމެނޭ އެޕްރޫވް ކުރެވިފައިވާ ޓެމްޕްލޭޓެއް އޮތްނަމަ:

"messageData": {
  "fileUrl": "https://domain.com/receipt.pdf",
  "fileName": "Receipt.pdf",
  "fileType": "pdf"
}

5.3 ވައިބަރ ކެރޮސެލް (`viber_carousel`)

messageData ގެ ތެރޭގައި carousel.items އެރޭއެއް ބޭނުންވެއެވެ.

ލިމިޓެޝަންސް:

ތަކެތީގެ ދިގުމިން: 2 އާއި 5 އާއި ދެމެދުގެ ތަކެތި
ސުރުޚީ: 2 އިން 38 އަކުރު
imageUrl: ޖޭޕީއީޖީ/ޕީއެންޖީ ރެކޮމެންޑް ކުރެވިފައިވާ ސައިޒް 215x185

"messageData": {
  "carousel": {
    "items": [
      {
        "title": "50% Off Shoes!",
        "imageUrl": "https://domain.com/image1.png",
        "primaryButton": { "label": "Shop", "actionUrl": "..." },
        "secondaryButton": { "label": "Details", "actionUrl": "..." }
      }
    ]
  }
}

5.4 ވައިބަރ ސާރވޭ / ލިސްޓް (`viber_survey`)

ޗެޓް ވިއު ގެ ތެރޭގައި އިންޓަރެކްޓިވް ޕޯލެއް އުފައްދައެވެ.

"messageData": {
  "survey": {
    "options": [
      "Excellent", "Good", "Normal", "Bad", "Terrible"
    ]
  }
}

މެސެޖުގެ ޓެކްސްޓް ޕްރޮޕަޓީ ސާރވޭ ޓައިޓަލްގެ ގޮތުގައި މަސައްކަތް ކުރެއެވެ (މެކްސް 85 ޗާރސް). 2 އާއި 5 އޮޕްޝަން އާއި ދެމެދުގެ އޮޕްޝަން ފާސް ކުރެވޭއިރު، ކޮންމެ އޮޕްޝަނެއްގައި މެކްސް 50 ޗާރސް ފާސް ކުރެވޭނެއެވެ.

5.5 ވައިބަރ އޯޓީޕީ (`viber_otp`)

ދުނިޔޭގެ ފެންވަރުގައި ޕްރީ ރަޖިސްޓްރީކޮށްފައިވާ ލޮކަލައިޒްޑް ވައިބަރ ޓެމްޕްލޭޓްތައް ބޭނުންކުރެއެވެ.

"messageData": {
  "templateId": "6c929cef-29b4-4349-bc9d-2a07bdbb6e43",
  "templateLang": "uk",
  "templateParams": {
    "pin": "3211",
    "business_platform_name": "SMSBAT",
    "code_validity_time": 7
  }
}

ޓެމްޕްލޭޓް ޕެރެމިޓަރސް (ޕިން، ބިޒްނަސް_ޕްލެޓްފޯމް_ނަން) އަކީ ހަރުކަށިކޮށް ކޭސް-ސެންސިޓިވް އެއްޗެކެވެ. އެޕީއައި އިން ސަޕޯޓް ކުރަނީ އެކި އައިއެސްއޯ ކޯޑް ލޭންގުއޭޖް ވެރިއަންޓްސް (EN, ES, RU, TR, UK, ފަދަ) އެވެ.

5.6 ފްލެޝް ކޯލް (`flashcoll`)

ޑައިލިންގ ނަންބަރުގެ އެންމެ ފަހު އަދަދުތައް (ޖެނެރޭޓް ކުރެވިފައިވާ ކޯޑް) ފޮނުވަންވާނީ ޓެކްސްޓް ޕެރެމިޓަރ މެދުވެރިކޮށެވެ. text ދޫކޮށްލައިފިނަމަ، ކޯޑް ރެންޑަމްކޮށް، އެޕީއައިގެ ސިންކްރޮނަސް 200 އޯކޭ ރެސްޕޮންސް ބޮޑީ (messages/text) އިން ނަގަންވާނެއެވެ.

{
  "from": "FLASHCALL",
  "to": "380500000000",
  "type": "flashcall",
  "text": "340"
}

Search Results