Come creare un server SMS OTP senza Twilio

La creazione di un flusso sicuro di verifica degli utenti non dovrebbe richiedere l'approvazione infinita degli operatori telefonici o il pagamento di tariffe esorbitanti per singolo messaggio. In questo tutorial, ti mostreremo come creare un server SMS OTP utilizzando il tuo hardware Android e un backend locale, aggirando i costi elevati e la burocrazia dei tradizionali fornitori di SMS A2P.

Perché creare un server SMS OTP personalizzato?

Quando gli sviluppatori cercano le migliori API per chiamate in uscita e SMS da sistemi di backend, vengono spesso indirizzati verso i giganti tradizionali delle telecomunicazioni come Twilio, Vonage o MessageBird. Tuttavia, per gli sviluppatori indipendenti, le startup e le piccole imprese al di fuori degli Stati Uniti, queste piattaforme sono diventate sempre più impraticabili. Tra la registrazione obbligatoria 10DLC, le commissioni di verifica degli operatori e i complessi processi di configurazione, il semplice tentativo di inviare una password monouso (OTP) può richiedere settimane di lavoro amministrativo.

Inoltre, i gateway tradizionali fatturano per segmenti di 160 caratteri e applicano tariffe base elevate. Se stai creando un servizio localizzato, come un sistema di prenotazione per cliniche, un portale per autoscuole o un rilevatore di presenze, hai bisogno di un'API SMS a basso costo che funzioni e basta. Imparando a creare il tuo gateway SMS utilizzando un telefono Android, eviti completamente la registrazione con gli operatori e invii messaggi direttamente da un numero che i tuoi clienti già riconoscono.

Confronto tra le API SMS tradizionali e il gateway Android MySMSGate

Di seguito è riportato un confronto diretto tra ciò che serve per inviare SMS transazionali e OTP tramite le API tradizionali rispetto all'utilizzo di un gateway basato su Android come MySMSGate.

Passo 1: Crea un account e accedi all'app MySMSGateway App

Per trasformare un dispositivo Android in un gateway SMS programmabile, hai bisogno di un servizio intermediario che colleghi il tuo codice di backend con il sistema operativo Android. È qui che entra in gioco MySMSGate.

Per prima cosa, vai alla pagina di registrazione di MySMSGate per creare il tuo account gratuito. Una volta effettuato l'accesso, visualizzerai la tua chiave API e un codice QR unico sulla tua dashboard web. Questo codice QR elimina la necessità di copiare e incollare manualmente lunghe credenziali API sul tuo dispositivo mobile.

Successivamente, scarica l'applicazione Android complementare sul tuo telefono. Apri l'app, seleziona l'opzione per scansionare il codice QR di configurazione e punta la fotocamera verso lo schermo del computer. L'app si configurerà automaticamente, stabilirà una connessione sicura tramite notifiche push per rimanere attiva in modalità sleep e collegherà gli slot della tua scheda SIM fisica alla tua dashboard per sviluppatori. Ora sei pronto a instradare messaggi programmatici attraverso il tuo telefono.

Passo 2: Configura l'hardware (telefono e mini PC)

Molti sviluppatori si chiedono: come posso creare la mia API SMS localmente utilizzando un telefono e un mini PC? L'architettura hardware per un server OTP locale self-hosted è incredibilmente semplice e resiliente. Non hai bisogno di costosi rack per server; un mini PC di base (como un Intel NUC o un Raspberry Pi) con Linux, abbinato a un telefono Android di riserva, è più che sufficiente.

Connetti il tuo mini PC alla rete locale. Questo mini PC ospiterà il database principale dell'applicazione e la logica di backend (ad esempio, Node.js, Python o Go). Il tuo telefono Android non deve essere fisicamente collegato al mini PC tramite USB. Poiché MySMSGate gestisce le comunicazioni tramite webhook sicuri basati su cloud ed endpoint API, il tuo telefono ha solo bisogno di una connessione Wi-Fi o dati cellulare stabile. Ciò ti consente di posizionare il telefono in un'area con una ricezione cellulare ottimale, anche se il tuo mini PC è nascosto in un armadio server.

Sfruttare il supporto Dual SIM e multi-dispositivo

Se gestisci un'attività con più filiali o se desideri separare il traffico OTP transazionale dagli avvisi di marketing, puoi collegare un numero illimitato di telefoni Android a un singolo account MySMSGate. Se il tuo telefono supporta due schede SIM, la piattaforma ti consente di scegliere a livello di programmazione da quale slot SIM inviare per ogni chiamata API in uscita, offrendoti il controllo completo sull'instradamento e sulle tariffe degli operatori locali.

Passo 3: Scrivi il codice del server OTP

Ora che il tuo hardware è connesso, puoi scrivere la logica di backend per generare, memorizzare e inviare password monouso. Di seguito è riportato un esempio completo e leggero in Node.js che mostra come generare un OTP sicuro a 6 cifre, memorizzarlo in memoria con un timestamp di scadenza e inviarlo tramite l'API REST di MySMSGate.

const axios = require('axios');

// In-memory store for demonstration (use Redis in production)
const otpCache = new Map();

const MYSMSGATE_API_URL = 'https://mysmsgate.net/api/v1/send';
const API_KEY = 'YOUR_MYSMSGATE_API_KEY';

async function generateAndSendOTP(phoneNumber) {
  // Generate a cryptographically secure 6-digit code
  const otp = Math.floor(100000 + Math.random() * 900000).toString();
  const expiresAt = Date.now() + 5 * 60 * 1000; // 5 minutes expiry

  // Store OTP details
  otpCache.set(phoneNumber, { otp, expiresAt });

  // Prepare payload for MySMSGate API
  const payload = {
    to: phoneNumber,
    message: `Your verification code is ${otp}. It will expire in 5 minutes.`
  };

  try {
    const response = await axios.post(MYSMSGATE_API_URL, payload, {
      headers: {
        'Authorization': `Bearer ${API_KEY}`,
        'Content-Type': 'application/json'
      }
    });
    console.log('OTP dispatched successfully:', response.data);
    return { success: true };
  } catch (error) {
    console.error('Failed to dispatch OTP via MySMSGate:', error.response ? error.response.data : error.message);
    return { success: false, error: 'SMS gateway communication failure' };
  }
}

Questa pulita integrazione dell'API REST richiede una sola richiesta POST per inviare il messaggio. Non ci sono SDK complicati da mantenere, il che rende facile trasferire questa logica su Python, Go, PHP o Ruby utilizzando la nostra documentazione di integrazione standard.

Passo 4: Aggiungi la verifica e il tracciamento tramite Webhook

L'invio dell'OTP è solo metà dell'opera; il tuo server deve anche verificare l'input dell'utente e monitorare se l'SMS ha effettivamente raggiunto il suo dispositivo. Per verificare il codice quando l'utente lo invia, implementa un semplice endpoint di verifica sul backend del tuo mini PC:

function verifyOTP(phoneNumber, userSubmittedCode) {
  const record = otpCache.get(phoneNumber);
  if (!record) {
    return { verified: false, reason: 'No OTP requested or code expired' };
  }

  if (Date.now() > record.expiresAt) {
    otpCache.delete(phoneNumber);
    return { verified: false, reason: 'OTP has expired' };
  }

  if (record.otp === userSubmittedCode) {
    otpCache.delete(phoneNumber); // Clear code after successful use
    return { verified: true };
  } 

  return { verified: false, reason: 'Incorrect code' };
}

Per monitorare lo stato di consegna in tempo reale, configura un URL di webhook nella tua dashboard MySMSGate. Ogni volta che il tuo telefono Android invia il messaggio e riceve una ricevuta di consegna di rete dall'operatore, MySMSGate invierà un aggiornamento di stato al tuo server locale. Se un messaggio non viene consegnato a causa di un numero non valido o di un errore dell'operatore, il saldo del tuo account viene rimborsato automaticamente, assicurandoti di non pagare mai per tentativi di verifica non andati a buon fine.

Espandere il server: rilevamento delle presenze e avvisi

Una volta compreso come creare le configurazioni del server SMS OTP, puoi facilmente riutilizzare la stessa identica infrastruttura di backend per gestire altri flussi di lavoro aziendali. Ad esempio, i centri educativi locali, le scuole di ripetizioni e i club sportivi si chiedono spesso come creare un rilevamento delle presenze con SMS automatici ai genitori.

Collegando il tuo registro digitale delle presenze o il totem di check-in al backend del tuo mini PC, puoi attivare avvisi automatici in uscita. Quando uno studente scansiona il proprio badge identificativo o effettua il check-in, il tuo sistema può chiamare istantaneamente l'API MySMSGate per inviare un messaggio personalizzato: "Ciao, tuo figlio è arrivato in sicurezza al centro di ripetizioni alle 15:15."

Allo stesso modo, le attività di servizi locali come officine meccaniche, cliniche dentistiche e saloni di parrucchieri possono utilizzare questa configurazione per creare modelli di avvisi SMS per conferme di prenotazione, promemoria di appuntamenti e notifiche di "pronto per il ritiro". Poiché invii questi avvisi dalla tua scheda SIM, i clienti possono rispondere direttamente all'SMS. Queste risposte vengono inoltrate alla tua dashboard web MySMSGate in tempo reale, consentendoti di avviare conversazioni bidirezionali dal tuo browser senza dover prendere in mano il telefono.

Domande frequenti (FAQ)

Trova le risposte alle domande più comuni sulla creazione del tuo gateway SMS locale e del server OTP.

Come posso creare la mia API SMS localmente utilizzando un telefono e un mini PC?

Per creare un'API SMS locale, configura un mini PC (come un Raspberry Pi o un Intel NUC) che esegua il backend della tua applicazione e associalo a un telefono Android che esegua l'applicazione MySMSGate. Il mini PC genera i payload degli SMS e li invia all'endpoint dell'API REST di MySMSGate. Il gateway cloud inoltra la richiesta al tuo telefono Android connesso tramite notifiche push sicure, e la scheda SIM fisica del telefono invia l'SMS localmente.

Ho bisogno dell'approvazione dell'operatore o della registrazione 10DLC per inviare OTP?

No. Poiché MySMSGate instrada i messaggi attraverso il tuo telefono Android personale o aziendale e la tua scheda SIM, non è necessario registrarsi per A2P 10DLC, sottoporsi alla verifica del marchio o attendere le approvazioni degli operatori. Puoi iniziare a inviare avvisi transazionali e codici di verifica immediatamente dopo aver configurato l'app.

In che modo MySMSGate gestisce la mancata consegna degli SMS?

Se un SMS non viene consegnato a causa di problemi di rete, di un numero di telefono non valido o della mancanza di credito telefonico sulla tua scheda SIM, MySMSGate traccia lo stato di errore tramite webhook e rimborsa automaticamente la tariffa API di $0.02 sul saldo del tuo account. Paghi solo per i messaggi che vengono inviati con successo dal tuo dispositivo.

Posso utilizzare due schede SIM per instradare i messaggi OTP?

Sì. L'applicazione Android MySMSGate supporta pienamente i dispositivi dual SIM. Quando effettui una richiesta POST alla nostra API, puoi definire a livello di programmazione quale slot SIM (SIM 1 o SIM 2) deve essere utilizzato per inviare il messaggio, consentendoti di ottimizzare l'instradamento in base alle tariffe degli operatori locali.