އޮޕަރޭޓަރ އޮތޯރިޒޭޝަން އަދި ޑީޕް ލިންކްސް

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

އެޕީއައި ބޭސް ޔޫއާރްއެލް: https://chatapi.smsbat.com/ ސްވެގަރ: https://chatapi.smsbat.com/index.html

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

---

1. ކުންފުނީގެ ޓޯކަން ހޯދުން

ކުންފުނީގެ ޓޯކަން ހޯދުމަށްޓަކައި، ކުންފުނީގެ ލޮގިން ކްރެޑެންޝިއަލްސް ހިމެނޭ /api/company/get-token އަށް އެޗްޓީޓީޕީ ޕޯސްޓް ރިކުއެސްޓެއް ފޮނުވުން.

ރިކުއެސްޓް

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

ހަށިގަނޑު:

{
  "login": "string",
  "password": "string"
}

ޖަވާބު

• ސްޓޭޓަސް ކޯޑް: 200 (އޯކޭ)
• ހަށިގަނޑު: ސްޓްރިންގް ޓޯކަން ("ތިބާ_ޓޯކަން_ސްޓްރިންގް")

ނޯޓް: ލިބުނު ޓޯކަން ފަހުން ކުރާ ރިކުއެސްޓްތަކަށް ސޭވް ކުރާށެވެ.

---

2. އޯގަނައިޒޭޝަން ލިސްޓް ހޯދުން

ތިމާގެ އޯގަނައިޒޭޝަންތައް ލިސްޓް ކުރުމަށް ކުންފުނީގެ ޓޯކަން ބޭނުންކޮށްގެން /api/company/organization އަށް ޖީއީޓީ ރިކުއެސްޓެއް ފޮނުވުން.

ރިކުއެސްޓް

• ގޮތް: ގެޓް
• ޔޫއާރްއެލް: https://chatapi.smsbat.com/api/ކުންފުނި/އޮގަނައިޒޭޝަން
• ހެޑަރސް:
  • ހުއްދަ: ބެއަރ {ޓޯކަން}
  • ގަބޫލުކުރުން: ލިޔުން/ސާދާ

ޖަވާބު

• ސްޓޭޓަސް ކޯޑް: 200 (އޯކޭ)
• ހަށިގަނޑު:

[
  {
    "id": 6,
    "name": "string"
  }
]

---

3. އޯގަނައިޒޭޝަންގެ ގޮތުގައި އޮޕަރޭޓަރުން ހޯދުން

organizationId ޕެރެމިޓަރ ބޭނުންކޮށްގެން /api/operator އަށް GET ރިކުއެސްޓެއް ފޮނުވުން.

ރިކުއެސްޓް

• ގޮތް: ގެޓް
• URL: https://chatapi.smsbat.com/api/އޮޕަރޭޓަރ؟އޮގަނައިޒޭޝަންއައިޑީ={އައިޑީ}
• ހެޑަރސް:
  • ހުއްދަ: ބެއަރ {ޓޯކަން}
  • ގަބޫލުކުރުން: ލިޔުން/ސާދާ

ޖަވާބު

• ސްޓޭޓަސް ކޯޑް: 200 (އޯކޭ)
• ހަށިގަނޑު:

[
  {
    "id": 21,
    "name": "string",
    "status": 1,
    "organization": {
      "id": 24,
      "name": "test_costs"
    }
  }
]

---

4. ސިސްޓަމަށް އޮޕަރޭޓަރުން އިތުރުކުރުން

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

ރިކުއެސްޓް

• ގޮތް: ޕޯސްޓް
• URL: https://chatapi.smsbat.com/api/އޮޕަރޭޓަރ/ސިންކްރޮނައިޒް
• ހެޑަރސް:
  • ހުއްދަ: ބެއަރ {ޓޯކަން}
  • ކޮންޓެންޓް-ޓައިޕް: އެޕްލިކޭޝަން/ޖޭއެސްއޯއެން

ހަށިގަނޑު:

[
  {
    "organizationId": 24,
    "name": "string"
  }
]

ޖަވާބު

• ސްޓޭޓަސް ކޯޑް: 200 (އޯކޭ)
• ހަށިގަނޑު:

[
  {
    "id": 21,
    "status": 0,
    "name": "string"
  }
]

ޕޮސިބިލް އޮޕަރޭޓަރ ސްޓޭޓަސްސް:

• އެކްޓިވް: 0
• އިންއެކްޓިވް: 1
• ޑިލީޓްކޮށްފައިވަނީ: 2

---

5. އޮޕަރޭޓަރ ޓޯކަން ހޯދުން

ވަކި އޮޕަރޭޓަރަކަށް ޓޯކަން ހޯދުމަށް ކުންފުނީގެ ޓޯކަން އާއި އެކު ހުއްދަ ދިނުން.

ރިކުއެސްޓް

• ގޮތް: ޕޯސްޓް
• ޔޫއާރްއެލް: https://chatapi.smsbat.com/api/operator/get-token
• ހެޑަރސް:
  • ހުއްދަ: ބެއަރ {ޓޯކަން}
  • ކޮންޓެންޓް-ޓައިޕް: އެޕްލިކޭޝަން/ޖޭއެސްއޯއެން

ހަށިގަނޑު:

{
  "id": 0,
  "expiresAt": "2025-01-20T14:33:34.147Z"
}

expiresAt ބޭނުންވާއިރު، އޮޕަރޭޓަރުގެ ސެޝަން މުއްދަތު (މެކްސް +24 ގަޑިއިރު) ކަނޑައަޅައެވެ.

ޖަވާބު

• ސްޓޭޓަސް ކޯޑް: 200 (އޯކޭ)
• ހަށިގަނޑު: ސްޓްރިންގް ޓޯކަން

---

6. އޮޕަރޭޓަރ ޓޯކަން ސައްހަކުރުން

އޮޕަރޭޓަރެއްގެ ޓޯކަންގެ ސައްހަކަން ޔަގީންކުރުން.

ރިކުއެސްޓް

• ގޮތް: ޕޯސްޓް
• URL: https://chatapi.smsbat.com/api/އޮޕަރޭޓަރ/ވެލިޑޭޓް-ޓޯކަން
• ހެޑަރސް:
  • ހުއްދަ: ބެއަރ {ޓޯކަން}
  • ކޮންޓެންޓް-ޓައިޕް: އެޕްލިކޭޝަން/ޖޭއެސްއޯއެން

ބޮޑީ: "އޮޕަރޭޓަރ_ޓޯކަން_ސްޓްރިންގް"

ސައްހަ ޖަވާބު (200 އޯކޭ):

{
  "isValid": true,
  "operatorId": 0,
  "clientId": 0,
  "expiresAt": "2024-12-28T14:04:15.861Z",
  "error": null
}

---

7. އޮޕަރޭޓަރ ޗެޓް ޕެނަލް އަށް ޑީޕް ލިންކް ކުރުން

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

ފޯމެޓް 1: ޗެޓް އައިޑީ އިން

https://chat.smsbat.com/?chat_raw_id=<chat_id>&token=<jwt_token>

ފޯމެޓް 2: ފޯނު ނަންބަރުން

https://chat.smsbat.com/?phone=<phone_number>&token=<jwt_token>

ފޯނު ނަންބަރު އީ.164 އިންޓަނޭޝަނަލް ފޯމެޓުގައި ހުންނަންވާނެއެވެ.

ފޯމެޓް 3: އަލްފާ ނަމާއި ފޯނުން

https://chat.smsbat.com/?from=<bm_id>&phone=<phone_number>&token=<jwt_token>

ފޯމެޓް 4: ފުރިހަމަ ޓާގެޓް ޑީޓެއިލްސް

މެސެޖުތައް އިންޓަސެޕްޓް ކުރަންވީ ސީދާ ކޮން ސޯސްއަކުންކަން ކަނޑައެޅުން:

https://chat.smsbat.com/?source=<sourceId>&from=<bm_id>&phone=<phone_number>&token=<jwt_token>

ޗެޓް މަސްދަރުތައް:

• 0 - ވައިބަރ
• 1 - ވައިބަރބޮޓް
• 2 - ޓެލެގްރާމްބޮޓް
• 3 - ވަޓްސްއެޕް
• 4 - ވިޖެޓް
• 5 - ރޮޒެޓްކާ
• 6 - ފޭސްބުކް
• 7 - އިންސްޓަގްރާމް