Documentacao

Configuracao

1. Usuarios novos devem comecar em /start.
2. Crie as tabelas do Supabase com supabase/migrations/0001_initial_schema.sql.
3. Configure o Google como provedor do Supabase Auth.
4. Configure as variaveis de ambiente do .env.example.
5. Configure a Z-API, ou seu relay, para chamar /api/whatsapp/webhook.

API publica

Use Authorization: Bearer nrn_xxxxx.

• GET /api/v1/messages
• GET /api/v1/attachments
• GET /api/v1/attachments/:id
• GET /api/v1/context
• GET /api/v1/groups
• POST /api/v1/query with {"question":"what was decided about soy?"}

Schema OpenAPI para Actions do ChatGPT: /openapi.json

MCP

Endpoint MCP remoto: /mcp

Pagina de conexao guiada: /connect

Autenticacao: OAuth MCP ou Authorization: Bearer nrn_xxxxx para testes.

Metadados OAuth: /.well-known/oauth-protected-resource e /.well-known/oauth-authorization-server.

Tools disponiveis: open_neuron, get_whatsapp_context, search_whatsapp_messages, list_whatsapp_groups, get_recent_whatsapp_messages, list_whatsapp_attachments e get_whatsapp_attachment.

ChatGPT Apps: o MCP registra o recurso ui://neuron/dashboard-v1.html para abrir uma interface simples do Neuron dentro do ChatGPT.

Anexos de WhatsApp sao expostos com preview_url do Neuron e url original. O preview abre em /a/:id para PDF, imagem, audio, video ou link direto.

PDFs recebem uma ficha curta extraida por codigo, sem OpenAI e sem consumo de tokens. PDFs escaneados ou imagens podem nao ter texto extraivel.

O Neuron nao transcreve audio nem interpreta imagem nesta versao; a IA conectada pode tentar analisar o arquivo quando o cliente permitir.

Webhook

Aponte os eventos de mensagem da Z-API para /api/whatsapp/webhook. Se WHATSAPP_WEBHOOK_SECRET estiver configurado, envie o valor no header x-neuron-secret.

Se outro app ja recebe os webhooks da Z-API, encaminhe o mesmo JSON para /api/whatsapp/webhook?secret=YOUR_SECRET.

O Apps Script pode consultar usuarios verificados do Conector em POST /api/internal/neuron/identify-phone usando x-neuron-secret.

Privacidade e grupos

Antes de conectar grupos de WhatsApp, leia /privacy, /terms e /security.

O Neuron deve ser usado com transparencia. Participantes de grupos devem estar cientes quando mensagens forem armazenadas para consulta por IA.