Help Center सन्देश पठाउनुहोस्

सन्देश पठाउनुहोस्

/bat/messagelist अन्त्यबिन्दु प्रयोग गरेर SMSBAT API मार्फत सन्देशहरू पठाउनुहोस्।

अन्तिम बिन्दु

POST /bat/messagelist

अनुरोध संरचना

अनुरोधको मुख्य भाग सन्देश वस्तुहरूको JSON एरे हो:

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

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

आवश्यक प्यारामिटरहरू

प्यारामिटरप्रकारविवरण
’बाट’स्ट्रिङअल्फान्यूमेरिक प्रेषक ID
toस्ट्रिङप्रापकको फोन नम्बर E.164 ढाँचामा (जस्तै, +380XXXXXXXXX)
प्रकारस्ट्रिङसन्देश प्रकार: sms, viber_promo, viber_trans, viber_carousel, viber_survey, viber_otp, rcs, flashcall
पाठस्ट्रिङसन्देश सामग्री (धेरै प्रकारका लागि आवश्यक, केहि को लागी वैकल्पिक)

वैकल्पिक प्यारामिटरहरू

प्यारामिटरप्रकारविवरण
’customerMessageId’स्ट्रिङट्र्याकिङको लागि तपाईंको आन्तरिक पहिचानकर्ता
ttlपूर्णांकसेकेन्डमा बाँच्ने समय
messageDataवस्तुप्रकार-विशिष्ट कन्फिगरेसन (सन्देश प्रकार अनुसार भिन्न हुन्छ)

प्रमाणीकरण

तीन प्रमाणीकरण विधिहरू मध्ये एउटा छान्नुहोस्:

=== “एपीआई कुञ्जी हेडर”

```bash
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!"
    }]
  }'
```

=== “HTTP आधारभूत प्रमाणीकरण”

```bash
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!"
    }]
  }'
```

=== “पासवर्डको रूपमा API कुञ्जी”

```bash
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!"
    }]
  }'
```

##प्रतिक्रिया

सफलताको प्रतिक्रिया

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

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

क्षेत्रप्रकारविवरण
’messagelistId’पूर्णांकसन्देश सूचीको लागि अद्वितीय पहिचानकर्ता
’messageId’स्ट्रिङप्रत्येक सन्देशको लागि अद्वितीय पहिचानकर्ता
’स्थिति’स्ट्रिङसन्देश स्थिति: स्वीकार गरिएको, अस्वीकृत, असफल
भागपूर्णांकसन्देशका भागहरूको संख्या (एसएमएसका लागि)
‘customerMessageId’स्ट्रिङतपाईंको आन्तरिक पहिचानकर्ता (यदि प्रदान गरिएको छ)
toस्ट्रिङप्रापकको फोन नम्बर

सन्देशका प्रकारहरू

SMS

सरल पाठ सन्देशहरू:

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

Viber OTP

एक पटक पासवर्ड सूचनाहरू:

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

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

HTTP स्थिति कोडहरू

कोडविवरण
२००अनुरोध सफल
400खराब अनुरोध - अमान्य प्यारामिटरहरू
४०१अनाधिकृत - प्रमाणीकरण असफल
४२९धेरै अनुरोधहरू - दर सीमा नाघ्यो
५००आन्तरिक सर्भर त्रुटि

त्रुटि प्रतिक्रिया

{
  "error": {
    "code": "INVALID_RECIPIENT",
    "message": "Invalid phone number format"
  }
}

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

फोन नम्बर ढाँचा

फोन नम्बरहरूको लागि सधैं E.164 ढाँचा प्रयोग गर्नुहोस्:

  • ✅ सही: +380XXXXXXXXX
  • ❌ गलत: 380XXXXXXXXX, 0XXXXXXXXX

सन्देश पाठ

  • धेरै भागहरूबाट बच्नको लागि 160 क्यारेक्टरहरू भन्दा कम एसएमएस राख्नुहोस्
  • अन्तर्राष्ट्रिय क्यारेक्टरहरूको लागि UTF-8 इन्कोडिङ प्रयोग गर्नुहोस्
  • बल्क पठाउनु अघि विशेष क्यारेक्टरहरू परीक्षण गर्नुहोस्

TTL (समय-टु-लाइभ)

  • समय-संवेदनशील सन्देशहरूको लागि उपयुक्त TTL सेट गर्नुहोस्
  • OTP सन्देशहरू: 300-600 सेकेन्ड (5-10 मिनेट)
  • प्रचार सन्देशहरू: 3600-86400 सेकेन्ड (1-24 घण्टा)

ग्राहक सन्देश ID

  • प्रत्येक सन्देशको लागि अद्वितीय पहिचानकर्ताहरू प्रयोग गर्नुहोस्
  • ट्र्याकिङ र डिबगिङको साथ मद्दत गर्दछ
  • तपाइँको प्रणाली को रेकर्ड संग सम्बन्ध को लागी उपयोगी

दर सीमा

यस बारे जानकारीको लागि आफ्नो खाता प्रबन्धकलाई सम्पर्क गर्नुहोस्:

  • प्रति सेकेन्ड सन्देशहरू
  • प्रति दिन सन्देशहरू
  • समवर्ती जडानहरू

अर्को चरणहरू