Przejdź do treści

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:

KOD_BLOKU_0

Metoda 2: Nagłówek klucza API

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

KOD_BLOKU_1

Metoda 3: Klucz API jako hasło

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

KOD_BLOKU_2

Dostępne punkty końcowe

Metoda Punkt końcowy Opis
POST /bat/lista wiadomości Wyś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:

KOD_BLOKU_3

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:

KOD_BLOKU_4

Format odpowiedzi

Pomyślne odpowiedzi zwracają:

KOD_BLOKU_5

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