Help Center TurboSMS API अनुकूलता

TurboSMS API अनुकूलता

SMSBAT ले TurboSMS API सँग अनुकूलता तहलाई पूर्ण रूपमा समर्थन गर्दछ। यसले तपाइँलाई तपाइँको अवस्थित एकीकरणहरू माइग्रेट गर्न अनुमति दिन्छ जुन TurboSMS को लागि सिधै SMSBAT मा सन्देश संरचनाहरू वा अन्तिम बिन्दु पेलोडहरू पुन: लेख्न बिना डिजाइन गरिएको थियो।

हामीले एसएमएस र भाइबर सन्देशहरू पठाउन समर्थन गर्छौं (क्यारोसेल र सर्वेक्षणहरू जस्ता उन्नत सुविधाहरू सहित), स्थितिहरू प्राप्त गर्ने, र सन्देश विवरणहरू प्राप्त गर्ने ठ्याक्कै उही अनुरोध शरीर संरचनाहरू प्रयोग गरेर जुन तपाईं पहिले नै परिचित हुनुहुन्छ।

प्रमाणीकरण

नेटिभ TurboSMS API बाट मात्र भिन्नता प्रमाणीकरण संयन्त्र हो। जबकि TurboSMS ले अनुकूलन ‘टोकन’ क्वेरी प्यारामिटर वा एक विशिष्ट प्रमाणीकरण हेडर प्रयोग गर्दछ, SMSBAT लाई मानक बियरर टोकन चाहिन्छ।

तपाईंले आफ्नो SMSBAT API टोकन सबै अनुरोधहरूको लागि प्राधिकरण हेडरमा समावेश गर्नुपर्छ:

Authorization: Bearer YOUR_SMSBAT_TOKEN

आधार URL

सबै अन्तिम बिन्दुहरू SMSBAT API आधार URL मा निर्देशित हुनुपर्छ:

https://restapi.smsbat.com

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

अन्तबिन्दु: POST /api/tsms/message/send

हाइब्रिड डेलिभरीको लागि समर्थन सहित SMS र Viber सन्देशहरू पठाउन अनुमति दिन्छ (SMS फलब्याकको साथ Viber)। यसले एकल पठाउने अनुरोधलाई प्रशोधन गर्छ र प्रत्येक प्राप्तकर्ताको लागि डेलिभरी परिणामहरू फर्काउँछ।

प्रमुख क्षमताहरू

  • लचिलो प्यारामिटरहरू: ग्लोबल प्यारामिटरहरू विशिष्ट SMS/Viber प्यारामिटरहरूद्वारा ओभरराइड गर्न सकिन्छ।
  • सामग्री: Viber carousels, सर्वेक्षण, फाइल संलग्न, र अन्तरक्रियात्मक बटन समर्थन गर्दछ।
  • त्रुटि ह्यान्डलिङ: त्रुटिहरूको लागि पनि HTTP 200 फर्काउँछ (संरचित त्रुटि प्रतिक्रियाहरू)। प्रणाली त्रुटिहरूको लागि FATAL_ERROR स्थितिको साथ response_code: 999।
  • प्रापक त्रुटिहरू: विशिष्ट प्रापक त्रुटिहरू response_result array मा फर्काइन्छ। असफल प्राप्तकर्ताहरूसँग 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

यो विधिले तपाइँलाई एकल HTTP अनुरोधमा धेरै ‘पठाउनुहोस्’ अनुरोधहरू पठाउन अनुमति दिन्छ, जडान ओभरहेड बचत गर्दै। 100 अनुरोधहरूको लागि डाटाको साथ sendmulti कल गर्नु १०० व्यक्तिगत 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

तपाईंलाई SMS र Viber च्यानलहरूको लागि पूर्ण पेलोड विवरणहरू, मूल्य निर्धारण, र सही टाइमस्ट्याम्पहरू सहित सिर्जना गरिएका सन्देशहरू बारे विस्तृत जानकारी प्राप्त गर्न अनुमति दिन्छ।

अनुरोध उदाहरण

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