Como criar um servidor de SMS OTP sem o Twilio

Criar um fluxo seguro de verificação de usuário não deveria exigir lidar com infinitas aprovações de operadoras ou pagar tarifas exorbitantes por mensagem. Neste tutorial, mostraremos como criar um servidor de SMS OTP usando seu próprio dispositivo Android e um backend local, evitando os altos custos e a burocracia dos provedores tradicionais de SMS A2P.

Por que criar um servidor de SMS OTP personalizado?

Quando desenvolvedores buscam pelas melhores APIs para chamadas de saída e SMS a partir de sistemas backend, geralmente são direcionados a gigantes legadas das telecomunicações, como Twilio, Vonage ou MessageBird. No entanto, para desenvolvedores independentes, startups e pequenos empresários fora dos EUA, essas plataformas tornaram-se cada vez mais inviáveis. Entre o registro obrigatório de 10DLC, taxas de verificação de operadoras e processos complexos de configuração, a simples tentativa de enviar uma senha de uso único (OTP) pode levar semanas de trabalho administrativo.

Além disso, os gateways tradicionais cobram por segmento de 160 caracteres e exigem taxas básicas elevadas. Se você está criando um serviço localizado — como um sistema de agendamento de clínicas, um portal de autoescola ou um rastreador de presença —, você precisa de uma API de SMS de baixo custo que simplesmente funcione. Ao aprender a criar seu próprio gateway de SMS usando um celular Android, você pula totalmente o registro de operadora e envia mensagens diretamente de um número que seus clientes já reconhecem.

Comparando APIs de SMS tradicionais vs. MySMSGate Android Gateway

Abaixo está uma comparação direta do que é necessário para enviar SMS transacionais e OTPs por meio de APIs tradicionais em comparação ao uso de um gateway baseado em Android como o MySMSGate.

Passo 1: Criar conta e fazer login no aplicativo MySMSGateway

Para transformar um dispositivo Android em um gateway de SMS programável, você precisa de um serviço intermediário que faça a ponte entre o código do seu backend e o sistema operacional Android. É aqui que entra o MySMSGate.

Primeiro, acesse a Página de Registro do MySMSGate para criar sua conta gratuita. Depois de fazer login, você verá sua chave de API e um QR code exclusivo no seu painel web. Esse QR code elimina a necessidade de copiar e colar manualmente credenciais de API longas no seu dispositivo móvel.

Em seguida, baixe o aplicativo complementar para Android no seu celular. Abra o aplicativo, selecione a opção de escanear o QR code de configuração e aponte a câmera para a tela do computador. O aplicativo se configurará automaticamente, estabelecerá uma conexão segura via notificações push para permanecer ativo em modo de suspensão e vinculará os slots físicos do seu cartão SIM ao seu painel de desenvolvedor. Agora você está pronto para rotear mensagens programáticas pelo seu celular.

Passo 2: Configurar seu hardware (celular e mini PC)

Muitos desenvolvedores perguntam: como posso criar minha própria API de SMS localmente usando um celular e um mini PC? A arquitetura de hardware para um servidor OTP local auto-hospedado é incrivelmente simples e resiliente. Você não precisa de racks de servidores caros; um mini PC básico (como um Intel NUC ou Raspberry Pi) rodando Linux, combinado com um celular Android sobressalente, é mais do que suficiente.

Conecte seu mini PC à rede local. Este mini PC hospedará o banco de dados principal da sua aplicação e a lógica do backend (por exemplo, Node.js, Python ou Go). Seu celular Android não precisa estar fisicamente conectado ao mini PC via USB. Como o MySMSGate lida com a comunicação por meio de webhooks seguros baseados em nuvem e endpoints de API, seu celular precisa apenas de uma conexão estável de Wi-Fi ou dados móveis. Isso permite posicionar o aparelho em uma área com excelente recepção de sinal celular, mesmo que o mini PC esteja guardado em um armário de servidores.

Aproveitando o suporte a Dual SIM e múltiplos dispositivos

Se você administra uma empresa com várias filiais ou se deseja separar o tráfego de OTP transacional de alertas de marketing, pode conectar dispositivos Android ilimitados a uma única conta MySMSGate. Se o seu celular for Dual SIM, a plataforma permite escolher programaticamente de qual slot de chip enviar para cada chamada de API de saída, oferecendo controle total sobre o roteamento e as tarifas das operadoras locais.

Passo 3: Escrever o código do servidor OTP

Agora que seu hardware está conectado, você pode escrever a lógica do backend para gerar, armazenar e enviar as senhas de uso único. Abaixo está um exemplo completo e leve em Node.js demonstrando como gerar um OTP de 6 dígitos seguro, armazená-lo na memória com um carimbo de data/hora de expiração e enviá-lo por meio da API REST do 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' };
  }
}

Esta integração limpa de API REST requer apenas uma única requisição POST para despachar a mensagem. Não há SDKs complicados para manter, facilitando a portabilidade dessa lógica para Python, Go, PHP ou Ruby usando nossa documentação de integração padrão.

Passo 4: Adicionar verificação e rastreamento por webhook

Enviar o OTP é apenas metade do caminho; seu servidor também deve verificar a entrada do usuário e acompanhar se o SMS realmente chegou ao aparelho dele. Para verificar o código quando o usuário o envia, implemente um endpoint de verificação simples no backend do seu 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' };
}

Para monitorar o status de entrega em tempo real, configure uma URL de webhook no seu painel do MySMSGate. Sempre que seu celular Android enviar a mensagem e receber um recibo de entrega da rede da operadora, o MySMSGate enviará uma atualização de status de volta ao seu servidor local. Se uma mensagem falhar no envio devido a um número inválido ou erro de operadora, o saldo da sua conta será reembolsado automaticamente, garantindo que você nunca pague por tentativas de verificação não entregues.

Expandindo o servidor: Controle de presença e alertas

Depois de entender como criar configurações de servidor de SMS OTP, você pode facilmente reaproveitar a mesma infraestrutura de backend para lidar com outros fluxos de trabalho empresariais. For exemplo, centros educacionais locais, escolas de reforço e clubes esportivos frequentemente perguntam como criar controle de presença com SMS automático para os pais.

Ao conectar sua folha de presença digital ou totem de check-in ao backend do seu mini PC, você pode disparar alertas automatizados de saída. Quando um aluno passa seu cartão de identificação ou faz o check-in, seu sistema pode chamar instantaneamente a API do MySMSGate para enviar uma mensagem personalizada: "Olá, seu filho chegou em segurança ao centro de reforço às 15:15."

Da mesma forma, empresas de serviços locais, como oficinas mecânicas, clínicas odontológicas e salões de beleza, podem usar essa configuração para criar templates de alerta de SMS para confirmações de reservas, lembretes de consultas e notificações de "pronto para retirada". Como você está enviando esses alertas do seu próprio chip, os clientes podem responder diretamente ao SMS. Essas respostas são encaminhadas de volta para o seu painel web do MySMSGate em tempo real, permitindo que você mantenha conversas de duas vias diretamente do seu navegador, sem precisar pegar no celular.

Perguntas Frequentes (FAQ)

Encontre respostas para as perguntas mais comuns sobre como criar seu próprio gateway de SMS local e servidor OTP.

Como posso criar minha própria API de SMS localmente usando um celular e um mini PC?

Para criar uma API de SMS local, configure um mini PC (como um Raspberry Pi ou Intel NUC) executando o backend da sua aplicação e combine-o com um celular Android executando o aplicativo MySMSGate. O mini PC gera os dados do SMS e os envia para o endpoint da API REST do MySMSGate. O gateway na nuvem encaminha a requisição para o seu celular Android conectado via notificações push seguras, e o cartão SIM físico do aparelho envia o SMS localmente.

Preciso de aprovação da operadora ou registro 10DLC para enviar OTPs?

Não. Como o MySMSGate roteia as mensagens por meio do seu próprio celular Android (pessoal ou comercial) e chip, você não precisa se registrar no A2P 10DLC, passar por verificação de marca ou aguardar aprovações de operadoras. Você pode começar a enviar alertas transacionais e códigos de verificação imediatamente após configurar o aplicativo.

Como o MySMSGate lida com falhas na entrega de SMS?

Se um SMS falhar no envio devido a problemas de rede, número de telefone inválido ou falta de saldo da operadora no seu chip, o MySMSGate rastreia o status da falha via webhooks e reembolsa automaticamente a taxa de API de $0.02 no saldo da sua conta. Você só paga pelas mensagens que forem despachadas com sucesso a partir do seu dispositivo.

Posso usar chips Dual SIM para rotear mensagens OTP?

Sim. O aplicativo MySMSGate para Android suporta totalmente dispositivos Dual SIM. Ao fazer uma requisição POST para a nossa API, você pode definir programaticamente qual slot de chip (SIM 1 ou SIM 2) deve ser usado para enviar a mensagem, permitindo otimizar o roteamento com base nas tarifas das operadoras locais.