Documentacao

Servicos independentes e nao oficiais

Os produtos Neuron funcionam de forma independente no WhatsApp e em plataformas de IA. A Neuron nao e afiliada, endossada, operada ou patrocinada pela Meta, WhatsApp, OpenAI, Anthropic ou Z-API.

Configuracao

Usuarios novos devem comecar em /start.
Crie as tabelas do Supabase com supabase/migrations/0001_initial_schema.sql.
Configure o Google como provedor do Supabase Auth.
Configure as variaveis de ambiente do .env.example.
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?"}
POST /api/v1/send-message with {"destination":"Contas a Pagar","message":"Texto"}
POST /api/v1/send-document with {"destination":"Contas a Pagar","document_url":"https://.../nota.pdf","file_name":"nota.pdf"}

Envio e uma acao de escrita. Use apenas apos confirmacao explicita do usuario sobre destino e conteudo.

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 de leitura: open_neuron, get_whatsapp_context, search_whatsapp_messages, list_whatsapp_groups, get_recent_whatsapp_messages, list_whatsapp_attachments e get_whatsapp_attachment.

Tools de envio: send_whatsapp_message e send_whatsapp_document. Elas exigem permissao whatsapp:write e devem ser usadas somente apos confirmacao explicita.

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.