API para receber SMS: códigos de verificação em números que são seus

BusySMS comparado aos serviços de número virtual

Quando usar cada um

Se você precisa de um número descartável para um teste pontual e nada vai depender dele, um número virtual é o caminho mais rápido, e o BusySMS é a ferramenta errada. Se a conta importa, como o login de administrador da sua empresa, uma conta de teste em que o seu CI entra toda noite ou o número que seus clientes já conhecem, receba em um número que é seu.

O BusySMS também não é um jeito de burlar a verificação de ninguém. Ele lê códigos enviados a números que você controla, para contas que são suas. Ele não consegue ler as mensagens de mais ninguém e não foi feito para criar contas em massa.

Como o recebimento funciona com o BusySMS

1. 1

   Coloque o receptor no celular

   No Android, o app BusySMS do Google Play. No iPhone, uma automação do Atalhos, com ou sem o app BusySMS para iPhone.

2. 2

   Verifique o número

   O BusySMS envia um código por SMS para o número e o celular o devolve. Isso prova que o chip tem o número; até lá, nada é armazenado nem cobrado.

3. 3

   Receba

   Só são guardadas as mensagens que parecem códigos de verificação. Cada uma é marcada com o número que recebeu, o remetente, o serviço detectado e o horário de chegada.

4. 4

   Leia

   O seu programa chama a API REST, um agente de IA usa o MCP, e uma pessoa vê o código no painel ou deixa a extensão para Chrome digitá-lo.

Em quais números você pode receber

• Qualquer número de um chip em um celular que é seu: um celular com Android 8.0 ou posterior e o app BusySMS, ou um iPhone com iOS 14 ou posterior pelo Atalhos.
• Cada SIM de um celular dual-SIM é um número separado, verificado e cobrado individualmente.
• Os números são verificados com um SMS de ida e volta, então você não consegue adicionar um número cujo chip não está com você.

Receba um código pela API

Crie uma chave no painel, em API REST, e guarde-a em uma variável de ambiente. Depois, espere o próximo código em um número específico:

# Digits only: the receiving number +44 7700 900123
curl -s -H "Authorization: Bearer $BUSYSMS_API_KEY" \
  "https://busysms.net/api/v1/codes?phone=447700900123&timeoutMs=60000"

const params = new URLSearchParams({ phone: "447700900123", timeoutMs: "60000" });
const res = await fetch(`https://busysms.net/api/v1/codes?${params}`, {
  headers: { Authorization: `Bearer ${process.env.BUSYSMS_API_KEY}` },
});
if (!res.ok) throw new Error(`BusySMS ${res.status}`);

const { code } = await res.json(); // null if nothing new arrived
console.log(code);

import os
import requests

r = requests.get(
    "https://busysms.net/api/v1/codes",
    params={"phone": "447700900123", "timeoutMs": 60000},
    headers={"Authorization": f"Bearer {os.environ['BUSYSMS_API_KEY']}"},
    timeout=75,
)
r.raise_for_status()
print(r.json()["code"])  # None if nothing new arrived

phone corresponde ao número que recebe (os dígitos bastam), então, com vários números na conta, você recebe o código do número certo. A espera dura até 90 segundos e retorna null em vez de um código antigo se nada de novo chegar.

Para ler o histórico em vez de esperar, liste as mensagens recentes de um celular com GET /api/v1/devices/:id/messages; as mensagens capturadas ficam guardadas por até 7 dias. Todos os endpoints e erros estão no guia da API de gateway de SMS.

O que é recebido, e o que não é

• Na configuração você escolhe, por chip Android: todas as mensagens ou só as do tipo verificação. As outras mensagens só você pode ver.
• No iPhone, a checagem acontece no próprio celular: uma mensagem que não parece um código nunca sai dele.
• Nada é capturado com o gateway desligado.
• Um número precisa passar pela verificação antes que qualquer coisa que ele receba seja armazenada.

Dúvidas

Perguntas frequentes