Vai al contenuto

API a cascata

L'API Cascade consente di inviare messaggi su più piattaforme con un'unica richiesta, instradandoli automaticamente a Telegram Bot, Viber Bot, Viber Business Messages, RCS e SMS.

URL di base

https://restapi.smsbat.com

Autenticazione

L'API Cascade utilizza l'autenticazione basata su intestazioni con tre possibili intestazioni di autenticazione:

Metodo 1: chiave API SMSBAT

curl -X POST https://restapi.smsbat.com/api/CascadeMessage/send_message/async \
  -H "X-Authorization-Key: your-smsbat-api-key" \
  -H "Content-Type: application/json" \
  -d @request.json

Metodo 2: token Viber Bot

CODICE_BLOCCO_2

Metodo 3: Chiave Bot di Telegram

curl -X POST https://restapi.smsbat.com/api/CascadeMessage/send_message/async \
  -H "X-Tg-Bot-Key: your-telegram-bot-key" \
  -H "Content-Type: application/json" \
  -d @request.json

Endpoint disponibili

Metodo Punto finale Descrizione
POST /api/CascadeMessage/send_message/async Invio generale di messaggi in cascata
POST /api/CascadeMessage/send_message/tg-viber/async Cascata con priorità di Telegram

Come funziona

Con una singola richiesta API, Cascade consegna automaticamente il tuo messaggio su più canali:

Telegram Bot → Viber Bot → Viber Business → RCS → SMS

Il messaggio viene recapitato tramite il primo canale disponibile, con fallback automatico al canale successivo se la consegna fallisce.

Caratteristiche principali

Distribuzione multicanale

Invia un messaggio, raggiungi gli utenti su qualsiasi piattaforma:

  • Bot di Telegram
  • Viberbot
  • Messaggi aziendali Viber
  • RCS (Ricchi Servizi di Comunicazione)
  • SMS

Sostituzione di variabili

Utilizza contenuto dinamico con segnaposto variabili:

  • %name=id% - Variabili di testo
  • %url=id% - Variabili URL
  • %short_url=id% - Variabili URL abbreviate

Pianificazione dei messaggi

Pianifica i messaggi per la consegna futura:

CODICE_BLOCCO_5

Tempo di vita (TTL)

Imposta la scadenza per i messaggi:

CODICE_BLOCCO_6

Tipi di messaggi

L'API Cascade supporta:

  • Transazionale - Conferme d'ordine, notifiche
  • Promo - Messaggi di marketing e promozionali
  • Sondaggi Viber - Sondaggi interattivi
  • Chiamate Flash - Verifica del telefono

Formato della risposta

Le risposte riuscite restituiscono:

CODICE_BLOCCO_7

  • messageId - GUID per l'identificazione del messaggio
  • trackinId - Stringa per monitorare lo stato della consegna

Avvio rapido

  1. Invia messaggi - Inizia a inviare messaggi a cascata
  2. Variabili del messaggio - Utilizza contenuto dinamico
  3. Tipi di messaggio: esplora i tipi di messaggio

Esempio di richiesta

{
  "messages": [
    {
      "recipient": "+380XXXXXXXXX",
      "text": "Hello %name=1%, your order #%url=2% is ready!",
      "variables": [
        {
          "id": 1,
          "value": "John"
        },
        {
          "id": 2,
          "value": "12345"
        }
      ]
    }
  ]
}

Gestione degli errori

Codici di stato HTTP:

  • "200 OK" - Richiesta riuscita
  • "400 Bad Request" - Formato di richiesta non valido
  • "401 Non autorizzato" - Autenticazione fallita
  • "429 Troppe richieste" - Limite di velocità superato
  • "500 Errore interno del server" - Errore del server

Vantaggi

Integrazione unica

Un'integrazione API per tutti i canali di messaggistica: non è necessario integrarsi con ciascuna piattaforma separatamente.

Routing automatico

Il routing intelligente garantisce la consegna dei messaggi attraverso il miglior canale disponibile per ciascun destinatario.

Ottimizzazione dei costi

Cascade prova prima i canali più economici, per poi ricorrere automaticamente alle opzioni più costose solo quando necessario.

Tariffe di consegna più elevate

Più canali di fallback garantiscono che il tuo messaggio raggiunga il destinatario anche se il canale principale fallisce.

Passaggi successivi