SMS Gateway

Avvio rapido SMS

Invia codici OTP, avvisi e SMS transazionali in oltre 190 Paesi. Ogni messaggio restituisce una ricevuta di consegna per sapere che è arrivato.

Test senza SMS reali? Usa la Modalità Sandbox — nessun messaggio reale inviato, codici OTP prevedibili e nessuna fatturazione.

1Invia un SMS

Invia tramite POST il numero del destinatario e il testo del messaggio. Il campo from imposta l'ID mittente visibile all'utente (il supporto degli operatori varia per Paese).

POST/api/v1/connect-hub/sms

bash

curl -X POST https://api.novauth.com/api/v1/connect-hub/sms \
  -H "x-api-key: YOUR_API_KEY" \
  -H "x-account-id: YOUR_ACCOUNT_ID" \
  -H "Content-Type: application/json" \
  -d '{
    "to":   "+14155552671",
    "text": "Your verification code is 482951. Valid for 10 minutes.",
    "from": "Novauth"
  }'

200 OK — Risposta

json

{
  "messageId": "a3f2c1d0-4e5b-6c7d-8e9f-0a1b2c3d4e5f",  // save for delivery check
  "from":      "Novauth",
  "to":        "+14155552671"
}

Lunghezza del testo: I messaggi SMS sono limitati a 160 caratteri per segmento. I messaggi fino a 4 096 caratteri vengono accettati — vengono automaticamente suddivisi in segmenti concatenati e riassemblati sull'handset.

2Controlla lo stato di consegna

Interroga l'endpoint SDR (SMS Delivery Report) per verificare che il messaggio sia arrivato all'handset. Controlla poco dopo l'invio — la consegna tipica è inferiore a 5 secondi.

GET/api/v1/connect-hub/sms/{messageId}/sdr

bash

curl https://api.novauth.com/api/v1/connect-hub/sms/a3f2c1d0-.../sdr \
  -H "x-api-key: YOUR_API_KEY" \
  -H "x-account-id: YOUR_ACCOUNT_ID"

3Segnala l'esito della verifica

Una volta che l'utente ha inviato il codice ricevuto, invia tramite POST il risultato all'endpoint webhook per chiudere il record SMS e registrare l'esito.

POST/api/v1/connect-hub/sms/webhook

bash

# Report the verification outcome from your backend
curl -X POST https://api.novauth.com/api/v1/connect-hub/sms/webhook \
  -H "x-api-key: YOUR_API_KEY" \
  -H "x-account-id: YOUR_ACCOUNT_ID" \
  -H "Content-Type: application/json" \
  -d '{
    "id":     "a3f2c1d0-...",
    "status": "Success"
  }'

Riferimento API

POST/smsInvia un messaggio SMS

GET/sms/{messageId}/sdrOttieni il rapporto di consegna SMS

POST/sms/webhookSegnala l'esito della verifica

POST/sms/sdrElenca tutti i record SMS (paginato)

Corpo della richiesta — POST /sms

tostringrequiredTelefono del destinatario in formato E.164

textstringrequiredContenuto del messaggio (1–4 096 caratteri)

fromstringoptionalID mittente o numero (dipende dall'operatore)

Elenca tutti i record SMS

bash

# Paginated list of all SMS records
curl -X POST https://api.novauth.com/api/v1/connect-hub/sms/sdr \
  -H "x-api-key: YOUR_API_KEY" \
  -H "x-account-id: YOUR_ACCOUNT_ID" \
  -H "Content-Type: application/json" \
  -d '{
    "page": 1,
    "rows_per_page": 20,
    "sort_by": "created_at",
    "sort_direction": "DESC"
  }'