Seu sistema pode mandar e receber SMS usando um celular Android com chip, em vez de contratar um número virtual. O TextBee transforma o aparelho em uma API para alertas, códigos de verificação e conversas de suporte. O projeto também expõe essa função por webhooks e MCP.

Isso não elimina a operadora. A mensagem ainda sai pelo plano do seu chip e segue as regras dela. A diferença é que o seu código conversa com uma API, enquanto o Android fica encarregado de enviar e receber os SMS.

O celular deixa de ser só destino e vira a saída da sua API

O TextBee tem três peças: uma API em NestJS, um painel web em Next.js e um aplicativo Android em Kotlin. Seu sistema não fala diretamente com o telefone. Ele envia o pedido para a API, que usa Firebase Cloud Messaging para avisar o app. O telefone então despacha a mensagem pela rede móvel do chip.

O caminho de volta também existe. Quando o celular recebe uma mensagem, o app manda o conteúdo para a API. Dali, ela aparece no painel, pode ser lida pelo seu software e pode disparar um webhook para outro serviço.

Painel do TextBee com dispositivos, API key e mensagens
O painel do TextBee reúne dispositivos, chaves de API, mensagens e webhooks. Imagem: TextBee.

Onde ele pode substituir uma API de SMS paga

O repositório se apresenta como alternativa ao Twilio para OTP, avisos, lembretes e SMS de duas vias. A economia existe quando seu plano de celular já inclui mensagens ou cobra pouco por elas. Mas “sem taxa por SMS” não significa custo zero: há o chip, a operadora, o telefone, energia, internet e, no auto-hosting, servidor e infraestrutura.

O ponto mais útil é usar o próprio número. Para uma clínica, uma loja local ou um sistema interno, isso pode evitar que o destinatário receba mensagem de um remetente desconhecido. Para disparos comerciais, porém, o problema de consentimento não desaparece. A ferramenta não autoriza spam.

Tela do TextBee para enviar SMS pelo dashboard
O dashboard permite enviar SMS e selecionar o dispositivo usado como gateway. Imagem: TextBee.
Histórico de mensagens SMS no dashboard TextBee
O histórico centraliza mensagens enviadas e recebidas pelos dispositivos registrados. Imagem: TextBee.

O que muda para automações e agentes de IA

O TextBee oferece um servidor MCP oficial. Em um cliente compatível, um agente pode enviar SMS, consultar respostas e listar dispositivos. Isso abre usos legítimos, como alertar a equipe quando um servidor cai ou avisar um cliente sobre uma mudança de horário.

Também aumenta o risco. Um agente que consegue disparar SMS tem acesso a um canal externo e caro de reverter. Antes de ligar essa integração, limite quem usa a chave, imponha aprovações para destinatários novos, bloqueie envios em massa sem revisão e registre cada ação. A mesma cautela vale para qualquer ferramenta que dê a agentes acesso a sistemas reais, como o MCP do Chrome que exige controle de segurança.

Assinaturas de webhooks do TextBee para SMS e status de entrega
Webhooks podem avisar seu sistema sobre mensagens recebidas e mudanças no status de entrega. Imagem: TextBee.

O projeto informa que cada entrega de webhook vem com assinatura HMAC-SHA256. Essa verificação importa: receber um POST em uma URL não prova, por si só, que ele veio do seu gateway. Seu servidor precisa validar a assinatura antes de tomar qualquer ação baseada na mensagem.

A prova: instalamos o backend, mas os testes bateram no limite de memória

A redação clonou o repositório no commit a7fe0e7 e instalou as dependências da API com o lockfile do projeto. Foram 983 pacotes no ambiente local. O manifesto da API pede Node 24.15 ou mais novo; o ambiente usado tinha Node 26.7.0.

Também iniciamos a suíte de testes do backend. Ela emitiu avisos de configuração do TypeScript e terminou com falta de memória do Node perto do limite de 2 GB. Portanto, não tratamos os testes como aprovados. O que foi confirmado localmente foi a instalação das dependências e a existência da suíte; para executá-la inteira, a máquina precisa de mais memória ou de uma divisão menor dos testes.

Envio de SMS em lote por arquivo CSV no TextBee
O envio em lote aceita CSV e deve respeitar o ritmo permitido pela operadora. Imagem: TextBee.

O lado honesto: Android, chip e regras continuam mandando

  • Android é obrigatório: iPhone não serve como gateway, porque o iOS não permite que apps enviem ou leiam SMS desse modo.
  • O telefone precisa ficar disponível: bateria, internet e permissões em segundo plano influenciam a entrega.
  • O APK não vem pela Play Store: o projeto distribui o app pelo próprio site, pois permissões de SMS são restritas na loja.
  • Auto-hospedar não é só subir um container: o stack pede MongoDB, Redis, Firebase, SMTP e HTTPS. Você também precisa configurar domínio e credenciais.
  • A licença é AGPLv3: isso merece revisão jurídica antes de adaptar o software para oferecer um serviço público baseado nele.
Dashboard do aplicativo Android do TextBee
O app Android é o componente que conversa com o chip e a rede móvel. Imagem: TextBee.
Arquitetura do TextBee entre aplicação, API, Firebase, Android e rede móvel
Arquitetura declarada pelo projeto: aplicativo, API, Firebase, Android, operadora e webhooks. Imagem: TextBee.

Como testar sem comprometer seu número principal

  1. Use um Android reserva com um chip dedicado e um plano compatível com o seu volume real.
  2. Instale o APK indicado pelo projeto e conceda apenas as permissões necessárias para SMS.
  3. Registre o aparelho no painel, gere uma chave de API e faça um envio para o seu próprio número.
  4. Crie um webhook de teste e valide a assinatura HMAC antes de integrar o fluxo ao seu sistema.
  5. Se for usar MCP, comece com uma lista fixa de destinatários e confirmação humana para cada novo número.

Para quem quer rodar infraestrutura própria, o repositório traz Docker Compose. Mas não publique o ambiente antes de trocar os segredos de exemplo, configurar Firebase, SMTP e HTTPS. E não transforme um número pessoal em máquina de disparos. Além de expor sua privacidade, isso pode fazer a linha cair em filtros de abuso.

Se o objetivo é dar a um agente um canal de comunicação externo, comece pelo princípio de menor privilégio. O agente pode preparar o texto e sugerir destinatários. A autorização para enviar deve ficar separada. Essa é a mesma lógica por trás de ferramentas que medem e controlam ações de agentes em produção.

Gancho para Reel: “Este Android velho pode virar uma API de SMS.” Mostre o painel, o celular e o caminho da mensagem até a operadora em três cortes rápidos.



Descubra mais sobre noticiAI

Assine para receber nossas notícias mais recentes por e-mail.

Deixe seu comentário