Vai al contenuto

Messaggi SMS

Invia messaggi di testo standard utilizzando l'API SMSBAT. Gli SMS sono il canale di messaggistica più universale con i tassi di consegna più elevati su tutti i dispositivi mobili.

Panoramica

SMS (Short Message Service) è ideale per:

  • Notifiche urgenti
  • Fallback per messaggi Viber/RCS
  • Raggiungere gli utenti senza smartphone
  • Compatibilità universale su tutte le reti mobili
  • Tassi di consegna elevati (95%+)

Messaggio SMS di base

Richiesta

{
  "from": "YourSender",
  "to": "+380XXXXXXXXX",
  "type": "sms",
  "text": "Your SMS message text"
}

Parametri

Parametro Digitare Obbligatorio Descrizione
"da" stringa Sì ID mittente alfanumerico (fino a 11 caratteri)
"a" stringa Sì Numero di telefono del destinatario in formato E.164
"tipo" stringa Sì Imposta su "sms"
"testo" stringa Sì Contenuto del messaggio
customerMessageId stringa No Il tuo ID di monitoraggio interno
ttl intero No Tempo di vita in secondi

Esempi

SMS semplici

curl -X POST https://restapi.smsbat.com/bat/messagelist \
  -H "X-Authorization-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "messages": [{
      "from": "YourBrand",
      "to": "+380XXXXXXXXX",
      "type": "sms",
      "text": "Hello! This is a test SMS message."
    }]
  }'

SMS con ID cliente

CODICE_BLOCCO_2

SMS con TTL

{
  "messages": [{
    "from": "YourApp",
    "to": "+380XXXXXXXXX",
    "type": "sms",
    "text": "Your verification code is: 123456",
    "ttl": 300
  }]
}

Codifica dei caratteri

Codifica GSM a 7 bit

Alfabeto GSM standard (160 caratteri per SMS):

A-Z a-z 0-9
@ £ $ ¥ è é ù ì ò Ç Ø ø Å å
Δ _ Φ Γ Λ Ω Π Ψ Σ Θ Ξ
! " # % & ' ( ) * + , - . / : ; < = > ?

Caratteri GSM estesi

Questi caratteri contano come 2 caratteri:

CODICE_BLOCCO_5

Codifica Unicode (UCS-2).

I messaggi con caratteri speciali utilizzano la codifica Unicode (70 caratteri per SMS):

  • Emoji: 😀 🎉 ❤️
  • Cirillico: А Б В Ã Д Е Ж
  • Simboli speciali: ✓ ✗ ★ ♥

Lunghezza del messaggio

SMS singolo

  • GSM 7 bit: 160 caratteri
  • Unicode: 70 caratteri

SMS in più parti

Quando il tuo messaggio supera il limite, viene suddiviso in più parti:

  • GSM 7 bit: 153 caratteri per parte
  • Unicode: 67 caratteri per parte

Esempio

CODICE_BLOCCO_6

Questo messaggio (201 caratteri) sarà diviso in 2 parti.

Risposta

Risposta riuscita

CODICE_BLOCCO_7

Campi di risposta

Campo Descrizione
messaggioId Identificatore univoco per il monitoraggio
stato Stato del messaggio (accettato, rifiutato)
"parti" Numero di parti SMS
"a" Numero di telefono del destinatario

ID mittente

Mittente alfanumerico

Utilizza il nome del tuo marchio come mittente (fino a 11 caratteri):

{
  "from": "YourBrand",
  "to": "+380XXXXXXXXX",
  "type": "sms",
  "text": "Hello from YourBrand!"
}

Restrizioni:

  • Massimo 11 caratteri
  • Solo lettere e numeri
  • Nessuno spazio o carattere speciale
  • Il destinatario non può rispondere a mittenti alfanumerici

Mittente numerico

Utilizza un numero di telefono come mittente (per SMS bidirezionali):

{
  "from": "+380123456789",
  "to": "+380XXXXXXXXX",
  "type": "sms",
  "text": "Hello! You can reply to this message."
}

Casi d'uso

Verifica OTP

{
  "from": "YourApp",
  "to": "+380XXXXXXXXX",
  "type": "sms",
  "text": "Your verification code is: 123456. Valid for 5 minutes.",
  "ttl": 300
}

Notifiche sugli ordini

{
  "from": "YourStore",
  "to": "+380XXXXXXXXX",
  "type": "sms",
  "text": "Your order #12345 has been delivered. Thank you for shopping with us!"
}

Promemoria appuntamenti

CODICE_BLOCCO_12

Conferme di pagamento

{
  "from": "YourBank",
  "to": "+380XXXXXXXXX",
  "type": "sms",
  "text": "Payment of 100 USD to Merchant ABC was successful. Transaction ID: 789xyz"
}

Migliori pratiche

Contenuto del messaggio

  • ✅ Mantieni i messaggi concisi e chiari
  • ✅ Includere l'identificazione del mittente
  • ✅ Aggiungi un invito all'azione se necessario
  • ✅Utilizzare la grammatica e l'ortografia corrette
  • ❌Evita la punteggiatura eccessiva!!!
  • ❌Non utilizzare tutto MAIUSCOLO
  • ❌ Evita gli abbreviatori URL che sembrano sospetti

Utilizzo dei caratteri

  • Controlla il conteggio dei caratteri prima dell'invio
  • Fare attenzione ai caratteri GSM estesi (contare come 2)
  • Prova con caratteri speciali prima dell'invio in blocco
  • Considera l'utilizzo della codifica GSM per i messaggi più lunghi

Numeri di telefono

  • Utilizza sempre il formato E.164: +380XXXXXXXXX
  • Convalidare i numeri di telefono prima dell'invio
  • Rimuovi i numeri non validi dal tuo elenco
  • Mantieni aggiornata la tua lista dei contatti

Tempistica

  • Rispettare i fusi orari locali
  • Evitare l'invio di notte (22:00 - 8:00)
  • Considera l'orario lavorativo per i messaggi commerciali
  • Imposta il TTL appropriato per i messaggi urgenti

Conformità

  • Ottenere il consenso prima di inviare messaggi di marketing
  • Includere istruzioni per la disattivazione degli SMS promozionali
  • Seguire le normative locali (GDPR, ecc.)
  • Rispettare le liste "Non disturbare".

Gestione degli errori

Errori comuni

Errore Causa Soluzione
DESTINATARIO_NON VALIDO Formato telefono errato Utilizza il formato E.164
MITTENTE_INVALID ID mittente non valido Controlla le regole dell'ID mittente
MESSAGGIO_TOO_LONG Supera la lunghezza massima Dividere o abbreviare il messaggio
CODIFICA_INVALIDA Caratteri non supportati Utilizza GSM o Unicode

Ottimizzazione dei costi

Riduci le parti del messaggio

  • Mantieni i messaggi sotto i 160 caratteri (GSM) o 70 (Unicode)
  • Evita caratteri speciali che attivano Unicode
  • Utilizzare le abbreviazioni quando opportuno
  • Rimuovere gli spazi non necessari

Esempio di ottimizzazione

❌ Prima (171 caratteri, 2 SMS): CODICE_BLOCCO_14

✅ Dopo (156 caratteri, 1 SMS): CODICE_BLOCCO_15

Invio in blocco

Invia più messaggi in un'unica richiesta:

{
  "messages": [
    {
      "from": "YourBrand",
      "to": "+380111111111",
      "type": "sms",
      "text": "Message 1"
    },
    {
      "from": "YourBrand",
      "to": "+380222222222",
      "type": "sms",
      "text": "Message 2"
    },
    {
      "from": "YourBrand",
      "to": "+380333333333",
      "type": "sms",
      "text": "Message 3"
    }
  ]
}

Passaggi successivi