Vai al contenuto

API SMSBAT

SMSBAT è una piattaforma API RESTful per l'invio di vari tipi di messaggi tra cui carosello Viber, dialogo di opinione Viber, promo Viber (immagini, video), chat aziendale Viber, notifiche OTP (Viber OTP, Flash Call) e le relative varianti di fallback.

URL di base

Le richieste all'API SMSBAT vengono trasmesse a un endpoint con localizzazione. Richiedi in anticipo l'indirizzo al tuo manager.

Esempio: https://restapi.smsbat.com (l'URL effettivo può variare in base alla regione)

Autenticazione

L'API SMSBAT supporta tre metodi di autenticazione:

Metodo 1: autenticazione HTTP di base

Utilizza le tue credenziali nome utente e password:

curl -X POST https://restapi.smsbat.com/bat/messagelist \
  -u "username:password" \
  -H "Content-Type: application/json" \
  -d @request.json

Metodo 2: intestazione della chiave API

Utilizza l'intestazione "X-Authorization-Key":

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

Metodo 3: chiave API come password

Utilizza @ come nome utente e la chiave API come password:

CODICE_BLOCCO_2

Endpoint disponibili

Metodo Punto finale Descrizione
POST /bat/messagelist Invia messaggi
OTTIENI /bat/messaggio/{messageId} Controlla lo stato del messaggio

Tipi di messaggi

L'API SMSBAT supporta i seguenti tipi di messaggi:

  • SMS - Messaggi di testo standard
  • Promo Viber - Messaggi promozionali con rich media
  • Viber Transactional - Notifiche di transazione
  • Viber Carousel - Messaggi carosello interattivi
  • Sondaggio Viber - Messaggi di dialogo sulle opinioni
  • Viber OTP - Notifiche password monouso
  • RCS - Messaggi Rich Communication Services
  • Chiamata Flash - Verifica della chiamata silenziosa

Caratteristiche principali

Messaggi di riserva

Quando la consegna principale fallisce, SMSBAT torna automaticamente a canali alternativi:

Viber → SMS → Email

Supporto Rich Media

Invia messaggi con:

  • Immagini (JPG, PNG)
  • Video (MP4)
  • PDF
  • Pulsanti e collegamenti di azione

Monitoraggio dello stato dei messaggi

Tieni traccia dello stato della consegna in tempo reale:

  • Inviato
  • Consegnato
  • Leggi
  • Fallito
  • Scaduto

Richiami

Ricevi richiamate di messaggi Viber in arrivo per la comunicazione bidirezionale.

Avvio rapido

  1. Invia un messaggio: scopri come inviare il tuo primo messaggio
  2. Verifica stato - Tieni traccia dello stato di consegna dei messaggi
  3. Tipi di messaggio: esplora diversi tipi di messaggio

Richiedi formato

Tutte le richieste utilizzano il formato JSON con la seguente struttura:

{
  "messages": [
    {
      "recipient": "+380XXXXXXXXX",
      "type": "viber",
      "text": "Your message here",
      // ... additional parameters
    }
  ]
}

Formato della risposta

Le risposte riuscite restituiscono:

CODICE_BLOCCO_5

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

Passaggi successivi