މެސެޖް ފޮނުވުން

/bat/messagelist އެންޑްޕޮއިންޓް ބޭނުންކޮށްގެން އެސްއެމްއެސްބީއޭޓީ އެޕީއައި މެދުވެރިކޮށް މެސެޖުތައް ފޮނުވުން.

އެންޑްޕޮއިންޓް

POST /bat/messagelist

ރިކުއެސްޓް ސްޓްރަކްޗަރ

ރިކުއެސްޓް ބޮޑީ އަކީ މެސެޖް އޮބްޖެކްޓްތަކުގެ ޖޭއެސްއޯއެން އެރޭއެކެވެ:

{
  "messages": [
    {
      "from": "YourSender",
      "to": "+380XXXXXXXXX",
      "type": "sms",
      "text": "Your message text",
      "customerMessageId": "your-internal-id",
      "ttl": 3600
    }
  ]
}

ޕެރެމިޓަރސް

ބޭނުންވާ ޕެރެމިޓަރސް

އިޚްތިޔާރީ ޕެރެމިޓަރސް

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

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

curl -X POST https://restapi.smsbat.com/bat/messagelist \
  -H "X-Authorization-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "messages": [{
      "from": "YourSender",
      "to": "+380XXXXXXXXX",
      "type": "sms",
      "text": "Hello from SMSBAT!"
    }]
  }'

curl -X POST https://restapi.smsbat.com/bat/messagelist \
  -u "username:password" \
  -H "Content-Type: application/json" \
  -d '{
    "messages": [{
      "from": "YourSender",
      "to": "+380XXXXXXXXX",
      "type": "sms",
      "text": "Hello from SMSBAT!"
    }]
  }'

curl -X POST https://restapi.smsbat.com/bat/messagelist \
  -u "@:your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "messages": [{
      "from": "YourSender",
      "to": "+380XXXXXXXXX",
      "type": "sms",
      "text": "Hello from SMSBAT!"
    }]
  }'

ޖަވާބު

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

    curl -i -X POST \
      -H "Content-Type: application/json" \
      -H "Authorization: Basic base64(login:password)" \
      -d '{
        "messages": [
          {
            "from": "Shopillect",
            "to": "380936670003",
            "type": "sms",
            "text": "Text for SMS Shopillect",
            "ttl": "120"
          }
        ]
      }' \
      "https://restapi.smsbat.com/bat/{referralGuid}/messagelist"
    ```

### ޖަވާބުދާރީވުމުގެ ދާއިރާތައް

| ދަނޑު | ވައްތަރު | ތަފްސީލު |
|-------|------|-------------|
| `މެސެޖެލިސްޓްއައިޑީ` | އިންޓިޖަރ | މެސެޖް ލިސްޓަށް ޚާއްޞަ އައިޑެންޓިފައިޓަރ |
| `މެސެޖްއައިޑީ` | ސްޓްރިންގް | ކޮންމެ މެސެޖަކަށް ޔުނިކް އައިޑެންޓިފައިޓަރ |
| `ސްޓޭޓަސް` | ސްޓްރިންގް | މެސެޖް ސްޓޭޓަސް: `އެކްސެޕްޓް`، `ރިޖެކްޓް`، `ފޭލް` |
| `ބައިތައް` | އިންޓިޖަރ | މެސެޖް ބައިތަކުގެ އަދަދު (އެސްއެމްއެސް އަށް) |
| `ކަސްޓަމަރމެސެޖްއައިޑީ` | ސްޓްރިންގް | ތިބާގެ އެތެރޭގެ އައިޑެންޓިފައިޓަރ (ފޯރުކޮށްދީފައިވާނަމަ) |
| `އަށް` | ސްޓްރިންގް | ލިބޭ ފަރާތުގެ ފޯނު ނަންބަރު |

## މެސެޖް ވައްތަރުތައް

### އެސްއެމްއެސް

ސާދާ ޓެކްސްޓް މެސެޖުތައް:

```json
{
  "messagelistId": 123456,
  "messages": [
    {
      "messageId": "abc123def456",
      "status": "accepted",
      "parts": 1,
      "customerMessageId": "your-internal-id",
      "to": "+380XXXXXXXXX"
    }
  ]
}

ވައިބަރ ޕްރޮމޯ

ރިޗް މީޑިއާ އާއި އެކު ޕްރޮމޯޝަނަލް މެސެޖުތައް:

{
  "from": "YourSender",
  "to": "+380XXXXXXXXX",
  "type": "sms",
  "text": "Your SMS message text"
}

ވައިބަރ ޓްރާންސެކްޝަނަލް

މުއާމަލާތުގެ ނޮޓިފިކޭޝަންތައް:

{
  "from": "YourSender",
  "to": "+380XXXXXXXXX",
  "type": "viber_promo",
  "text": "Check out our new product!",
  "messageData": {
    "image": "https://example.com/image.jpg",
    "button": {
      "text": "View Product",
      "url": "https://example.com/product"
    }
  }
}

ވައިބަރ އޯޓީޕީ

އެއްފަހަރު ޕާސްވޯޑް ނޮޓިފިކޭޝަން ދިނުން:

{
  "from": "YourSender",
  "to": "+380XXXXXXXXX",
  "type": "viber_trans",
  "text": "Your order #12345 has been confirmed"
}

އެރަރ ހެންޑްލިންގ

އެޗްޓީޓީޕީ ސްޓޭޓަސް ކޯޑްސް

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

{
  "from": "YourSender",
  "to": "+380XXXXXXXXX",
  "type": "viber_otp",
  "messageData": {
    "code": "123456",
    "validity": 300
  }
}

އެންމެ ރަނގަޅު އުސޫލުތައް

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

ފޯނު ނަންބަރުތަކަށް އަބަދުވެސް އީ.164 ފޯމެޓް ބޭނުންކުރުން:

• ✅ ރަނގަޅު: +380XXXXXXXXX
• ❌ ގޯސް: 380XXXXXXXXXX، 0XXXXXXXXXX

މެސެޖް ޓެކްސްޓް

• އެސްއެމްއެސް 160 އަކުރުގެ ދަށުގައި ބެހެއްޓުމަކީ އެތައް ބައިތަކެއް ނުހިމެނޭނެ ގޮތަށް ބެހެއްޓުން
• ބައިނަލްއަޤްވާމީ އަކުރުތަކަށް ޔޫޓީއެފް-8 އެންކޯޑިންގ ބޭނުންކުރުން
• ބަލްކް ފޮނުވުމުގެ ކުރިން ޚާއްޞަ އަކުރުތައް ޓެސްޓްކުރުން

ޓީޓީއެލް (ޓައިމް-ޓު-ލައިވް)

• ވަގުތަށް ނާޒުކު މެސެޖުތަކަށް އެކަށީގެންވާ ޓީޓީއެލް ސެޓްކުރުން
• އޯޓީޕީ މެސެޖުތައް: 300-600 ސިކުންތު (5-10 މިނެޓް)
• ޕްރޮމޯޝަނަލް މެސެޖުތައް: 3600-86400 ސިކުންތު (1-24 ގަޑިއިރު)

ކަސްޓަމަރ މެސެޖް އައިޑީ

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

ރޭޓް ލިމިޓްސް

މިކަމާ ބެހޭ މައުލޫމާތު ހޯދުމަށް އެކައުންޓް މެނޭޖަރާ ގުޅާށެވެ:

• ސިކުންތަކަށް މެސެޖުތައް
• ދުވާލަކު މެސެޖުތައް ފޮނުވުން
• އެއްފަހަރާ ގުޅުންތައް

ދެން އަޅަންޖެހޭ ފިޔަވަޅުތައް

• ވައިބަރ މެސެޖްސް - ވައިބަރ މެސެޖް ވައްތަރުތައް ހޯދުން
• އެސްއެމްއެސް މެސެޖްތައް - އެސްއެމްއެސް އާއި ބެހޭ އިތުރު މައުލޫމާތު ހޯއްދަވާށެވެ
• ޗެކް ސްޓޭޓަސް - މެސެޖް ޑެލިވަރީ ޓްރެކްކުރުން