Skip to content

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

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

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

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

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

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

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

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

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

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

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

އަސާސީ އޮތު އާއި އެކު: ކޯޑް_ބްލޮކް_0

އެކްސް-އޮތޮރައިޒޭޝަން-ކީ އާއެކު: ކޯޑް_ބްލޮކް_1

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

އިމޭޖް އޮންލީ ކޯޑް_ބްލޮކް_4

ޓެކްސްޓް + ބަޓަން ކޯޑް_ބްލޮކް_5

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

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

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

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

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

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

ކޯޑް_ބްލޮކް_8

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

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

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

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

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

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

ކޯޑް_ބްލޮކް_11