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

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

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

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

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

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

Authorization: Bearer YOUR_SMSBAT_TOKEN

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

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

https://restapi.smsbat.com

---

ސިންގަލް މެސެޖް ފޮނުވުން

އެންޑްޕޮއިންޓް: POST /api/tsms/message/send

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

ކީ ކެޕޭސިޓީސް

• ފްލެކްސިބަލް ޕެރެމިޓަރސް: ގްލޯބަލް ޕެރެމިޓަރސް ވަކި އެސްއެމްއެސް/ވައިބަރ ޕެރެމިޓަރސް އިން އޯވަރރައިޑް ކުރެވިދާނެއެވެ.
• ކޮންޓެންޓް: ވައިބަރ ކެރޮސެލްތަކާއި، ސާރވޭތަކާއި، ފައިލް އެޓޭޗްމަންޓްތަކާއި، އިންޓަރެކްޓިވް ބަޓަންތަކަށް ސަޕޯޓްކުރެއެވެ.
• އެރަރ ހެންޑްލިންގ: އެރަރސް (ސްޓްރަކްޗަރޑް އެރަރ ރެސްޕޮންސް) އަށް ވެސް އެޗްޓީޓީޕީ 200 ރިޓަރން ކޮށްދެއެވެ. ސިސްޓަމް އެރަރސް އަށް ސްޓޭޓަސް FATAL_ERROR އާއެކު response_code: 999 އެވެ.
• ރިސީޕީއެންޓް އެރަރސް: ވަކި ރިސީޕީއެންޓް އެރަރސް response_result އެރޭގައި ރިޓަރން ކުރެވެއެވެ. ފެއިލްވެފައިވާ ރިސީވަރުތަކުގައި message_id: null އަދި ވަކި އެރަރ ކޯޑްތަކެއް ހުރެއެވެ.

ރިކުއެސްޓް މިސާލު (ހައިބްރިޑް މެސެޖް)

{
  "sender": "GlobalSender",
  "text": "Test message",
  "recipients": ["380951111111", "380952222222"],
  "start_time": "2025-09-29T10:00:00Z",
  "sequence_id": "seq_12345",
  "sms": {
    "sender": "SMSSender",
    "text": "SMS version of message",
    "is_flash": false
  },
  "viber": {
    "sender": "ViberSender",
    "text": "Viber version of message",
    "ttl": 3600,
    "image_url": "https://example.com/image.png",
    "caption": "Button text",
    "action": "https://google.com",
    "count_clicks": true,
    "is_transactional": false
  }
}

ރިކުއެސްޓް މިސާލު (ވައިބަރ ކެރޮސެލް)

{
  "sender": "GlobalSender",
  "text": "Check out our products",
  "recipients": ["380951111111"],
  "viber": {
    "sender": "ViberSender",
    "text": "Check out our products",
    "is_transactional": false,
    "carousel": [
      {
        "title": "Product 1",
        "image_url": "https://example.com/product1.jpg",
        "button_caption": "Buy Now",
        "button_url": "https://example.com/buy/product1",
        "link_caption": "Learn More",
        "link_url": "https://example.com/product1"
      },
      {
        "title": "Product 2",
        "image_url": "https://example.com/product2.jpg",
        "button_caption": "Buy Now",
        "button_url": "https://example.com/buy/product2",
        "link_caption": "Learn More",
        "link_url": "https://example.com/product2"
      }
    ]
  }
}

ރިކުއެސްޓް މިސާލު (ވައިބަރ ސާރވޭ)

{
  "sender": "GlobalSender",
  "text": "Please rate our service",
  "recipients": ["380951111111"],
  "viber": {
    "sender": "ViberSender",
    "text": "Please rate our service",
    "is_transactional": true,
    "survey": [
      "Excellent",
      "Good",
      "Average",
      "Poor"
    ]
  }
}

---

އެތައް މެސެޖެއް ފޮނުވުން (ބެޗް)

އެންޑްޕޮއިންޓް: POST /api/tsms/message/sendmulti

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

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

{
  "batch_1": {
    "sender": "GlobalSender",
    "text": "Test message",
    "recipients": ["380982462128", "380501111111"],    
    "sms": {
        "sender": "SMSSender",
        "text": "SMS version of message"
    }
  },
  "batch_2": {
    "sender": "GlobalSender",
    "text": "Second message",
    "recipients": ["380501111111"],
    "viber": {
      "sender": "ViberSender",
      "text": "Viber message",
      "is_transactional": true
    }
  }
}

ޖަވާބު މިސާލު

{
    "response_code": 0,
    "response_status": "OK",
    "response_result": {
        "batch_1": {
            "response_code": 800,
            "response_status": "SUCCESS_MESSAGE_ACCEPTED",
            "response_result": [
                {
                    "phone": "380982462128",
                    "response_code": 0,
                    "message_id": "f1640579-ea75-4bc1-b708-1c3858bf222d",
                    "response_status": "OK"
                }
            ]
        },
        "batch_2": { ... }
    }
}

---

މެސެޖް ސްޓޭޓަސް ހޯދުން

އެންޑްޕޮއިންޓް: POST /api/tsms/message/status

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

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

{
  "messages": [
      "573dcb46-7851-4e16-bb1f-721c13ef5f38", 
      "6b7f9ff5-28c8-4f38-913b-31af6021fbea"
  ]
}

---

މެސެޖުގެ ތަފްސީލް ހޯއްދަވާ

އެންޑްޕޮއިންޓް: POST /api/tsms/message/details

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

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

{
  "messages": [
      "573dcb46-7851-4e16-bb1f-721c13ef5f38", 
      "f1640579-ea75-4bc1-b708-1c3858bf222d"
  ]
}

ޖަވާބު މިސާލު

{
    "response_code": 0,
    "response_status": "OK",
    "response_result": [
        {
            "message_id": "573dcb46-7851-4e16-bb1f-721c13ef5f38",
            "sms": null,
            "viber": {
                "added": "2025-09-29T14:17:02.577Z",
                "start": "2025-09-29T10:00:00Z",
                "sent": "2025-09-29T14:17:02.577Z",
                "updated": "2025-09-29T14:17:02.577Z",
                "sender": "ViberSender",
                "text": "Viber version of message",
                "recipient": "380982462128",
                "message_type": "promotional",
                "status": "Queued",
                "price": 0,
                "ttl": 3600,
                "caption": "Button text",
                "action": "https://google.com"
            },
            "response_code": 0,
            "response_status": "OK"
        }
    ]
}