Help Center ޖީއެމްއެސް އެޕީއައި ކޮމްޕެޓިބިލިޓީ

ޖީއެމްއެސް އެޕީއައި ކޮމްޕެޓިބިލިޓީ

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


ކަނެކްޝަން ސެޓިންގސް

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

  • ބޭސް ޔޫއާރްއެލް: https://restapi.smsbat.com
  • އެންޑްޕޮއިންޓް: ޕޯސްޓް /api/GMSMessage/send_message
  • ރިކުއެސްޓް ފޯމެޓް: އެޕްލިކޭޝަން/ޖޭއެސްއޯއެން
  • އޮތެންޓިކޭޝަން: އެޗްޓީޓީޕީ ބޭސިކް އޮތެންޓިކޭޝަން (ތިޔަބޭފުޅުންގެ އެސްއެމްއެސްބީއޭޓީ އެޕީއައި ކްރެޑެންޝިއަލްސް ބޭނުންކުރެއެވެ)

ރިކުއެސްޓް ޕެރެމިޓަރސް

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

ޕެރެމިޓަރވައްތަރުބޭނުންވާތަފްސީލު
ފޯނު_ނަންބަރުސްޓްރިންގްއާނބައިނަލްއަޤްވާމީ ފޯމެޓުގައި ލިބޭ ފަރާތުގެ ފޯނު ނަންބަރު (އެބަހީ، 380501234567).
ޓެގްސްޓްރިންގްއާނރަޖިސްޓްރީކޮށްފައިވާ ފޮނުވާ ފަރާތުގެ ނަން / އަލްފާ ނަން.
ޗެނަލްތައްއެރޭއާނޓްރައި ކުރަންޖެހޭ ޗެނަލްތަކުގެ ލިސްޓް، އިސްކަންދޭ ތަރުތީބުން. ސަޕޯޓް ކުރެވޭ އަގުތައް: viber، sms، push. މިސާލަކަށް، ["ވައިބަރ"، "އެސްއެމްއެސް"].
ޗެނަލް_އޮޕްޝަންސްއެއްޗެއްއާނކޮންމެ އެކްޓިވް ޗެނަލަކަށް އޮޕްޝަންތައް ހިމެނޭ މެޕް (ތިރީގައި ބަލާށެވެ).
އެކްސްޓްރާ_އައިޑީސްޓްރިންގްނޫންތިބާގެ އެތެރޭގެ ކަސްޓަމަރ ސައިޑް މެސެޖް އައިޑީ.
ކޯލްބެކް_އުރލްސްޓްރިންގްނޫންޑެލިވަރީ ސްޓޭޓަސް ކޯލްބެކްސް ލިބޭނެ ގޮތަށް ސިސްޓަމްގައި ހުންނަ އެންޑްޕޮއިންޓް ޔޫ.އާރ.އެލް.
ޑިވިޝަން_ކޯޑްސްޓްރިންގްނޫންއިޚްތިޔާރީ ޑިވިޝަން ކޯޑް އައިޑެންޓިފައިޓަރ (ޑިފޯލްޓް ކޮށްފައިވަނީ main އަށެވެ).

ޗެނަލް އޮޕްޝަންސް ސެޓިންގސް

channel_options އޮބްޖެކްޓްގައި ޗެނަލް އަށް ޚާއްޞަ ކޮންފިގްރޭޝަންތައް ހިމެނެއެވެ.

chanels އެރޭގައި viber ލިސްޓްކޮށްފައި ހުންނައިރު ބޭނުންކުރެއެވެ.

ޕެރެމިޓަރވައްތަރުބޭނުންވާތަފްސީލު
ޓެކްސްޓްސްޓްރިންގްއާނމެސެޖް ބޮޑީ ޓެކްސްޓް.
ttlއިންޓިޖަރއާނޓައިމް-ޓު-ލައިވް ސިކުންތުކޮޅެއްގެ ތެރޭގައި.
އިމްގްސްޓްރިންގްނޫންދައްކާނެ ތަސްވީރުގެ ޕަބްލިކް އެޗްޓީޓީޕީއެސް ޔޫއާރްއެލް.
ކެޕްޝަންސްޓްރިންގްނޫންބަޓަން ޓެކްސްޓް ލޭބަލް.
އަމަލުސްޓްރިންގްނޫންބަޓަން ކްލިކް ކުރާއިރު މަންޒިލް ޔޫ.އާރ.އެލް.
ސާރވޭ_އޮޕްޝަންސްއެރޭނޫންސާރވޭ އޮޕްޝަންސްގެ ގޮތުގައި ދައްކާލުމަށް ސްޓްރިންގްސް (2 އިން 5 އަށް) ގެ އެރޭ.
ކެރޮސެލް_އައިޓަމްސްއެރޭނޫންވައިބަރ ކެރޮސެލްއެއްގެ ގޮތުގައި ދައްކާލުމަށް ސްލައިޑް އޮބްޖެކްޓްތަކުގެ އެރޭ (ޓެބްގައިވާ ސްޓްރަކްޗަރ ބައްލަވާ) .

ވައިބަރ ރިކުއެސްޓް މިސާލު:

{
  "phone_number": "380501234567",
  "tag": "MySender",
  "channels": ["viber"],
  "channel_options": {
    "viber": {
      "text": "Hello from SMSBAT!",
      "ttl": 60,
      "img": "https://www.example.com/image.png",
      "caption": "Open",
      "action": "https://www.example.com"
    }
  }
}

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

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

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

{
  "MessageId": "6f0d5e28-7f3a-4df3-91a2-3d58d9e09b9a",
  "ErrorCode": null,
  "ErrorText": null
}

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

ވެލިޑޭޝަން ނުވަތަ ޕްރޮސެސިންގ ފޭލްވެއްޖެނަމަ، ނޮން-ނަލް ErrorCode އާއި ތަފްސީލީ ErrorText އެއް އެކުލެވޭ އެރަރ ރެސްޕޮންސްއެއް ލިބޭނެއެވެ.

{
  "MessageId": "00000000-0000-0000-0000-000000000000",
  "ErrorCode": 10221,
  "ErrorText": "This type of Message is not supported by the system"
}

ކޯލްބެކް ޑެލިވަރީ ފޯމެޓް

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

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

POST /your-callback-endpoint HTTP/1.1
Host: yoursystem.com
Content-Type: application/json

{
  "number": "380501234567",
  "time": 1719237600000,
  "status": 2,
  "substatus": 23,
  "hyber_status": 23033,
  "message_id": "6f0d5e28-7f3a-4df3-91a2-3d58d9e09b9a",
  "extra_id": "ORDER-12345",
  "sent_via": "viber",
  "matching_template_id": 0
}

ކޯލްބެކް ފީލްޑްސް ޑިސްކްރިޕްޝަން

ދަނޑުވައްތަރުތަފްސީލު
ނަންބަރުސްޓްރިންގްލިބޭ ފަރާތުގެ ފޯނު ނަންބަރެވެ.
ވަގުތުނަންބަރުޔުނިކްސް މިލިސެކަންޑްގައި އިވެންޓް ޓައިމްސްޓޭމްޕް.
ސްޓޭޓަސްނަންބަރުސިމްޕްލިފައިޑް ސްޓޭޓަސް އައިޑެންޓިފައިޓަރ (ސްޓޭޓަސް ކޯޑް ޓޭބަލް ބައްލަވާ) .
ސަބްސްޓޭޓަސްނަންބަރުތަފްސީލީ ސްޓޭޓަސް އައިޑެންޓިފައިޓަރ (ސަބްސްޓޭޓަސް ކޯޑް ޓޭބަލް ބައްލަވާ) .
ހައިބަރ_ސްޓޭޓަސްނަންބަރުތަފްސީލީ އެސްއެމްއެސްބީއޭޓީގެ އިންޓަރނަލް ސްޓޭޓަސް ކޯޑް (ހައިބަރ ސްޓޭޓަސް ޓޭބަލް ބައްލަވާ) .
މެސެޖް_އައިޑީސްޓްރިންގްފޮނުވުމުން އުފެދޭ އެސްއެމްއެސްބީއޭޓީ މެސެޖް އައިޑީ (ޖީއައިޑީ) އެވެ.
އެކްސްޓްރާ_އައިޑީސްޓްރިންގްއަސްލު ރިކުއެސްޓްގައި ފޯރުކޮށްދީފައިވާ ކަސްޓަމަރ ސައިޑް އައިޑީ.
ފޮނުވި_ވިއާސްޓްރިންގްމެސެޖު ޕްރޮސެސްކުރި ޗެނަލް: viber، sms، ނުވަތަ rcs.
މެޗިންގ_ޓެމްޕްލޭޓް_އައިޑީނަންބަރުވައިބަރ ޓެމްޕްލޭޓް މެޗް ސްޓޭޓަސް (އެކަށީގެންވާ ތަންތަނުގައި) .

ސްޓޭޓަސް މެޕިންގސް

1. ސިމްޕްލިފައިޑް ސްޓޭޓަސް (ސްޓޭޓަސް) .

ކޯޑްމާނަ
1މެސެޖު ބަލައިގަނެ ނުވަތަ ޑެލިވަރީ ކުރަމުންދާ.
2މެސެޖެއް ޑެލިވަރީ ކޮށްފިއެވެ.
3ޕްރޮސެސިންގ ނުވަތަ ޑެލިވަރީ އެރަރ.

2. ތަފްސީލީ ހާލަތު (substatus)

ކޯޑްމާނަ
12ޕްރޮސެސިންގ އަށް ބަލައިގަނެވޭނެއެވެ.
23ފޯރުކޮށްދިނުން.
24ފެނިފައި/ކިޔައިފި.
35ޓީޓީއެލްގެ ތެރޭގައި ޑެލިވަރީ ނުކުރެވޭ (މުއްދަތު ހަމަވެފައިވާ) އެވެ.
36ޑެލިވަރީ އެރަރ.

3. ޗެނަލް ވައްތަރު (sent_via)

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

4. ތަފްސީލީ އެސްއެމްއެސްބީއޭޓީ ސްޓޭޓަސް (hyber_status)

ކޯޑްޗެނަލްސްޓޭޓަސްސަބްސްޓޭޓަސްމާނަ
23033ވައިބަރ223ވައިބާ މެސެޖް ޑެލިވަރީ ކޮށްފިއެވެ.
24013ވައިބަރ224ވައިބަރ މެސެޖު ކިޔުނީ ލިބޭ ފަރާތުން (ފެންނަނީ) އެވެ.
36013ވައިބަރ336ވައިބާގެ އެތެރޭގެ ގޯހެއް.
36023ވައިބަރ336ވައިބަރ ސާވިސް އައިޑީ ސައްހަ ނޫން ނުވަތަ ނުލިބޭ.
36033ވައިބަރ336ވައިބަރ ޕޭލޯޑް ޑޭޓާ ސައްހަ ނޫން.
36037ވައިބަރ336ވައިބަރ އިމޭޖް ޔޫއާރްއެލް މާ ދިގު.
36038ވައިބަރ336ވައިބަރ އިމޭޖް ޔޫއާރްއެލް ސައްހަ ނޫން.
36039ވައިބަރ336ވައިބަރ ޓެކްސްޓް މާ ދިގު.
36044ވައިބަރ336ހުސް ވައިބަރ ޓެކްސްޓެއް.
36053ވައިބަރ336ސަޕޯޓް ނުކުރާ ވައިބަރ މެސެޖް ޓައިޕް.
36063ވައިބަރ336ސައްހަ ނޫން ވައިބަރ ޕެރެމިޓަރސް.
36073ވައިބަރ336ވައިބަރ ޕްރޮވައިޑަރ ޓައިމްއައުޓް.
36083ވައިބަރ336ވައިބަރ ސެންޑަރ ބްލޮކް ކޮށްފައިވަނީ ރިސީވަރެވެ.
36093ވައިބަރ336ލިބޭ ފަރާތަކީ ވައިބަރ ޔޫޒަރެއްގެ ގޮތުގައި ރަޖިސްޓްރީކޮށްފައިވާ ފަރާތެއް ނޫނެވެ.
36103ވައިބަރ336ވައިބަރ ސަޕޯޓް ލިބިފައިވާ އެންޑްރޮއިޑް/އައިއޯއެސް ޑިވައިސްއެއް ނުފެނެއެވެ.
36113ވައިބަރ336ވައިބަރ ފޮނުވުމަށް ހުއްދަ ނެތް އައިޕީ އެޑްރެސް.
36123ވައިބަރ336ޑަބިލިކޭޓް ވައިބަރ މެސެޖު ފެނިއްޖެއެވެ.
36143ވައިބަރ336ވައިބަރ ބިލިންގ އެރަރ.
36153ވައިބަރ336ޕްލެޓްފޯމް ބްލެކްލިސްޓުން މެސެޖެއް ބްލޮކްކޮށްފައި.
36163ވައިބަރ336ވައިބަރ ޕްލެޓްފޯމް އިންޓަރނަލް ޕްރޮސެސިންގ އެރަރ.
36173ވައިބަރ336ގޯސް ނުވަތަ ގެއްލިފައިވާ ވައިބަރ ލޭބަލް.
36183ވައިބަރ336ސައްހަ ނޫން ވައިބަރ ޓީޓީއެލް ވެލިއު.
12011sms / rcs112އެސްއެމްއެސް/އާރުސީއެސް ބަލައިގަނެވޭނެއެވެ.
36011sms / rcs112އެސްއެމްއެސް/އާރުސީއެސް އެންރޫޓް.
23011sms / rcs223އެސްއެމްއެސް/އާރުސީއެސް ޑެލިވަރީ ކޮށްފިއެވެ.
35015sms / rcs335އެސްއެމްއެސް/އާރުސީއެސް މުއްދަތު ހަމަވެފައިވާ (ޓީޓީއެލްގެ ތެރޭގައި ޑެލިވަރީ ނުކުރެވޭ) އެވެ.
36021sms / rcs336އެސްއެމްއެސް/އާރުސީއެސް މެސެޖު ޑިލީޓް ކޮށްފިއެވެ.
36031sms / rcs336އެސްއެމްއެސް/އާރުސީއެސް ޑެލިވަރީ ނުކުރެވޭނެއެވެ.
36041sms / rcs336އެސްއެމްއެސް/އާރުސީއެސް ޑެލިވަރީގެ ހާލަތު ނޭނގޭ.
36051sms / rcs336އެސްއެމްއެސް/އާރުސީއެސް މެސެޖު ރިޖެކްޓް.