Gateway de SMS no Android: transforme um celular seu em gateway para os seus códigos de verificação

O que você precisa

• Um celular com Android 8.0 ou posterior, com o SIM cujos códigos você quer. Celulares com um ou dois chips funcionam, e não é preciso root.
• Um celular de verdade. Emuladores não são aceitos como gateway: a ideia é um SIM real em uma rede móvel real.
• O app BusySMS do Google Play (pacote net.busysms.app).
• Uma conta BusySMS. Você entra com um código de uso único enviado ao seu e-mail; não há senha para criar.

Configure o gateway em cinco passos

1. 1

   Instale o app

   Instale o BusySMS pelo Google Play no celular que está com o SIM. O Google Play é o único jeito de instalar, então as atualizações chegam normalmente.

2. 2

   Entre com o seu e-mail

   Informe seu e-mail e digite o código que enviamos. Depois que seu número estiver na conta, você também poderá entrar com ele. A mesma conta funciona no site, nos clientes MCP e na extensão para Chrome.

3. 3

   Cadastre o celular e verifique o SIM

   Escolha o SIM. O BusySMS envia um código para esse número e o app o captura, o que prova que o SIM realmente tem esse número. Enquanto um número não é verificado, nada do que ele recebe é armazenado, lido ou cobrado.

4. 4

   Permita o acesso aos SMS e ligue o gateway

   Permita o acesso aos SMS quando o app pedir. O acesso às notificações também é recomendado, porque o app de Mensagens de alguns fabricantes entrega os códigos como notificações. Ligue o gateway: o Android mostra uma notificação fixa enquanto a captura estiver ativa, e você pode parar por ali a qualquer momento.

5. 5

   Leia seu primeiro código

   Abra SMS recebidos no painel, ou crie uma chave de API em API REST e chame GET /api/v1/codes. Qualquer código que chegar ao celular a partir de agora aparece nos dois.

Leia um código pela API REST

Toda requisição leva a sua chave de API, que começa com bsk_live_, no cabeçalho Authorization: Bearer. A chave pertence à sua conta, então ela só enxerga os seus próprios celulares, além dos números que alguém compartilhou com você.

export BUSYSMS_API_KEY=bsk_live_xxxxxxxx

# Wait up to 60 s for the next code on any of your numbers
curl -s -H "Authorization: Bearer $BUSYSMS_API_KEY" \
  "https://busysms.net/api/v1/codes?timeoutMs=60000"

// Node 18+ (built-in fetch)
const res = await fetch("https://busysms.net/api/v1/codes?timeoutMs=60000", {
  headers: { Authorization: `Bearer ${process.env.BUSYSMS_API_KEY}` },
});
if (!res.ok) throw new Error(`BusySMS ${res.status}: ${await res.text()}`);

const { code, message } = await res.json();
console.log(code ?? "No new code within 60 s", message?.sender);

import os
import requests

r = requests.get(
    "https://busysms.net/api/v1/codes",
    params={"timeoutMs": 60000},
    headers={"Authorization": f"Bearer {os.environ['BUSYSMS_API_KEY']}"},
    timeout=75,  # longer than the long-poll itself
)
r.raise_for_status()
print(r.json()["code"] or "No new code within 60 s")

Com timeoutMs acima de zero, a chamada faz long-polling por até 90 segundos e só retorna um código que chegar depois do início da requisição, nunca um anterior, porque enviar um código já usado desperdiça uma tentativa de login. Endpoints, filtros e códigos de erro estão no guia da API de gateway de SMS.

Quatro jeitos de ler os códigos

Limites que vale conhecer antes de começar

• Em um chip configurado para só códigos, só são capturadas mensagens que parecem um código de verificação; as outras ficam no celular. Nada é capturado com o gateway desligado.
• Se um código chegar com o gateway desligado, ligue-o de novo: o BusySMS recupera as mensagens de verificação dos últimos 15 minutos.
• A economia de bateria pode parar apps em segundo plano. Se os códigos pararem de chegar, tire o BusySMS da otimização de bateria e mantenha a notificação dele visível.
• As mensagens capturadas são apagadas em até 7 dias. Guarde você mesmo o que precisar por mais tempo.
• Ler códigos exige um teste ou uma assinatura ativos. Se vencer, o celular continua capturando, mas as leituras pela API e pelo MCP retornam 402 payment_required até a cobrança ser regularizada.
• Desligar o gateway não interrompe a cobrança de um número verificado. Remova o número no painel para parar de pagar por ele.

Preços

$5 por número de celular verificado ao mês, com uma semana grátis (um teste de 7 dias) em toda conta. Uma única assinatura cobre a conta inteira e é cobrada no cartão pelo Stripe no painel web: adicione um número e a fatura sobe $5; remova um e ela desce. O app Android mostra o seu plano, mas não o vende.

Dúvidas

Perguntas frequentes