Help Center Messaggi SMS

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

Messaggi Viber - Messaggi rich media
Messaggi RCS - Rich Communication Services
Verifica stato - Tieni traccia dello stato della consegna
Strategie di fallback - Configura i fallback

Search Results