Przejdź do treści

Wysyłaj wiadomości kaskadowe

Wysyłaj wiadomości wieloma kanałami za pomocą jednego żądania API. Cascade automatycznie kieruje Twoją wiadomość przez Telegram Bot, Viber Bot, Viber Business Messages, RCS i SMS.

Punkty końcowe

Standardowa kaskada

KOD_BLOKU_0

Kieruje wiadomości po kolei przez wszystkie dostępne kanały.

Priorytet Telegramu-Vibera

KOD_BLOKU_1

Nadaje priorytet kanałom Telegram i Viber w celu szybszej dostawy.

Uwierzytelnianie

Cascade API obsługuje trzy nagłówki uwierzytelniania. Uwzględnij co najmniej jeden:

Nagłówek Opis
Klucz autoryzacyjny X Klucz API SMSBAT (zalecany)
Token uwierzytelniania X-Viber Dane uwierzytelniające bota Viber
Klucz X-Tg-Bota Klucz bota telegramu

Struktura żądania

Nagłówki

KOD_BLOKU_2

Treść żądania

Wyślij tablicę obiektów wiadomości:

KOD_BLOKU_3

Parametry

Parametr Wpisz Wymagane Opis
id ciąg Tak Twój identyfikator śledzenia
odNazwa ciąg Tak Wyświetlana nazwa nadawcy
na telefon ciąg Tak Numer telefonu odbiorcy (format E.164)
typ wiadomości ciąg Tak Typ wiadomości: transakcja, promo, viber_survey, flashcall
tekst ciąg Tak* Treść wiadomości (*wymagana w przypadku większości typów)
ttl liczba całkowita Nie Czas życia w sekundach
zaplanowaneWysłanie ciąg Nie Data i godzina ISO 8601 dla zaplanowanej dostawy

Typy wiadomości

Wiadomości transakcyjne

Krytyczne powiadomienia, takie jak potwierdzenia zamówień i aktualizacje konta:

KOD_BLOKU_4

Wiadomości promocyjne

Kampanie marketingowe z rich media:

KOD_BLOKU_5

Ankieta Vibera

Interaktywne ankiety z 2-5 opcjami odpowiedzi:

KOD_BLOKU_6

Maksymalny tekst ankiety: 85 znaków

Połączenie błyskawiczne

Weryfikacja telefoniczna poprzez połączenie automatyczne:

KOD_BLOKU_7

Przykłady

Transakcja podstawowa

KOD_BLOKU_8

Zaplanowana promocja

KOD_BLOKU_9

Wiadomości zbiorcze

KOD_BLOKU_10

Odpowiedź

Odpowiedź pomyślna

KOD_BLOKU_11

Pola odpowiedzi

Pole Wpisz Opis
Identyfikator wiadomości ciąg znaków (UUID) Identyfikator komunikatu systemowego
Identyfikator śledzenia ciąg Twój identyfikator śledzenia (z żądania)

Użyj messageId do śledzenia statusu i trackinId do korelacji z systemem.

Przykłady implementacji

Pythona

KOD_BLOKU_12

JavaScript (Node.js)

KOD_BLOKU_13

PHP

KOD_BLOKU_14

Najlepsze praktyki

Numery telefonów

Zawsze używaj formatu E.164: - ✅+380XXXXXXXXX - ❌ 380XXXXXXXXX - ❌ 0XXXXXXXXX

Identyfikatory śledzenia

  • Używaj unikalnych identyfikatorów dla każdej wiadomości
  • Uwzględnij kontekst w identyfikatorze (np. „zamówienie-12345”, „promo-lato-2025”)
  • Trzymaj identyfikatory poniżej 255 znaków
  • Unikaj znaków specjalnych

TTL (czas życia)

Zalecane wartości TTL:

  • OTP/Weryfikacja: 300-600 sekund (5-10 minut)
  • Transakcyjne: 3600–86400 sekund (1–24 godziny)
  • Promocyjne: 86400-259200 sekund (1-3 dni)
  • Ankiety: 604800 sekund (7 dni)

Zaplanowane wiadomości

  • Użyj strefy czasowej UTC dla „scheduledSent”.
  • Nie planuj z wyprzedzeniem większym niż 30 dni
  • Uwzględnij różnice stref czasowych
  • Najpierw przetestuj harmonogramy z najbliższą przyszłością

Wysyłanie zbiorcze

  • Wysyłaj partiami po 100-1000 wiadomości
  • Wprowadź ograniczenie szybkości
  • Radź sobie z błędami z wdziękiem
  • Spróbuj ponownie nieudanych wiadomości

Obsługa błędów

Kody stanu HTTP

Kod Opis
200 Sukces
400 Złe żądanie - nieprawidłowe parametry
401 Nieautoryzowany - nieprawidłowy klucz API
429 Zbyt wiele żądań
500 Błąd serwera

Odpowiedź na błąd

KOD_BLOKU_15

Ponów próbę logiczną

KOD_BLOKU_16

Następne kroki