Help Center API SMSBAT

API SMSBAT

SMSBAT to platforma API RESTful do wysyłania różnych typów wiadomości, w tym karuzeli Viber, okna opinii Viber, promocji Viber (zdjęcia, wideo), czatu biznesowego Viber, powiadomień OTP (Viber OTP, Flash Call) i ich wariantów awaryjnych.

Podstawowy adres URL

Żądania do SMSBAT API są przesyłane do punktu końcowego z lokalizacją. Poproś wcześniej o adres swojego menedżera.

Przykład: https://restapi.smsbat.com (rzeczywisty adres URL może się różnić w zależności od regionu)

Uwierzytelnianie

SMSBAT API obsługuje trzy metody uwierzytelniania:

Metoda 1: Podstawowe uwierzytelnianie HTTP

Użyj swojej nazwy użytkownika i hasła:

curl -X POST https://restapi.smsbat.com/bat/messagelist \
  -u "username:password" \
  -H "Content-Type: application/json" \
  -d @request.json

Metoda 2: Nagłówek klucza API

Użyj nagłówka X-Authorization-Key:

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

Metoda 3: Klucz API jako hasło

Użyj @ jako nazwy użytkownika i klucza API jako hasła:

curl -X POST https://restapi.smsbat.com/bat/messagelist \
  -u "@:your-api-key" \
  -H "Content-Type: application/json" \
  -d @request.json

Dostępne punkty końcowe

MetodaPunkt końcowyOpis
POST/bat/lista wiadomościWyślij wiadomości
OTRZYMAJ/bat/message/{messageId}Sprawdź status wiadomości

Typy wiadomości

SMSBAT API obsługuje następujące typy wiadomości:

  • SMS - Standardowe wiadomości tekstowe
  • Promocja Viber - Komunikaty promocyjne z multimediami
  • Viber Transactional - Powiadomienia o transakcjach
  • Viber Carousel - Interaktywne wiadomości karuzelowe
  • Ankieta Viber – Okno dialogowe z opiniami
  • Viber OTP - Jednorazowe powiadomienia o hasłach
  • RCS – wiadomości Rich Communication Services
  • Połączenie Flash - Weryfikacja cichego połączenia

Kluczowe funkcje

Wiadomości zastępcze

W przypadku niepowodzenia dostawy podstawowej SMSBAT automatycznie powraca do kanałów alternatywnych:

Viber → SMS → Email

Obsługa multimediów

Wysyłaj wiadomości za pomocą:

  • Obrazy (JPG, PNG)
  • Filmy (MP4)
  • Pliki PDF
  • Przyciski i linki akcji

Śledzenie statusu wiadomości

Śledź status dostawy w czasie rzeczywistym:

  • Wysłano
  • Dostarczono
  • Przeczytaj
  • Nie udało się
  • Wygasło

Oddzwonienia

Otrzymuj przychodzące wywołania zwrotne wiadomości Viber w celu komunikacji dwukierunkowej.

Szybki start

  1. Wyślij wiadomość – Dowiedz się, jak wysłać pierwszą wiadomość
  2. Sprawdź status – Śledź status dostarczenia wiadomości
  3. Typy wiadomości — poznaj różne typy wiadomości

##Format żądania

Wszystkie żądania korzystają z formatu JSON o następującej strukturze:

curl -X POST https://restapi.smsbat.com/bat/messagelist \
  -H "X-Authorization-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "messages": [
      {
        "from": "ALPHANAME",
        "to": "380501234567",
        "text": "Hello! This is a test message from the Try It section.",
        "type": "sms"
      }
    ]
  }'

##Format odpowiedzi

Pomyślne odpowiedzi zwracają:

{
  "messages": [
    {
      "recipient": "+380XXXXXXXXX",
      "type": "viber",
      "text": "Your message here",
      // ... additional parameters
    }
  ]
}

Obsługa błędów

Kody stanu HTTP:

  • 200 OK - Żądanie powiodło się
  • 400 Bad Request - Nieprawidłowy format żądania
  • 401 Nieautoryzowane - Uwierzytelnienie nie powiodło się
  • 429 Too Many Requests - Przekroczono limit szybkości
  • 500 Wewnętrzny błąd serwera - Błąd serwera

Następne kroki