# SMS API (SyBox)

Dove: Impostazioni > Messaggistica > SMS API

A cosa serve: aggiungere fornitori di SMS come canale di backup. Se assegni un paese a un gateway, diventerà il gateway preferito per i contatti di quel paese.

Chi può aprirlo: gli utenti con il permesso "Gestisci gateway SMS".

### Come aggiungere un gateway SMS

1. Fai clic su "Aggiungi SMS API".
   ![Settings, SMS APIs: a connected SMS gateway and the "Add SMS API" button](https://www.sybox.io/res/sybox/help/it/add-an-sms-gateway-1.webp?v=027405be)
2. Provider: scegli MessageBird, SMS Misr, Texto o Twilio. Il modulo mostra solo i campi richiesti da quel fornitore.
   ![The new SMS gateway window: the provider first, then the country, keys and sender](https://www.sybox.io/res/sybox/help/it/add-an-sms-gateway-2.webp?v=c4614d2a)
3. Nome visualizzato: un nome a tua scelta come riferimento.
4. Paese: un codice a due lettere, ad esempio EG. Lascialo vuoto per utilizzare il gateway per tutti i paesi.
5. Inserisci i dettagli del fornitore:
   - MessageBird: ID mittente (il nome o il numero visualizzato dal destinatario) e Chiave API.
   - SMS Misr: ID mittente, Nome utente, Password e Token mittente. Il Token mittente è il valore fornito da SMS Misr per il tuo ID mittente.
   - Texto: solo Chiave API.
   - Twilio: ID mittente (il tuo numero mittente o servizio di messaggistica), SID account e Auth Token.
6. Attivo: lascialo abilitato per utilizzare il gateway.
7. Fai clic su Salva. Se manca un campo obbligatorio, vedrai "Dati incompleti".

### Come inviare un SMS di prova

1. Fai clic su "Invia SMS di prova" (l'icona di invio) sulla scheda del gateway.
   ![To send a test SMS: "Send test SMS" marked on the screen in SyBox](https://www.sybox.io/res/sybox/help/it/send-a-test-sms-1.webp?v=e95044bc)
2. Inserisci un numero di telefono in formato internazionale, ad esempio +2126…, e modifica il messaggio se lo desideri.
3. Fai clic su Salva. Vedrai "SMS di prova inviato." Se il fornitore lo rifiuta, verrà mostrato l'errore.

Altre azioni

- Modifica: cambia qualsiasi campo. Lascia vuoto il campo della password o della chiave per mantenere quella attuale.
- Abilita / Disabilita: attiva o disattiva il gateway.
- Elimina: "Eliminare definitivamente questo gateway SMS?"
- Una scheda con "Token mancante" non ha alcuna chiave salvata. Modificala e inserisci la chiave.

Source: https://www.sybox.io/it/help/sms-apis
