Wyślij wiadomość

Wysyłaj wiadomości poprzez API SMSBAT używając punktu końcowego /bat/messagelist.

Punkt końcowy

KOD_BLOKU_0

Struktura żądania

Treść żądania to tablica JSON zawierająca obiekty komunikatów:

KOD_BLOKU_1

Parametry

Wymagane parametry

Parametr	Wpisz	Opis
od	ciąg	Alfanumeryczny identyfikator nadawcy
do	ciąg	Numer telefonu odbiorcy w formacie E.164 (np. +380XXXXXXXXX)
typ	ciąg	Typ wiadomości: sms, viber_promo, viber_trans, viber_carousel, viber_survey, viber_otp, rcs, flashcall
tekst	ciąg	Treść wiadomości (wymagana dla większości typów, opcjonalna dla niektórych)

Parametry opcjonalne

Parametr	Wpisz	Opis
Identyfikator wiadomości klienta	ciąg	Twój wewnętrzny identyfikator do śledzenia
ttl	liczba całkowita	Czas życia w sekundach
Dane wiadomości	obiekt	Konfiguracja specyficzna dla typu (różni się w zależności od typu komunikatu)

Uwierzytelnianie

Wybierz jedną z trzech metod uwierzytelniania:

=== „Nagłówek klucza API”

__KOD_BLOKU_2__

=== „Podstawowe uwierzytelnianie HTTP”

__KOD_BLOKU_3__

=== „Klucz API jako hasło”

__KOD_BLOKU_4__

Odpowiedź

Odpowiedź pomyślna

KOD_BLOKU_5

Pola odpowiedzi

Pole	Wpisz	Opis
Identyfikator listy wiadomości	liczba całkowita	Unikalny identyfikator listy wiadomości
Identyfikator wiadomości	ciąg	Unikalny identyfikator każdej wiadomości
stan	ciąg	Status wiadomości: „zaakceptowana”, „odrzucona”, „nieudana”
części	liczba całkowita	Liczba części wiadomości (dla wiadomości SMS)
Identyfikator wiadomości klienta	ciąg	Twój wewnętrzny identyfikator (jeśli został podany)
do	ciąg	Numer telefonu odbiorcy

Typy wiadomości

SMS-y

Proste wiadomości tekstowe:

KOD_BLOKU_6

Promocja Vibera

Przekazy promocyjne z rich media:

KOD_BLOKU_7

Transakcje Vibera

Powiadomienia o transakcjach:

KOD_BLOKU_8

Viber OTP

Jednorazowe powiadomienia o hasłach:

KOD_BLOKU_9

Obsługa błędów

Kody stanu HTTP

Kod	Opis
200	Żądanie powiodło się
400	Złe żądanie - nieprawidłowe parametry
401	Nieautoryzowane - uwierzytelnienie nie powiodło się
429	Zbyt wiele żądań - przekroczono limit szybkości
500	Wewnętrzny błąd serwera

Odpowiedź na błąd

KOD_BLOKU_10

Najlepsze praktyki

Format numeru telefonu

Zawsze używaj formatu E.164 dla numerów telefonów:

• ✅ Poprawnie: +380XXXXXXXXX
• ❌ Niepoprawnie: 380XXXXXXXXX, 0XXXXXXXXX

Tekst wiadomości

• Trzymaj SMS-y o długości poniżej 160 znaków, aby uniknąć wielu części
• Używaj kodowania UTF-8 dla znaków międzynarodowych
• Przetestuj znaki specjalne przed wysłaniem zbiorczym

TTL (czas życia)

• Ustaw odpowiedni TTL dla wiadomości wrażliwych na upływ czasu
• Wiadomości OTP: 300-600 sekund (5-10 minut)
• Wiadomości promocyjne: 3600-86400 sekund (1-24 godziny)

Identyfikator wiadomości klienta

• Używaj unikalnych identyfikatorów dla każdej wiadomości
• Pomaga w śledzeniu i debugowaniu
• Przydatne do korelacji z zapisami systemu

Limity stawek

Skontaktuj się ze swoim menedżerem konta, aby uzyskać informacje na temat:

• Wiadomości na sekundę
• Wiadomości dziennie
• Równoczesne połączenia

Następne kroki

– Wiadomości Viber – Poznaj typy wiadomości Viber - Wiadomości SMS - Dowiedz się więcej o SMS-ach - Sprawdź stan - Śledź dostarczenie wiadomości