Your AI Connector Docs

Telefono Android come SMS Gateway (Beta)

Usa il tuo telefono Android come mittente SMS. Invece di collegare un account Twilio, installi una piccola app open-source su un telefono Android, la abbini al tuo spazio di lavoro e i tuoi messaggi vengono inviati e ricevuti tramite il numero e il piano tariffario di quel telefono.

Canale Beta. Il gateway SMS per Android è ora disponibile per tutti gli utenti con un piano che include una disponibilità di canali, ma è ancora una novità: aspettati qualche piccola imperfezione e tieni presente che il comportamento e i limiti potrebbero cambiare man mano che il canale si evolve. Se qualcosa non funziona come descritto, contatta l’assistenza.


Perché usarlo

Il gateway Android è progettato per SMS conversazionali a basso volume: rispondere ai lead, conversazioni con l’IA e messaggi uno-a-uno. È una soluzione adatta quando:

  • Vuoi continuare a inviare messaggi dal tuo numero personale o aziendale esistente.
  • Twilio è eccessivo o troppo costoso per il tuo paese o volume di traffico.
  • Preferisci utilizzare il piano SMS esistente del tuo operatore invece di pagare tariffe per singolo messaggio.
  • Vuoi evitare le pratiche burocratiche di registrazione dell’operatore (A2P 10DLC e simili) richieste da Twilio.

Non è progettato per invii massivi di broadcast: consulta le Limitazioni qui sotto.

Preferisci Twilio per scalabilità e affidabilità. Se invii messaggi in grandi volumi, hai bisogno di un uptime garantito o gestisci broadcast SMS massivi, collega invece un numero Twilio: consulta SMS Messaging. I due sono trasporti SMS alternativi; messaggi, contatti, l’IA e la tua casella di posta funzionano allo stesso modo in entrambi i casi.


Cosa ti serve

  • Un telefono Android con una SIM attiva e un piano SMS (si consiglia vivamente un piano SMS illimitato o generoso).
  • L’app gratuita e open-source “SMS Gateway for Android” da sms-gate.app — scaricala dal sito o dalle sue release su GitHub. Non abbiamo realizzato noi questa app: è un progetto di terze parti.
  • Il telefono deve rimanere acceso, connesso e senza restrizioni — consulta Mantenere il telefono affidabile.
  • Un piano a pagamento — il gateway Android è incluso nella tua disponibilità di canali.

Non ci sono commissioni di piattaforma per messaggio né fatture Twilio: utilizzi il piano tariffario del tuo telefono. Se l’IA genera una risposta, tale risposta utilizzerà comunque i crediti IA, esattamente come su ogni altro canale.


Configurazione dell’app Gateway

  1. Installa SMS Gateway for Android da sms-gate.app sul telefono di cui vuoi utilizzare il numero.
  2. Apri l’app.
  3. Attiva la modalità Cloud Server (l’opzione più semplice: inoltra i messaggi tramite il server ospitato dal progetto, così il tuo telefono non ha bisogno di un indirizzo pubblico).
  4. L’app genererà un nome utente e una password nella schermata principale. Li incollerai nella piattaforma nella sezione successiva.
  5. (Consigliato) Nell’app, apri Settings → Webhooks. Un webhook è una notifica automatica che l’app invia alla piattaforma ogni volta che succede qualcosa; in questo caso, ogni volta che arriva un messaggio.
  6. Copia la Signing Key. Incollandola nella piattaforma aggiungerai un controllo di firma extra sui messaggi in arrivo.

Solo modalità Cloud Server. La finestra di connessione funziona con la modalità Cloud Server dell’app. Un telefono impostato sulla modalità Local Server, o collegato a un server diverso (un relay privato o di terze parti), non può essere connesso: il suo ID dispositivo, il token di registrazione o le credenziali di quel server vengono rifiutati come nome utente o password non validi. Imposta il telefono sulla modalità Cloud Server e utilizza il nome utente e la password dalla schermata iniziale dell’app.


Collegamento del telefono alla piattaforma

  1. Nella barra laterale sinistra, fai clic su Settings vicino alla parte inferiore.
  2. Nella barra laterale sinistra di Settings, sotto Channels, fai clic su Channels.
  3. Trova la scheda Android SMS Gateway e fai clic su Connect.
  4. Inserisci il Phone number: il numero del telefono stesso in formato internazionale (E.164), ad es. +14155551234.
  5. Inserisci il Gateway username e la Gateway password dalla schermata iniziale dell’app gateway.
  6. Facoltativamente, incolla la Webhook signing key (consigliato) dalle impostazioni Webhooks dell’app.
  7. Fai clic su Connect.

La piattaforma convalida le credenziali, registra i webhook per i messaggi e la consegna sul gateway per te e imposta lo stato su Connesso. Non è necessario copiare e incollare gli URL dei webhook nell’app: la registrazione è automatica.

Verifica dello stato

Una volta connesso, il pulsante della scheda cambia da Connetti a Gestisci. Fai clic su di esso per riaprire il pannello del gateway, dove troverai Aggiorna stato in qualsiasi momento. Verifica nuovamente che il gateway sia raggiungibile e mostra se il telefono è attualmente online. Se il telefono è in modalità sospensione o offline, vedrai un chiaro indicatore di offline, così saprai che i messaggi non verranno inviati finché non tornerà online.

Disconnessione

Fai clic su Gestisci sulla scheda per riaprire il pannello del gateway, quindi fai clic su Disconnetti. La piattaforma rimuove i webhook registrati sul gateway e cancella la connessione. I tuoi messaggi passeranno quindi a Twilio se hai un numero SMS Twilio connesso, oppure gli SMS verranno disattivati se non ne hai uno.


Come fluiscono i messaggi

In entrata

  1. Qualcuno invia un SMS al numero del tuo telefono.
  2. L’app gateway sul telefono rileva l’SMS e avvisa la piattaforma.
  3. La piattaforma crea un contatto (se nuovo), inserisce il messaggio nella tua casella di posta e, se l’Agente IA pertinente è attivo, risponde.

In uscita

  1. Tu o l’IA inviate una risposta dalla piattaforma.
  2. La piattaforma consegna il messaggio al tuo gateway.
  3. Il telefono lo invia come un normale SMS dal tuo numero, tramite il tuo operatore.
  4. Quando l’operatore invia il rapporto di ricezione, lo stato del messaggio si aggiorna in Sent, poi Delivered (o Failed).

Il gateway Android ha la priorità per l’invio. Mentre è connesso, le risposte uno-a-uno e quelle dell’IA passano attraverso il tuo telefono. Se hai collegato anche un numero SMS Twilio, scollega il gateway Android per inviarle nuovamente tramite Twilio. Un’eccezione in entrambi i casi: gli invii massivi di SMS passano sempre attraverso il tuo numero Twilio, mai tramite il telefono Android; l’invio massivo da un dispositivo personale è esattamente ciò che causa la segnalazione dei numeri, quindi la piattaforma non lo consente.


Limitazioni

Il gateway Android dipende da un telefono fisico sotto il tuo controllo, quindi comporta dei vincoli che non troveresti su Twilio. Esaminali prima di affidarti a questo metodo per comunicazioni importanti.

  • Il telefono deve rimanere acceso e online. Niente telefono, niente messaggi. Mantienilo carico, connesso al Wi-Fi o ai dati ed escluso dall’ottimizzazione della batteria.
  • Solo volume basso. Gli operatori segnalano e limitano i telefoni che inviano improvvisamente molti messaggi. Questo canale è destinato a conversazioni e risposte uno a uno, non a trasmissioni di massa.
  • Le trasmissioni SMS di massa non sono supportate su questo canale. L’invio di SMS in blocco richiede un numero Twilio collegato; la piattaforma ti avviserà se provi a lanciarne uno senza Twilio. Gestisci le trasmissioni tramite Twilio e mantieni il gateway Android per le risposte conversazionali.
  • Solo testo. I messaggi MMS in arrivo, inclusi i messaggi chat RCS che il telefono riceve come MMS, arrivano con il relativo testo, ma eventuali foto, video o file in essi contenuti non verranno trasmessi. L’invio di MMS (contenuti multimediali) non è supportato su questo canale.
  • Si applicano i limiti dell’operatore. Il piano SMS del tuo telefono, i limiti di utilizzo corretto ed eventuali costi per messaggio dipendono esclusivamente dal rapporto tra te e il tuo operatore.
  • La conferma di consegna dipende dal tuo operatore. Alcuni operatori segnalano la consegna in modo affidabile, altri no. Lo stato “Inviato” indica che il telefono ha inoltrato il messaggio.
  • Rischio per l’account/numero. L’utilizzo di un numero personale per l’invio automatizzato di messaggi aziendali potrebbe violare i termini del tuo operatore e può portare alla limitazione o alla sospensione del numero in caso di abuso. Usalo in modo responsabile, ottieni il consenso e includi le istruzioni per l’opt-out.

Mantenere l’affidabilità del telefono

Per mantenere il flusso dei messaggi senza interruzioni:

  • Disabilita l’ottimizzazione della batteria per l’app SMS Gateway (Impostazioni Android → App → SMS Gateway → Batteria → Senza restrizioni). In caso contrario, Android potrebbe chiuderla in background.
  • Mantieni lo schermo raggiungibile / consenti all’app di essere eseguita in background. Un telefono dedicato lasciato collegato all’alimentazione è l’ideale.
  • Rimani su una connessione Wi-Fi o dati stabile. Se il telefono perde la connettività, gli invii vengono messi in coda o falliscono finché non torna online.
  • Mantieni la SIM attiva e in regola con il tuo operatore.

Risoluzione dei problemi

“Impossibile convalidare le credenziali del gateway”

  • Ricontrolla il nome utente e la password confrontandoli con quelli della schermata iniziale dell’app gateway: vengono rigenerati se reinstalli o ripristini l’app.
  • Conferma che il telefono abbia accesso a Internet e che la modalità Cloud Server sia attivata nell’app.
  • Utilizza il nome utente e la password dalla schermata iniziale dell’app, non un ID dispositivo, un token di registrazione o le credenziali di un altro server.

Lo stato risulta offline / i messaggi non vengono inviati

  • Apri l’app sul telefono e conferma che sia in esecuzione e che mostri la connessione al cloud server.
  • Verifica che il telefono non sia in modalità Doze/risparmio energetico e che l’app sia esclusa dall’ottimizzazione della batteria.
  • Tocca Refresh status sulla scheda dopo aver riportato il telefono online.

I messaggi in arrivo non vengono visualizzati

  • Conferma che la connessione risulti ancora Connesso (tocca Aggiorna stato).
  • Invia un SMS di prova al numero del telefono da un altro dispositivo.
  • Assicurati che l’app Messaggi predefinita del telefono non stia bloccando o filtrando il mittente.

Un messaggio mostra “Non riuscito”

  • L’operatore lo ha rifiutato: controlla che il numero del destinatario sia valido e in formato internazionale.
  • Conferma che la tua SIM abbia ancora credito SMS disponibile e che il numero non sia sospeso.
  • Frequenze di invio molto elevate possono attivare le limitazioni dell’operatore; rallenta e mantieni un volume basso.

Hai bisogno di aiuto?

Il gateway SMS per Android è in Beta. Se riscontri problemi non trattati qui, contatta hi@youraiconnector.com con:

  • Il numero di telefono che hai collegato (non la password).
  • Se l’app gateway risulta online sul telefono.
  • Una descrizione del problema e quando si è verificato.

Ci occuperemo di dare un’occhiata il prima possibile.