ކެސްކޭޑް އެޕީއައި
ކެސްކޭޑް އެޕީއައިގެ ސަބަބުން އެއް ރިކުއެސްޓަކުން އެތައް ޕްލެޓްފޯމްތަކެއް ހުރަސްކޮށް މެސެޖު ފޮނުވުމުގެ ފުރުސަތު ލިބިގެންދާއިރު، އޮޓޮމެޓިކުން ޓެލެގްރާމް ބޮޓް، ވައިބަރ ބޮޓް، ވައިބަރ ބިޒްނަސް މެސެޖްސް، އާރުސީއެސް، އަދި އެސްއެމްއެސް އަށް ރޫޓް ކުރެވޭނެއެވެ.
ބޭސް ޔޫއާރްއެލް
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- ޑެލިވަރީ ސްޓޭޓަސް ޓްރެކް ކުރުމަށް ބޭނުންކުރާ ސްޓްރިންގް
އަވަހަށް ފެށުން
- މެސެޖްތައް ފޮނުވުން - ކެސްކޭޑް މެސެޖުތައް ފޮނުވަން ފެށުން
- މެސެޖް ވެރިއޭބަލްސް - ޑައިނަމިކް ކޮންޓެންޓް ބޭނުންކުރުން
- މެސެޖް ޓައިޕްސް - މެސެޖް ޓައިޕްސް އެކްސްޕްލޯރ ކުރުން
ރިކުއެސްޓް މިސާލު
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 އިންޓަރނަލް ސަރވަރ އެރަރ- ސަރވަރ އެރަރ
ފައިދާތައް
ސިންގަލް އިންޓަގްރޭޝަން
ހުރިހާ މެސެޖިން ޗެނަލްތަކަށް އެއް އެޕީއައި އިންޓަގްރޭޝަން - ކޮންމެ ޕްލެޓްފޯމަކާ ވަކިން އިންޓަގްރޭޓް ކުރަން ނުޖެހެ އެވެ.
އޮޓޮމެޓިކް ރޫޓިންގ
ސްމާޓް ރޫޓިންގެ ސަބަބުން ކޮންމެ ރިސީވަރަކަށް ވެސް އެންމެ ރަނގަޅު ޗެނަލް މެދުވެރިކޮށް މެސެޖު ޑެލިވަރީ ކުރެވޭނެ އެވެ.
ކޮސްޓް އޮޕްޓިމައިޒޭޝަން
ކެސްކޭޑް އިން ފުރަތަމަ ޓްރައި ކުރަނީ އަގުހެޔޮ ޗެނަލްތަކެއް ކަމަށާއި، އޮޓޮމެޓިކުން އަނބުރާ އަގުބޮޑު އޮޕްޝަންތަކަށް ވެއްޓޭނީ ހަމައެކަނި ބޭނުންވާ ވަގުތުތަކުގަ އެވެ.
ޑެލިވަރީ ރޭޓް މަތިވުން
މަލްޓިޕަލް ފޯލްބެކް ޗެނަލްތަކުން ޕްރައިމަރީ ޗެނަލް ފެއިލްވިޔަސް ތިބާގެ މެސެޖު ލިބޭ މީހާއާ ހަމައަށް ފޯރާކަން ކަށަވަރުވެއެވެ.
ދެން އަޅަންޖެހޭ ފިޔަވަޅުތައް
- ކެސްކޭޑް މެސެޖް ފޮނުވުން - މެސެޖު ފޮނުވަން ދަސްކުރުން
- މެސެޖް ވެރިއޭބަލްސް - ޑައިނަމިކް ކޮންޓެންޓާއެކު މަސައްކަތްކުރުން
- މެސެޖް ޓައިޕްސް - ލިބެން ހުރި މެސެޖް ޓައިޕްސް ހޯދުން