Help Center ކެސްކޭޑް އެޕީއައި

ކެސްކޭޑް އެޕީއައި

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

ބޭސް ޔޫއާރްއެލް

https://restapi.smsbat.com

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

ކެސްކޭޑް އެޕީއައި އިން ބޭނުންކުރަނީ ހެޑަރ ބެސްޓް އޮތެންޓިކޭޝަން އާއި އެކު ތިން އޮތެންޓިކޭޝަން ހެޑަރ އެވެ:

ގޮތް 1: އެސްއެމްއެސްބީއޭޓީ އެޕީއައި ކީ

curl -X POST https://restapi.smsbat.com/api/CascadeMessage/send_message/async \
  -H "X-Authorization-Key: your-smsbat-api-key" \
  -H "Content-Type: application/json" \
  -d @request.json

ގޮތް 2: ވައިބަރ ބޮޓް ޓޯކަން

curl -X POST https://restapi.smsbat.com/api/CascadeMessage/send_message/async \
  -H "X-Viber-Auth-Token: your-viber-bot-token" \
  -H "Content-Type: application/json" \
  -d @request.json

ގޮތް 3: ޓެލެގްރާމް ބޮޓް ކީ

curl -X POST https://restapi.smsbat.com/api/CascadeMessage/send_message/async \
  -H "X-Tg-Bot-Key: your-telegram-bot-key" \
  -H "Content-Type: application/json" \
  -d @request.json

ލިބެންހުރި އެންޑްޕޮއިންޓްސް

ގޮތްއެންޑްޕޮއިންޓްތަފްސީލު
ޕޯސްޓް/api/CascadeMessage/ފޮނުވުން_މެސެޖް/އެސިންކްއާންމު ކެސްކޭޑް މެސެޖް ފޮނުވުން
ޕޯސްޓް/api/CascadeMessage/send_message/tg-viber/asyncޓެލެގްރާމް އަށް އިސްކަންދޭ ކެސްކޭޑް

އެކަން ކުރާ ގޮތް

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

Telegram Bot → Viber Bot → Viber Business → RCS → SMS

މި މެސެޖު ފޯރުކޮށްދޭނީ ފުރަތަމަ ލިބޭ ޗެނަލް މެދުވެރިކޮށް ކަމަށާއި، ޑެލިވަރީ ފޭލްވެއްޖެނަމަ ދެން އޮންނަ ޗެނަލަށް އޮޓޮމެޓިކުން ފޯލްބެކް ކުރެވޭނެ ކަމަށެވެ.

މުހިއްމު ސިފަތައް

މަލްޓި ޗެނަލް ޑެލިވަރީ

އެއް މެސެޖެއް ފޮނުވުން، ކޮންމެ ޕްލެޓްފޯމެއްގައި ވެސް ޔޫޒަރުންނާ ހަމައަށް ވާސިލްވުން:

  • ޓެލެގްރާމް ބޮޓް
  • ވައިބަރ ބޮޓް
  • ވައިބަރ ބިޒްނަސް މެސެޖްސް
  • އާރުސީއެސް (ރިޗް ކޮމިއުނިކޭޝަން ސާވިސަސް)
  • އެސްއެމްއެސް

ވެރިއޭބަލް ބަދަލުކުރުން

ވެރިއޭބަލް ޕްލޭސްހޯލްޑަރސް އާއި އެކު ޑައިނަމިކް ކޮންޓެންޓް ބޭނުންކުރުން:

  • %name=id% - ޓެކްސްޓް ވެރިއޭބަލްސް
  • %url=id% - ޔޫއާރްއެލް ވެރިއޭބަލްސް
  • %short_url=id% - ކުރުކޮށްފައިވާ ޔޫއާރްއެލް ވެރިއޭބަލްސް

މެސެޖް ޝެޑިއުލް ކުރުން

ކުރިއަށް އޮތްތަނުގައި ޑެލިވަރީ ކުރުމަށް މެސެޖުތައް ޝެޑިއުލްކުރުން:

{
  "scheduledTime": "2025-01-24T12:00:00Z"
}

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

މެސެޖުތަކަށް މުއްދަތު ހަމަވާ ވަގުތު ކަނޑައެޅުން:

{
  "ttl": 3600
}

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

ކެސްކޭޑް އެޕީއައި ސަޕޯޓް ކުރަނީ:

  • ޓްރާންސެކްޝަނަލް - އޯޑަރ ކޮންފަރމްސް، ނޮޓިފިކޭޝަންސް
  • ޕްރޮމޯ - މާކެޓިންގ އަދި ޕްރޮމޯޝަނަލް މެސެޖުތައް
  • ވައިބަރ ސާރވޭސް - އިންޓަރެކްޓިވް ސާރވޭސް
  • ފްލެޝް ކޯލްސް - ފޯނުން ވެރިފިކޭޝަން

ޖަވާބު ފޯމެޓް

ކާމިޔާބު ޖަވާބުތައް އަނބުރާ އަންނަނީ:

[
  {
    "messageId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "trackinId": "tracking-string-id"
  }
]
  • messageId - މެސެޖް ދެނެގަތުމަށް ބޭނުންކުރާ ޖީއައިޑީ
  • trackinId - ޑެލިވަރީ ސްޓޭޓަސް ޓްރެކް ކުރުމަށް ބޭނުންކުރާ ސްޓްރިންގް

އަވަހަށް ފެށުން

  1. މެސެޖްތައް ފޮނުވުން - ކެސްކޭޑް މެސެޖުތައް ފޮނުވަން ފެށުން
  2. މެސެޖް ވެރިއޭބަލްސް - ޑައިނަމިކް ކޮންޓެންޓް ބޭނުންކުރުން
  3. މެސެޖް ޓައިޕްސް - މެސެޖް ޓައިޕްސް އެކްސްޕްލޯރ ކުރުން

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

curl -X POST https://restapi.smsbat.com/api/CascadeMessage/send_message/async \
  -H "X-Authorization-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "messages": [
      {
        "recipient": "380501234567",
        "text": "Hello %name=1%, your code is %url=2%!",
        "variables": [
          { "id": 1, "value": "User" },
          { "id": 2, "value": "7777" }
        ]
      }
    ]
  }'

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

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

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

ފައިދާތައް

ސިންގަލް އިންޓަގްރޭޝަން

ހުރިހާ މެސެޖިން ޗެނަލްތަކަށް އެއް އެޕީއައި އިންޓަގްރޭޝަން - ކޮންމެ ޕްލެޓްފޯމަކާ ވަކިން އިންޓަގްރޭޓް ކުރަން ނުޖެހެ އެވެ.

އޮޓޮމެޓިކް ރޫޓިންގ

ސްމާޓް ރޫޓިންގެ ސަބަބުން ކޮންމެ ރިސީވަރަކަށް ވެސް އެންމެ ރަނގަޅު ޗެނަލް މެދުވެރިކޮށް މެސެޖު ޑެލިވަރީ ކުރެވޭނެ އެވެ.

ކޮސްޓް އޮޕްޓިމައިޒޭޝަން

ކެސްކޭޑް އިން ފުރަތަމަ ޓްރައި ކުރަނީ އަގުހެޔޮ ޗެނަލްތަކެއް ކަމަށާއި، އޮޓޮމެޓިކުން އަނބުރާ އަގުބޮޑު އޮޕްޝަންތަކަށް ވެއްޓޭނީ ހަމައެކަނި ބޭނުންވާ ވަގުތުތަކުގަ އެވެ.

ޑެލިވަރީ ރޭޓް މަތިވުން

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

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