Telefono (SMS)
Configurare il gateway che recapita i codici monouso via SMS o chiamata vocale (gateway integrato, Twilio o un gateway HTTP personalizzato).
Nota sul piano: un gateway SMS personalizzato è disponibile a partire dal piano Essential. Vedere Piani e add-on. Nei livelli inferiori la piattaforma invia i codici monouso tramite il proprio gateway integrato.
La piattaforma recapita via SMS i codici monouso per l'autenticazione a più fattori basata sul telefono e per la verifica del numero di telefono. Un gateway integrato funziona subito; a partire dal piano Essential è possibile instradare questi messaggi tramite il proprio provider.

Scegliere un gateway
- Nella Admin Console, aprire Branding → Telefono.
- Selezionare un provider:
- Gateway integrato: il servizio predefinito. Nessuna configurazione richiesta.
- Twilio: invio tramite il proprio account Twilio.
- Gateway personalizzato: invio tramite qualsiasi API SMS HTTP.
- Configurare i campi per la scelta effettuata (vedere sotto) e selezionare Salva modifiche.
Twilio
Indicare il proprio Account SID e il Token di autenticazione di Twilio, quindi scegliere come inviare i messaggi:
- Mittente: un Numero mittente oppure un Messaging Service SID. Un Messaging Service si applica ai messaggi di testo; le chiamate vocali utilizzano sempre un numero mittente.
- Metodi di consegna: recapitare il codice come Messaggio di testo (SMS), come Chiamata vocale o in entrambi i modi.
Gateway personalizzato
Collegare la piattaforma a qualsiasi API SMS HTTP:
- URL del gateway e Metodo HTTP (GET o POST).
- Per POST, un Formato del body (JSON, form-encoded o raw) e un modello di Request body. Per i body raw è possibile impostare il Content-Type.
- Header personalizzati: un
Name: valueper riga, utile per un headerAuthorization. - Nome utente, Password e un Token di autenticazione per i gateway che li richiedono.
L'URL, il request body e gli header supportano segnaposto che vengono sostituiti al momento dell'invio, tra cui il numero del destinatario e il testo del messaggio, ad esempio https://api.example.com/send?to={{to}}&text={{message}} oppure un header come Authorization: Bearer {{authToken}}.
Campi segreti
I valori sensibili, come l'Auth Token di Twilio e la password e il token di autenticazione del gateway personalizzato, vengono memorizzati in modo sicuro e non sono mai precompilati. Lasciare vuoto un campo segreto per mantenerne il valore attuale; inserire un nuovo valore solo quando lo si desidera modificare.
Contenuto del messaggio
Il testo del messaggio con il codice proviene dalla formulazione integrata e tradotta della piattaforma; non viene modificato in questa pagina. Il body è determinato dai testi localizzati dell'istanza, quindi la lingua del messaggio segue la lingua dell'utente (o dell'istanza) anziché un editor per singolo modello.
Protezione dagli abusi
Gli SMS in uscita sono soggetti a un limite di frequenza per utente, quindi un singolo account non può generare un numero illimitato di messaggi. Ciò protegge da loop accidentali e da abusi intenzionali che altrimenti farebbero aumentare i costi di consegna.
Risoluzione dei problemi
- I codici non arrivano: verificare che le credenziali del gateway siano corrette, salvare di nuovo e ripetere il test del flusso. Tenere presente che i campi segreti sono intenzionalmente vuoti dopo il salvataggio; ciò non significa che il valore sia stato cancellato.
- Chiamata vocale Twilio ma nessun numero: un Messaging Service SID copre solo gli SMS; aggiungere un numero mittente per abilitare la consegna vocale.
- Il gateway personalizzato restituisce un errore: verificare che URL, metodo HTTP, formato del body e segnaposto corrispondano a quanto previsto dal provider.