Fio Raiz

Gateway de WhatsApp auto-hospedado com API HTTP, MCP e painel — escrito do zero, sem dependências de produção, em Node 24 + TypeScript e SQLite embutido.

• API HTTP com chave em x-api-key: sessões, mensagens, contatos, etiquetas, grupos, webhooks, busca, estatísticas, configurações e chaves.

• MCP em POST /mcp (JSON-RPC 2.0) com 10 ferramentas próprias.

• Painel de leitura em GET /painel, sem build e sem framework.

• Zero dependências de produção: npm ci não baixa runtime; o banco é node:sqlite, o servidor é node:http.

Começar

git clone https://github.com/Voltolini-SPACE/fio-raiz && cd fio-raiz
npm ci            # só ferramentas de desenvolvimento (typescript)
npm test          # 23 testes, node --test
npm start         # http://127.0.0.1:2790

A chave nasce em data/.api-key com modo 0600. Use:

CHAVE=$(cat data/.api-key)
curl -s http://127.0.0.1:2790/api/health
curl -s -H "x-api-key: $CHAVE" -X POST -H 'content-type: application/json' \
  -d '{"nome":"Atendimento"}' http://127.0.0.1:2790/api/sessions

Related MCP server: WhatsApp Business API MCP Server

O que já funciona

Sessões com ciclo de vida (criar, iniciar, parar, parear, status, QR), envio de texto e mídia, listagem paginada, contatos, etiquetas, grupos, webhooks com entrega e histórico de falha, busca, estatísticas, configurações, chaves de API, MCP e painel. O ensaio real está em EVIDENCIA.md.

Limites declarados

• O transporte de WhatsApp é uma porta com implementação simulado (src/motor/). Não há biblioteca de WhatsApp embutida; o adaptador real é trabalho futuro declarado em PARIDADE.md.

• Plugins, ingress, integrações, exportação/importação, métricas Prometheus e auditoria não estão implementados — cada rota aparece em PARIDADE.md como excluído, com data.

• Não há paridade 100% com nenhum outro produto, e não é o objetivo.

Documentos

Licença MIT — LICENSE · NOTICE.