შიგთავსზე გადასვლა

კასკადი API

Cascade API საშუალებას გაძლევთ გაგზავნოთ შეტყობინებები მრავალ პლატფორმაზე ერთი მოთხოვნით, ავტომატურად გადადის Telegram Bot-ზე, Viber Bot-ზე, Viber Business Messages-ზე, RCS-ზე და SMS-ზე.

საბაზისო URL

https://restapi.smsbat.com

ავტორიზაცია

Cascade API იყენებს სათაურზე დაფუძნებულ ავთენტიფიკაციას სამი შესაძლო ავტორიზაციის სათაურით:

მეთოდი 1: 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

მეთოდი 2: Viber Bot Token

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

მეთოდი 3: Telegram Bot Key

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 ტელეგრამის პრიორიტეტული კასკადი

როგორ მუშაობს

ერთი API მოთხოვნით, Cascade ავტომატურად აწვდის თქვენს შეტყობინებას რამდენიმე არხზე:

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

შეტყობინება მიეწოდება პირველი ხელმისაწვდომი არხით, ავტომატური სარეზერვო შემდეგ არხზე, თუ მიწოდება ვერ მოხერხდა.

ძირითადი მახასიათებლები

მრავალარხიანი მიწოდება

გაგზავნეთ ერთი შეტყობინება, მიაღწიეთ მომხმარებლებს ნებისმიერ პლატფორმაზე:

  • Telegram Bot
  • Viber Bot
  • Viber Business Messages
  • RCS (Rich Communication Services)
  • SMS

ცვლადის ჩანაცვლება

გამოიყენეთ დინამიური კონტენტი ცვლადი ჩანაცვლებით:

  • %name=id% - ტექსტური ცვლადები
  • %url=id% - URL ცვლადები
  • %short_url=id% - შემოკლებული URL ცვლადები

შეტყობინებების დაგეგმვა

დაგეგმეთ შეტყობინებები მომავალი მიწოდებისთვის:

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

სიცოცხლის დრო (TTL)

დააყენეთ შეტყობინებების ვადის გასვლის დრო:

{
  "ttl": 3600
}

შეტყობინების ტიპები

Cascade API მხარს უჭერს:

  • **ტრანზაქციის ** - შეკვეთის დადასტურებები, შეტყობინებები
  • პრომო - მარკეტინგული და სარეკლამო შეტყობინებები
  • Viber Surveys - ინტერაქტიული გამოკითხვები
  • ** ფლეშ ზარები ** - ტელეფონის გადამოწმება

პასუხის ფორმატი

წარმატებული პასუხები ბრუნდება:

[
  {
    "messageId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "trackinId": "tracking-string-id"
  }
]
  • messageId - GUID შეტყობინების იდენტიფიკაციისთვის
  • trackinId - სტრიქონი მიწოდების სტატუსის თვალყურის დევნებისთვის

სწრაფი დაწყება

  1. Send Messages - დაიწყეთ კასკადური შეტყობინებების გაგზავნა
  2. Message Variables - გამოიყენეთ დინამიური კონტენტი
  3. შეტყობინებების ტიპები - შეისწავლეთ შეტყობინების ტიპები

მოითხოვეთ მაგალითი

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

შეცდომის დამუშავება

HTTP სტატუსის კოდები:

  • 200 OK - მოთხოვნა წარმატებით დასრულდა
  • 400 ცუდი მოთხოვნა - არასწორი მოთხოვნის ფორმატი
  • 401 არაავტორიზებული - ავტორიზაცია ვერ მოხერხდა
  • 429 ძალიან ბევრი მოთხოვნა - განაკვეთის ლიმიტი გადაჭარბებულია
  • 500 შიდა სერვერის შეცდომა - სერვერის შეცდომა

სარგებელი

ერთიანი ინტეგრაცია

ერთი API ინტეგრაცია ყველა შეტყობინებების არხისთვის - არ არის საჭირო თითოეულ პლატფორმასთან ცალკე ინტეგრირება.

ავტომატური მარშრუტიზაცია

ჭკვიანი მარშრუტი უზრუნველყოფს შეტყობინების მიწოდებას საუკეთესო ხელმისაწვდომი არხის მეშვეობით თითოეული მიმღებისთვის.

ხარჯების ოპტიმიზაცია

კასკადი ჯერ ცდის უფრო იაფ არხებს, ავტომატურად უბრუნდება უფრო ძვირ ვარიანტებს მხოლოდ საჭიროების შემთხვევაში.

უფრო მაღალი მიწოდების ტარიფები

მრავალი სარეზერვო არხი უზრუნველყოფს, რომ თქვენი შეტყობინება მიაღწევს მიმღებს, მაშინაც კი, თუ პირველადი არხი ვერ ხერხდება.

შემდეგი ნაბიჯები