# Telefono (SMS)

Configurare il gateway che recapita i codici monouso via SMS o chiamata vocale (gateway integrato, Twilio o un gateway HTTP personalizzato).

Requires: customSmsGateway

> **Nota sul piano:** un gateway SMS personalizzato è disponibile a partire dal piano Essential. Vedere [Piani e add-on](https://dts-identity.com/it/docs/getting-started/plans-and-addons.md). 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](https://dts-identity.com/it/docs/security/multi-factor-authentication.md) 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.

[Image: La scheda Telefono delle impostazioni di branding]

## Scegliere un gateway

1. Nella Admin Console, aprire **Branding → Telefono**.
2. 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.
3. 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: value` per riga, utile per un header `Authorization`.
- **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.
