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