Przejdź do treści

Kaskadowe API

Cascade API umożliwia wysyłanie wiadomości na wiele platform za pomocą jednego żądania, automatycznie przekierowując je do Telegram Bot, Viber Bot, Viber Business Messages, RCS i SMS.

Podstawowy adres URL

KOD_BLOKU_0

Uwierzytelnianie

Cascade API wykorzystuje uwierzytelnianie oparte na nagłówkach z trzema możliwymi nagłówkami uwierzytelniania:

Metoda 1: Klucz API SMSBAT

KOD_BLOKU_1

Metoda 2: Token bota Viber

KOD_BLOKU_2

Metoda 3: Klucz bota telegramu

KOD_BLOKU_3

Dostępne punkty końcowe

Metoda Punkt końcowy Opis
POST /api/CascadeMessage/send_message/async Ogólne kaskadowe wysyłanie wiadomości
POST /api/CascadeMessage/send_message/tg-viber/async Kaskada z priorytetem telegramu

Jak to działa

Dzięki pojedynczemu żądaniu API Cascade automatycznie dostarcza Twoją wiadomość wieloma kanałami:

KOD_BLOKU_4

Wiadomość jest dostarczana pierwszym dostępnym kanałem, z automatycznym powrotem do następnego kanału w przypadku niepowodzenia dostarczenia.

Kluczowe funkcje

Dostarczanie wielokanałowe

Wyślij jedną wiadomość, dotrzyj do użytkowników na dowolnej platformie:

  • Bot telegramowy
  • Bot Vibera
  • Wiadomości biznesowe Viber
  • RCS (bogate usługi komunikacyjne)
  • SMS-em

Podstawianie zmiennych

Użyj treści dynamicznych ze zmiennymi symbolami zastępczymi:

  • %name=id% - Zmienne tekstowe
  • %url=id% - Zmienne URL
  • %short_url=id% - Skrócone zmienne URL

Planowanie wiadomości

Zaplanuj wiadomości do dostarczenia w przyszłości:

KOD_BLOKU_5

Czas życia (TTL)

Ustaw czas ważności wiadomości:

KOD_BLOKU_6

Typy wiadomości

Cascade API obsługuje:

  • Transakcyjne - Potwierdzenia zamówień, powiadomienia
  • Promo - Komunikaty marketingowe i promocyjne
  • Ankiety Viber - Ankiety interaktywne
  • Połączenia Flash - Weryfikacja telefoniczna

Format odpowiedzi

Pomyślne odpowiedzi zwracają:

KOD_BLOKU_7

  • messageId - GUID do identyfikacji wiadomości
  • trackinId - Ciąg do śledzenia statusu dostawy

Szybki start

  1. Wyślij wiadomości - Rozpocznij wysyłanie wiadomości kaskadowych
  2. Zmienne wiadomości — Użyj treści dynamicznych
  3. Typy wiadomości – Przeglądaj typy wiadomości

Przykład żądania

KOD_BLOKU_8

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

Korzyści

Pojedyncza integracja

Jedna integracja API dla wszystkich kanałów komunikacji – nie ma potrzeby integracji z każdą platformą osobno.

Automatyczne wyznaczanie tras

Inteligentny routing zapewnia dostarczanie wiadomości najlepszym dostępnym kanałem dla każdego odbiorcy.

Optymalizacja kosztów

Cascade najpierw wypróbowuje tańsze kanały, automatycznie powracając do droższych opcji tylko wtedy, gdy zajdzie taka potrzeba.

Wyższe stawki za dostawę

Wiele kanałów zastępczych gwarantuje, że wiadomość dotrze do odbiorcy nawet w przypadku awarii kanału głównego.

Następne kroki

– Wysyłaj wiadomości kaskadowe – Dowiedz się, jak wysyłać wiadomości - Zmienne wiadomości - Pracuj z zawartością dynamiczną – Typy wiadomości – Przeglądaj dostępne typy wiadomości