Help Center TurboSMS API თავსებადობა

TurboSMS API თავსებადობა

SMSBAT სრულად უჭერს მხარს თავსებადობის ფენას TurboSMS API-თან. ეს საშუალებას გაძლევთ გადაიტანოთ თქვენი არსებული ინტეგრაციები, რომლებიც შექმნილია TurboSMS-ისთვის პირდაპირ SMSBAT-ზე, შეტყობინებების სტრუქტურების ან საბოლოო წერტილის დატვირთვის გადაწერის გარეშე.

ჩვენ მხარს ვუჭერთ SMS და Viber შეტყობინებების გაგზავნას (მოწინავე ფუნქციების ჩათვლით, როგორიცაა კარუსელები და გამოკითხვები), სტატუსების მიღება და შეტყობინების დეტალების მიღება ზუსტად იმავე მოთხოვნის სხეულის სტრუქტურების გამოყენებით, რომლებსაც უკვე იცნობთ.

ავტორიზაცია

ერთადერთი განსხვავება მშობლიური TurboSMS API-სგან არის ავთენტიფიკაციის მექანიზმი. მიუხედავად იმისა, რომ TurboSMS იყენებს მორგებულ token შეკითხვის პარამეტრს ან კონკრეტულ auth header-ს, SMSBAT მოითხოვს სტანდარტულ Bearer Token.

თქვენ უნდა შეიტანოთ თქვენი SMSBAT API ჟეტონი ავტორიზაციის სათაურში ყველა მოთხოვნისთვის:

Authorization: Bearer YOUR_SMSBAT_TOKEN

საბაზისო URL

ყველა საბოლოო წერტილი უნდა იყოს მიმართული SMSBAT API საბაზისო URL-ზე:

https://restapi.smsbat.com

გაგზავნეთ ერთი შეტყობინება

ბოლო წერტილი: POST /api/tsms/message/send

საშუალებას აძლევს გაგზავნოს SMS და Viber შეტყობინებები ჰიბრიდული მიწოდების მხარდაჭერით (Viber SMS სარეზერვო საშუალებით). ის ამუშავებს გაგზავნის ერთ მოთხოვნას და აბრუნებს მიწოდების შედეგებს თითოეული მიმღებისთვის.

ძირითადი შესაძლებლობები

  • მოქნილი პარამეტრები: გლობალური პარამეტრების გადაფარვა შესაძლებელია კონკრეტული SMS/Viber პარამეტრებით.
  • კონტენტი: მხარს უჭერს Viber-ის კარუსელებს, გამოკითხვებს, ფაილების დანართებს და ინტერაქტიულ ღილაკებს.
  • Error Handling: აბრუნებს HTTP 200 შეცდომებზეც კი (სტრუქტურირებული შეცდომის პასუხები). პასუხის_კოდი: 999 სტატუსით FATAL_ERROR სისტემის შეცდომებისთვის.
  • მიმღების შეცდომები: მიმღების კონკრეტული შეცდომები ბრუნდება პასუხის_შედეგის~ მასივში. წარუმატებელ მიმღებებს აქვთ 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"
      }
    ]
  }
}

მოთხოვნის მაგალითი (Viber Survey)

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

გაგზავნეთ მრავალი შეტყობინებები (Batch)

ბოლო წერტილი: POST /api/tsms/message/sendmulti

ეს მეთოდი საშუალებას გაძლევთ გააგზავნოთ მრავალი გაგზავნა მოთხოვნა ერთ HTTP მოთხოვნაში, რაც დაზოგავს კავშირს. “sendmulti”-ის დარეკვა 100 მოთხოვნის მონაცემებით უფრო სწრაფი იქნება, ვიდრე 100 ინდივიდუალური “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"
        }
    ]
}