SMS सन्देशहरू

SMSBAT API प्रयोग गरी मानक पाठ सन्देशहरू पठाउनुहोस्। SMS सबै मोबाइल उपकरणहरूमा उच्चतम डेलिभरी दरहरूको साथ सबैभन्दा विश्वव्यापी सन्देश च्यानल हो।

सिंहावलोकन

SMS (छोटो सन्देश सेवा) निम्नका लागि उपयुक्त छ:

समय-महत्वपूर्ण सूचनाहरू
Viber/RCS सन्देशहरूको लागि फलब्याक
स्मार्टफोन बिना प्रयोगकर्ताहरू पुग्न
सबै मोबाइल नेटवर्कहरूमा विश्वव्यापी अनुकूलता
उच्च डेलिभरी दर (९५%+)

आधारभूत SMS सन्देश

अनुरोध

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

प्यारामिटरहरू

प्यारामिटर	प्रकार	आवश्यक	विवरण
'बाट'	स्ट्रिङ	हो	अल्फान्यूमेरिक प्रेषक ID (११ वर्ण सम्म)
`to`	स्ट्रिङ	हो	प्रापकको फोन नम्बर E.164 ढाँचामा
`प्रकार`	स्ट्रिङ	हो	`"sms"` मा सेट गर्नुहोस्
`पाठ`	स्ट्रिङ	हो	सन्देश सामग्री
'customerMessageId'	स्ट्रिङ	छैन	तपाईंको आन्तरिक ट्र्याकिङ ID
`ttl`	पूर्णांक	छैन	सेकेन्डमा बाँच्ने समय

उदाहरणहरू

सरल SMS

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."
    }]
  }'

ग्राहक आईडी सहितको SMS

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

TTL मार्फत SMS गर्नुहोस्

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

क्यारेक्टर एन्कोडिङ

GSM ७-बिट इन्कोडिङ

मानक GSM वर्णमाला (प्रति एसएमएस 160 वर्ण):

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

विस्तारित GSM वर्णहरू

यी क्यारेक्टरहरू 2 क्यारेक्टरहरूको रूपमा गणना:

| ^ € { } [ ] ~ \

युनिकोड (UCS-2) इन्कोडिङ

विशेष क्यारेक्टरहरू भएका सन्देशहरूमा युनिकोड इन्कोडिङ प्रयोग गरिन्छ (प्रति एसएमएस ७० वर्णहरू):

इमोजी: 😀 🎉 ❤️
सिरिलिक: А Б В Г Д Е Ж
विशेष प्रतीकहरू: ✓ ✗ ★ ♥

सन्देशको लम्बाइ

एकल एसएमएस

GSM 7-bit: 160 वर्णहरू
युनिकोड: ७० वर्ण

बहु-भाग एसएमएस

जब तपाईंको सन्देश सीमा नाघ्छ, यो धेरै भागहरूमा विभाजित हुन्छ:

GSM 7-bit: 153 वर्ण प्रति भाग
युनिकोड: प्रति भाग ६७ वर्ण

उदाहरण

{
  "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"
    }
  ]
}

प्रतिक्रिया क्षेत्रहरू

क्षेत्र	विवरण
'messageId'	ट्र्याकिङको लागि अद्वितीय पहिचानकर्ता
'स्थिति'	सन्देश स्थिति ('स्वीकार गरिएको', 'अस्वीकृत')
`भाग`	एसएमएस पार्ट्सको संख्या
`to`	प्रापकको फोन नम्बर

प्रेषक आईडी

अल्फान्यूमेरिक प्रेषक

प्रेषकको रूपमा आफ्नो ब्रान्ड नाम प्रयोग गर्नुहोस् (११ वर्ण सम्म):

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

प्रतिबन्धहरू:

अधिकतम ११ वर्ण
अक्षर र संख्या मात्र
कुनै स्पेस वा विशेष क्यारेक्टरहरू छैनन्
प्रापकले अल्फान्यूमेरिक प्रेषकहरूलाई जवाफ दिन सक्दैन

संख्यात्मक प्रेषक

प्रेषकको रूपमा फोन नम्बर प्रयोग गर्नुहोस् (दुई-तर्फी SMS को लागि):

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

केसहरू प्रयोग गर्नुहोस्

OTP प्रमाणीकरण

{
  "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"
}

उत्तम अभ्यासहरू

सन्देश सामग्री

✅ सन्देशहरू संक्षिप्त र स्पष्ट राख्नुहोस्
✅ प्रेषक पहिचान समावेश गर्नुहोस्
✅ आवश्यक भएमा कल-टु-एक्शन थप्नुहोस्
✅ उचित व्याकरण र हिज्जे प्रयोग गर्नुहोस्
❌ अत्याधिक विराम चिन्हबाट बच्नुहोस् !!!
❌ सबै CAPS प्रयोग नगर्नुहोस्
❌ संदिग्ध देखिने URL सर्टनरहरू बेवास्ता गर्नुहोस्

वर्ण प्रयोग

पठाउनु अघि क्यारेक्टर गणना जाँच गर्नुहोस्
विस्तारित GSM वर्णहरू बारे सचेत रहनुहोस् (2 को रूपमा गणना गर्नुहोस्)
बल्क पठाउनु अघि विशेष क्यारेक्टरहरूसँग परीक्षण गर्नुहोस्
लामो सन्देशहरूको लागि GSM एन्कोडिङ प्रयोग गर्ने विचार गर्नुहोस्

फोन नम्बरहरू

सधैं E.164 ढाँचा प्रयोग गर्नुहोस्: +380XXXXXXXXX
पठाउनु अघि फोन नम्बरहरू मान्य गर्नुहोस्
तपाईंको सूचीबाट अवैध नम्बरहरू हटाउनुहोस्
आफ्नो सम्पर्क सूची अद्यावधिक राख्नुहोस्

समय

स्थानीय समय क्षेत्रहरूको सम्मान गर्नुहोस्
राति पठाउनबाट बच्नुहोस् (10 PM - 8 AM)
व्यावसायिक सन्देशहरूको लागि व्यापार घण्टा विचार गर्नुहोस्
समय-संवेदनशील सन्देशहरूको लागि उपयुक्त TTL सेट गर्नुहोस्

अनुपालन

मार्केटिङ सन्देशहरू पठाउनु अघि सहमति प्राप्त गर्नुहोस्
प्रचारात्मक SMS को लागि अप्ट-आउट निर्देशनहरू समावेश गर्नुहोस्
स्थानीय नियमहरू पालना गर्नुहोस् (GDPR, आदि)
"डिस्टर्ब नगर्नुहोस्" सूचीहरूको सम्मान गर्नुहोस्

त्रुटि ह्यान्डलिंग

सामान्य त्रुटिहरू

त्रुटि	कारण	समाधान
`INVALID_RECIPIENT`	गलत फोन ढाँचा	E.164 ढाँचा प्रयोग गर्नुहोस्
`INVALID_SENDER`	अवैध प्रेषक ID	प्रेषक आईडी नियमहरू जाँच गर्नुहोस्
`MESSAGE_TOO_LONG`	अधिकतम लम्बाइ नाघ्यो	विभाजन वा छोटो सन्देश
`INVALID_ENCODING`	असमर्थित वर्णहरू	GSM वा युनिकोड प्रयोग गर्नुहोस्

लागत अनुकूलन

सन्देश भागहरू घटाउनुहोस्

सन्देशहरू 160 वर्ण (GSM) वा 70 (युनिकोड) भन्दा कम राख्नुहोस्
युनिकोड ट्रिगर गर्ने विशेष वर्णहरू नदिनुहोस्
उपयुक्त हुँदा संक्षिप्त नामहरू प्रयोग गर्नुहोस्
अनावश्यक ठाउँहरू हटाउनुहोस्

उदाहरण अनुकूलन

❌ पहिले (१७१ वर्ण, २ SMS):

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.

✅ पछि (१५६ वर्ण, १ एसएमएस):

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"
    }
  ]
}

अर्को चरणहरू

Viber Messages - रिच मिडिया सन्देश
RCS Messages - रिच कम्युनिकेशन सेवाहरू
स्थिति जाँच गर्नुहोस् - डेलिभरी स्थिति ट्र्याक गर्नुहोस्
फलब्याक रणनीतिहरू - फलब्याकहरू कन्फिगर गर्नुहोस्