އެސްއެމްއެސް މެސެޖް

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

އޯވަރވިއު

އެސްއެމްއެސް (ޝޯޓް މެސެޖް ސާވިސް) އަކީ:

• ވަގުތަށް މުހިންމު ނޮޓިފިކޭޝަންތައް
• ވައިބަރ/އާރްސީއެސް މެސެޖުތަކަށް ފޯލްބެކް
• ސްމާޓްފޯނު ނެތި ޔޫޒަރުންނާ ހަމައަށް ފޯރުކޮށްދިނުން
• ހުރިހާ މޯބައިލް ނެޓްވޯކްތަކެއްގައި ޔުނިވާސަލް ކޮމްޕެޓިބިލިޓީ
• ޑެލިވަރީ ރޭޓް މަތި (95%+)

އަސާސީ އެސްއެމްއެސް މެސެޖެއް

ރިކުއެސްޓް

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

ޕެރެމިޓަރސް

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

މިސާލުތައް

ސާދާ އެސްއެމްއެސް

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

ކަސްޓަމަރ އައިޑީ އާއި އެކު އެސްއެމްއެސް ކުރުން

{
  "messages": [{
    "from": "YourStore",
    "to": "+380XXXXXXXXX",
    "type": "sms",
    "text": "Your order #12345 has been shipped.",
    "customerMessageId": "order-12345-notification"
  }]
}

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

{
  "messages": [{
    "from": "YourApp",
    "to": "+380XXXXXXXXX",
    "type": "sms",
    "text": "Your verification code is: 123456",
    "ttl": 300
  }]
}

އަކުރު އެންކޯޑިންގ

ޖީއެސްއެމް 7-ބިޓް އެންކޯޑިންގ

ސްޓޭންޑަރޑް ޖީއެސްއެމް އަކުރު (އެސްއެމްއެސް އެއްގައި 160 އަކުރު):

A-Z a-z 0-9
@ £ $ ¥ è é ù ì ò Ç Ø ø Å å
Δ _ Φ Γ Λ Ω Π Ψ Σ Θ Ξ
! " # % & ' ( ) * + , - . / : ; < = > ?

ދިގުކޮށްފައިވާ ޖީއެސްއެމް އަކުރުތައް

މި އަކުރުތައް ގުނާނީ 2 އަކުރުގެ ގޮތުގައެވެ:

| ^ € { } [ ] ~ \

ޔުނިކޯޑް (ޔޫސީއެސް-2) އެންކޯޑިންގ

ޚާއްޞަ އަކުރުތަކެއް ހުންނަ މެސެޖުތަކުގައި ބޭނުންކުރަނީ ޔުނިކޯޑް އެންކޯޑިންގ (އެސްއެމްއެސް އެއްގައި 70 އަކުރު):

• އިމޯޖީ: 😀 🎉 ❤️
• ސިރިލިކް: А Б В Г Д Е Ж
• ޚާއްޞަ ނިޝާންތައް: ✓ ✗ ★ ♥

މެސެޖުގެ ދިގުމިން

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

• ޖީއެސްއެމް 7-ބިޓް: 160 އަކުރު
• ޔުނިކޯޑް: 70 އަކުރު

މަލްޓި ޕާޓް އެސްއެމްއެސް

ތިބާގެ މެސެޖު ލިމިޓަށްވުރެ އިތުރުވުމުން، އެ މެސެޖު އެތައް ބަޔަކަށް ބަހާލެވިފައި ވެއެވެ:

• ޖީއެސްއެމް 7-ބިޓް: ކޮންމެ ބަޔަކަށް 153 އަކުރު
• ޔުނިކޯޑް: ކޮންމެ ބަޔަކަށް 67 އަކުރު

މިސާލު

{
  "messages": [{
    "from": "YourBrand",
    "to": "+380XXXXXXXXX",
    "type": "sms",
    "text": "This is a very long message that will be split into multiple parts. Each part will be delivered separately but will appear as a single message on the recipient's phone. The system automatically handles the splitting and reassembly."
  }]
}

މި މެސެޖް (201 އަކުރު) 2 ބަޔަކަށް ބަހާލެވޭނެއެވެ.

ޖަވާބު

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

{
  "messagelistId": 123456,
  "messages": [
    {
      "messageId": "abc123def456",
      "status": "accepted",
      "parts": 2,
      "customerMessageId": "order-12345-notification",
      "to": "+380XXXXXXXXX"
    }
  ]
}

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

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

ފޮނުވާ ފަރާތުގެ އައިޑީ

އަލްފާނިއުމެރިކް ސެންޑަރ

ފޮނުވާ ފަރާތުގެ ގޮތުގައި ތިމާގެ ބްރޭންޑް ނަން ބޭނުންކުރުން (11 އަކުރު އާއި ހަމައަށް):

{
  "from": "YourBrand",
  "to": "+380XXXXXXXXX",
  "type": "sms",
  "text": "Hello from YourBrand!"
}

ހުރަސްތައް:

• ގިނަވެގެން 11 އަކުރު
• އަކުރުތަކާއި ނަންބަރުތައް އެކަނި
• ޖާގައެއް ނުވަތަ ޚާއްޞަ އަކުރުތަކެއް ނެތެވެ
• ރިސީވަރަށް އަލްފާނިއުމެރިކް ފޮނުވާ ފަރާތްތަކަށް ޖަވާބު ނުދެވޭނެއެވެ

އަދަބީ ފޮނުވާ ފަރާތް

ފޮނުވާ ފަރާތުގެ ގޮތުގައި ފޯނު ނަންބަރެއް ބޭނުންކުރުން (ދެފަރާތުގެ އެސްއެމްއެސްއަށް):

{
  "from": "+380123456789",
  "to": "+380XXXXXXXXX",
  "type": "sms",
  "text": "Hello! You can reply to this message."
}

ޔޫސް ކޭސްސް

އޯޓީޕީ ވެރިފިކޭޝަން

{
  "from": "YourApp",
  "to": "+380XXXXXXXXX",
  "type": "sms",
  "text": "Your verification code is: 123456. Valid for 5 minutes.",
  "ttl": 300
}

އޯޑަރ ނޮޓިފިކޭޝަންސް

{
  "from": "YourStore",
  "to": "+380XXXXXXXXX",
  "type": "sms",
  "text": "Your order #12345 has been delivered. Thank you for shopping with us!"
}

އެޕޮއިންޓްމަންޓް ހަނދާންކޮށްދިނުން

{
  "from": "YourClinic",
  "to": "+380XXXXXXXXX",
  "type": "sms",
  "text": "Reminder: Your appointment is scheduled for tomorrow at 2:00 PM."
}

ޕޭމަންޓް ކޮންފަރމަޝަންސް

{
  "from": "YourBank",
  "to": "+380XXXXXXXXX",
  "type": "sms",
  "text": "Payment of 100 USD to Merchant ABC was successful. Transaction ID: 789xyz"
}

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

މެސެޖް ކޮންޓެންޓް

• ✅ މެސެޖުތައް ޚުލާޞާކޮށް ސާފުކޮށް ބެހެއްޓުން
• ✅ ފޮނުވާ ފަރާތް ދެނެގަތުން ހިމަނާށެވެ
• ✅ ބޭނުންނަމަ ކޯލް ޓު އެކްޝަން އިތުރުކުރުން
• ✅ ރަނގަޅު ނަލަބަހާއި އިމްތިޙާނު ބޭނުންކުރުން
• ❌ މާގިނައިން ޕަންކްޗުއޭޝަން ޖަހައިގެން ދުރުހެލިވާށެވެ!!!
• ❌ ހުރިހާ ކެޕްސް ބޭނުން ނުކުރުން
• ❌ ޝައްކު ކުރެވޭ ގޮތަށް ފެންނަ ޔޫއާރްއެލް ޝޯޓްނަރސް އިން ދުރުހެލިވާށެވެ

އަކުރު ބޭނުންކުރުން

• ފޮނުވުމުގެ ކުރިން ކެރެކްޓަރ ކައުންޓް ޗެކްކުރުން
• ދިގުކޮށްފައިވާ ޖީއެސްއެމް އަކުރުތަކަށް ސަމާލުވުން (2 ގެ ގޮތުގައި ގުނާށެވެ)
• ބަލްކް ފޮނުވުމުގެ ކުރިން ޚާއްޞަ އަކުރުތަކާއެކު ޓެސްޓްކުރުން
• ދިގު މެސެޖުތަކަށް ޖީއެސްއެމް އެންކޯޑިންގ ބޭނުންކުރުމަށް ވިސްނާށެވެ

ފޯނު ނަންބަރު

• އަބަދުވެސް އީ.164 ފޯމެޓް ބޭނުންކުރުން: +380XXXXXXXXXX
• ފޮނުވުމުގެ ކުރިން ފޯނު ނަންބަރުތައް ސައްހަކުރުން
• ތިމާގެ ލިސްޓުން ސައްހަ ނޫން ނަންބަރުތައް އުނިކުރުން
• ކޮންޓެކްޓް ލިސްޓް އަޕްޑޭޓްކޮށް ބެހެއްޓުން

ޓައިމިންގ

• ލޯކަލް ޓައިމް ޒޯންތަކަށް އިޙްތިރާމްކުރުން
• ރޭގަނޑު (ރޭގަނޑު 10 - ހެނދުނު 8) ފޮނުވުމުން ދުރުހެލިވުން
• ވިޔަފާރީގެ މެސެޖުތަކަށް ވިޔަފާރި ގަޑިތަކަށް ވިސްނުން
• ވަގުތަށް ނާޒުކު މެސެޖުތަކަށް އެކަށީގެންވާ ޓީޓީއެލް ސެޓްކުރުން

ކޮމްޕްލަޔަންސް

• މާކެޓިންގ މެސެޖު ފޮނުވުމުގެ ކުރިން ރުހުން ހޯދުން
• ޕްރޮމޯޝަނަލް އެސްއެމްއެސް އަށް އޮޕްޓް އައުޓް އިންސްޓްރަކްޝަންތައް ހިމަނާށެވެ
• ލޯކަލް ގަވާއިދުތަކަށް ތަބާވުން (ޖީޑީޕީއާރު ފަދަ)
• “ޑޫ ނޮޓް ޑިސްޓާބް” ލިސްޓްތަކަށް އިޙްތިރާމްކުރުން

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

އާންމު ގޯސްތައް

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

ކޮސްޓް އޮޕްޓިމައިޒޭޝަން

މެސެޖް ބައިތައް މަދުކުރުން

• މެސެޖުތައް 160 އަކުރު (ޖީއެސްއެމް) ނުވަތަ 70 (ޔުނިކޯޑް) ގެ ދަށުގައި ބެހެއްޓުން
• ޔުނިކޯޑް ޓްރިގަރ ކުރާ ޚާއްޞަ އަކުރުތަކުން ދުރުހެލިވުން
• އެކަށީގެންވާ ވަގުތެއްގައި ކުރުކުރުންތައް ބޭނުންކުރުން
• ކޮންމެހެން ބޭނުން ނުވާ ޖާގަތައް ނައްތާލުން

މިސާލު އޮޕްޓިމައިޒޭޝަން

❌ ކުރިން (171 އަކުރު، 2 އެސްއެމްއެސް):

Hello John! Your order #12345 has been successfully delivered to your address at 123 Main Street. Thank you for shopping with us! We hope to see you again soon.

✅ އޭގެ ފަހުން (156 އަކުރު، 1 އެސްއެމްއެސް):

Hi John! Order #12345 delivered to 123 Main St. Thanks for shopping with us! Visit example.com/order/12345 for details.

ބަލްކް ސެންޑިންގ

އެއް ރިކުއެސްޓެއްގައި އެތައް މެސެޖެއް ފޮނުވުން:

{
  "messages": [
    {
      "from": "YourBrand",
      "to": "+380111111111",
      "type": "sms",
      "text": "Message 1"
    },
    {
      "from": "YourBrand",
      "to": "+380222222222",
      "type": "sms",
      "text": "Message 2"
    },
    {
      "from": "YourBrand",
      "to": "+380333333333",
      "type": "sms",
      "text": "Message 3"
    }
  ]
}

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

• ވައިބަރ މެސެޖްސް - ރިޗް މީޑިއާ މެސެޖިންގ
• އާރުސީއެސް މެސެޖްސް - ރިޗް ކޮމިއުނިކޭޝަން ސާވިސަސް
• ޗެކް ސްޓޭޓަސް - ޑެލިވަރީ ސްޓޭޓަސް ޓްރެކްކުރުން
• ފޯލްބެކް ސްޓްރެޓެޖީސް - ފޯލްބެކްސް ކޮންފިގްރޭޓް ކުރުން