क्यास्केड API

क्यास्केड एपीआईले टेलिग्राम बट, भाइबर बट, भाइबर बिजनेस मेसेज, आरसीएस, र एसएमएसमा स्वचालित रूपमा राउट गर्दै, एउटै अनुरोधमा धेरै प्लेटफर्महरूमा सन्देशहरू पठाउन सक्षम बनाउँछ।

आधार URL

https://restapi.smsbat.com

प्रमाणीकरण

क्यास्केड एपीआईले तीन सम्भावित प्रमाणीकरण हेडरहरूसँग हेडर-आधारित प्रमाणीकरण प्रयोग गर्दछ:

विधि १: SMSBAT API कुञ्जी

curl -X POST https://restapi.smsbat.com/api/CascadeMessage/send_message/async \
  -H "X-Authorization-Key: your-smsbat-api-key" \
  -H "Content-Type: application/json" \
  -d @request.json

विधि २: भाइबर बोट टोकन

curl -X POST https://restapi.smsbat.com/api/CascadeMessage/send_message/async \
  -H "X-Viber-Auth-Token: your-viber-bot-token" \
  -H "Content-Type: application/json" \
  -d @request.json

विधि ३: टेलिग्राम बट कुञ्जी

curl -X POST https://restapi.smsbat.com/api/CascadeMessage/send_message/async \
  -H "X-Tg-Bot-Key: your-telegram-bot-key" \
  -H "Content-Type: application/json" \
  -d @request.json

उपलब्ध अन्तिम बिन्दुहरू

विधि	अन्तिम बिन्दु	विवरण
पोस्ट	`/api/CascadeMessage/send_message/async`	सामान्य क्यास्केड सन्देश पठाउँदै
पोस्ट	`/api/CascadeMessage/send_message/tg-viber/async`	टेलिग्राम-प्राथमिकता कास्केड

यसले कसरी काम गर्छ

एकल एपीआई अनुरोधको साथ, क्यास्केडले स्वचालित रूपमा धेरै च्यानलहरूमा तपाईंको सन्देश डेलिभर गर्दछ:

Telegram Bot → Viber Bot → Viber Business → RCS → SMS

सन्देश पहिलो उपलब्ध च्यानल मार्फत डेलिभर गरिन्छ, यदि डेलिभरी असफल भएमा अर्को च्यानलमा स्वचालित फलब्याकको साथ।

मुख्य विशेषताहरू

मल्टि-च्यानल डेलिभरी

एउटा सन्देश पठाउनुहोस्, कुनै पनि प्लेटफर्ममा प्रयोगकर्ताहरू सम्म पुग्नुहोस्:

टेलिग्राम बोट
भाइबर बोट
Viber व्यापार सन्देशहरू
RCS (रिच कम्युनिकेशन सर्भिस)
एसएमएस

चर प्रतिस्थापन

चर प्लेसहोल्डरहरूसँग गतिशील सामग्री प्रयोग गर्नुहोस्:

% नाम=आईडी% - पाठ चरहरू
%url=id% - URL चरहरू
%short_url=id% - छोटो URL चर

सन्देश तालिका

भविष्यको डेलिभरीको लागि सन्देशहरू अनुसूची गर्नुहोस्:

{
  "scheduledTime": "2025-01-24T12:00:00Z"
}

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

सन्देशहरूको लागि म्याद समाप्त हुने समय सेट गर्नुहोस्:

{
  "ttl": 3600
}

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

क्यास्केड API समर्थन गर्दछ:

लेनदेनात्मक - अर्डर पुष्टिकरण, सूचनाहरू
प्रोमो - मार्केटिङ र प्रचार सन्देशहरू
भाइबर सर्वेक्षणहरू - अन्तरक्रियात्मक सर्वेक्षणहरू
फ्लैश कलहरू - फोन प्रमाणिकरण

प्रतिक्रिया ढाँचा

सफल प्रतिक्रियाहरू फिर्ता:

[
  {
    "messageId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "trackinId": "tracking-string-id"
  }
]

messageId - सन्देश पहिचानको लागि GUID
trackinId - डेलिभरी स्थिति ट्र्याक गर्नको लागि स्ट्रिङ

द्रुत सुरुवात

Send Messages - क्यास्केड सन्देशहरू पठाउन सुरु गर्नुहोस्
सन्देश चर - गतिशील सामग्री प्रयोग गर्नुहोस्
सन्देशका प्रकारहरू - सन्देशका प्रकारहरू अन्वेषण गर्नुहोस्

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

{
  "messages": [
    {
      "recipient": "+380XXXXXXXXX",
      "text": "Hello %name=1%, your order #%url=2% is ready!",
      "variables": [
        {
          "id": 1,
          "value": "John"
        },
        {
          "id": 2,
          "value": "12345"
        }
      ]
    }
  ]
}

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

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

`२०० ठीक छ' - अनुरोध सफल भयो
`400 खराब अनुरोध' - अमान्य अनुरोध ढाँचा
४०१ अनाधिकृत - प्रमाणीकरण असफल भयो
`429 धेरै अनुरोधहरू' - दर सीमा नाघ्यो
५०० आन्तरिक सर्भर त्रुटि - सर्भर त्रुटि

फाइदाहरू

एकल एकीकरण

सबै सन्देश च्यानलहरूको लागि एपीआई एकीकरण - प्रत्येक प्लेटफर्मको साथ अलग-अलग एकीकृत गर्न आवश्यक छैन।

स्वचालित मार्ग

स्मार्ट राउटिङले प्रत्येक प्राप्तकर्ताको लागि उत्तम उपलब्ध च्यानल मार्फत सन्देश डेलिभरी सुनिश्चित गर्दछ।

लागत अनुकूलन

क्यास्केडले पहिले सस्तो च्यानलहरू प्रयास गर्दछ, आवश्यक पर्दा मात्र स्वचालित रूपमा थप महँगो विकल्पहरूमा फर्कन्छ।

उच्च डेलिभरी दरहरू

धेरै फलब्याक च्यानलहरूले प्राथमिक च्यानल असफल भए तापनि तपाईंको सन्देश प्रापकमा पुग्ने सुनिश्चित गर्दछ।

अर्को चरणहरू

क्यास्केड सन्देशहरू पठाउनुहोस् - सन्देशहरू पठाउने तरिका जान्नुहोस्
सन्देश चर - गतिशील सामग्रीसँग काम गर्नुहोस्
सन्देश प्रकारहरू - उपलब्ध सन्देश प्रकारहरू अन्वेषण गर्नुहोस्