Conectada
ErgonERP IA
Assistente da loja
Ligando…
00:00
Fale com naturalidade. A conversa também aparece no chat.
Use o aplicativo oficial do ChatGPT (web, iPhone e Android) conectado ao seu ERP. Crie um GPT Personalizado com Actions (OpenAPI) e pergunte por voz ou texto: vendas, metas, estoque e financeiro — com a mesma segurança da plataforma.
Central de suporte
Orientações rápidas para usar o ErgonERP IA no dia a dia.
Selecione a empresa correta e comece uma conversa com uma solicitação objetiva.
Informe período, loja e o nível de detalhe esperado sempre que isso for importante.
Clique em um exemplo para levá-lo ao campo de mensagem.
As opções visíveis dependem das permissões definidas para seu usuário.
Envie PDF ou foto de boletos e produtos quando seu perfil permitir.
Grave uma solicitação e revise o áudio antes de enviar.
Toque em Ligar para conversar em tempo real por voz, como em uma ligação. A IA ouve, consulta o ERP e responde falando.
Retome, renomeie ou exclua conversas salvas.
Peça análises detalhadas e baixe PDFs quando a resposta oferecer o arquivo.
Conecte o ErgonERP a ferramentas de IA como Cursor, VS Code Copilot e Claude Desktop.
McpServer\configurar_mcp.bat na pasta de instalação (geralmente C:\Ergontech\ErgonERPIA\McpServer\). O assistente irá gerar automaticamente a configuração para o seu editor de IA.
{
"mcpServers": {
"ergon-erp": {
"command": "C:\\Ergontech\\ErgonERPIA\\McpServer\\ErgonMcpServer.exe",
"env": {
"ERGON_CONNECTION_STRING": "Server=SEU_SERVIDOR;Database=SEU_BANCO;User Id=sa;Password=SUA_SENHA;TrustServerCertificate=True;"
}
}
}
}
~/.cursor/mcp.json~/.vscode/mcp.json%APPDATA%\Claude\claude_desktop_config.json
Reinicie o editor de IA após configurar o MCP Server para que as ferramentas sejam carregadas.
Transforme o ChatGPT em um consultor executivo do Ergon ERP com acesso em tempo real a vendas, metas, estoque, preços e financeiro.
https://sua-empresa.ergonerp.com).A chave de API é o token de autenticação seguro que permite ao ChatGPT conversar com o seu ERP:
ChatGPT Diretoria ou Assistente Loja).erg_live_...). Guarde-a em local seguro.O Schema OpenAPI 3.1.0 ensina o ChatGPT quais ferramentas ele pode executar no seu ERP:
https://seu-servidor/api/openapi.json.consultarErgonERP (somente leitura — sem confirmação extra no ChatGPT)alterarErgonERP (gravação no ERP — exige autorização do usuário)conversarErgonERP (legado: conversa livre)consultarVendasHoje (vendas em tempo real por loja)consultarMetas (metas mensais e percentual atingido)buscarProdutosERP (consulta de preços e estoque por descrição/EAN)consultarContasPagar (títulos a vencer e compromissos)consultarEstoqueBaixo (alerta de reposição)
Ergon ERP Consultor & Gestão (ou o nome da sua empresa/loja).Assistente inteligente conectado ao Ergon ERP para vendas, metas, estoque, preços e financeiro.No campo Instructions do ChatGPT, cole as instruções abaixo para garantir respostas executivas e precisas:
# PAPEL DO ASSISTENTE Você é o Consultor Executivo Oficial do ERP Ergontech. Sua missão é fornecer análises de vendas, metas, estoque, preços e financeiro, e executar alterações somente com autorização. # ROTEAMENTO DE ACTIONS 1. Consultas (vendas, metas, estoque, produtos, preços, clientes, contas, caixas, indicadores): chame IMEDIATAMENTE consultarErgonERP. Não peça confirmação extra para leitura. 2. Qualquer cadastro, alteração, exclusão ou movimentação: NÃO grave de imediato. Mostre a prévia (operação, empresa/filial, registro, valor atual, valor novo, quantidade, impactos). Só depois de o usuário responder sim, ok ou confirmo, chame alterarErgonERP com a mensagem iniciando por Confirmo e repetindo o comando completo (ou envie historico com a prévia). 3. Nunca envie comando de gravação para consultarErgonERP. # DIRETRIZES OPERACIONAIS 1. Apresente valores no padrão Real brasileiro (ex.: R$ 1.450,00). 2. Ao analisar vendas, compare com a meta do mês (percentual atingido e projeção). 3. Seja executivo, direto e use marcadores ou tabelas quando apropriado.
https://seu-servidor/api/openapi.json).consultarErgonERP (leitura, sem confirmação extra) e alterarErgonERP (gravação, com autorização).erg_live_...).https://seu-servidor/privacidade (a OpenAI exige este link obrigatório para permitir salvar o GPT).erg_live_ desta loja, ativa em Integração IAs. Em Authentication, use API Key e Auth Type Bearer. Se o proxy bloquear Authorization, use Auth Type Custom com cabeçalho X-Api-Key. Reimporte o schema depois de atualizar o servidor.Conecte o ErgonERP diretamente aos Apps Personalizados do Google Gemini Spark (gemini.google.com/spark/apps) via protocolo oficial MCP sobre HTTPS.
https://your-app-link.com/mcp, ela está solicitando o endereço do servidor MCP remoto do seu ERP.
No menu superior, clique em Conectar IAs ➔ aba Chaves de API. Se ainda não tiver uma chave ativa, clique em + Nova Chave para obter seu token de autenticação (ex: erg_live_...).
Na aba 🔌 MCP Server (IA), defina um nome único do app (ex.: ErgonERP Jayne Modas) e clique em "📋 Copiar Link do MCP". O Spark usa esse nome no cartão e no atalho @. O link fica assim:
https://seu-dominio.proxy.ergonerp.online/mcp/ergonerp-jayne-modas?token=erg_live_...&nome=ErgonERP%20Jayne%20Modas
Na tela "Apps personalizados para o Spark" (no site gemini.google.com/spark/apps):
• Cole a URL copiada no campo que possui o exemplo https://your-app-link.com/mcp.
• Clique no botão azul Avançar.
• O Google Gemini Spark faz o handshake e cria o app com o nome que está no link (não dá para mudar isso na tela do Gemini se já existir outro MCP).
Assim que conectado, o Gemini Spark ganha acesso direto a 7 ferramentas operacionais do ERP:
• conversar_ergon_erp: comando universal em linguagem natural para qualquer consulta ou operação.
• consultar_vendas_hoje: resumo de faturamento e atendimentos do dia.
• consultar_metas: metas mensais das filiais e percentual atingido.
• buscar_produtos: pesquisa de preços, saldo de estoque e código EAN.
• consultar_contas_pagar: títulos a pagar e compromissos futuros.
• consultar_estoque_baixo: alerta de produtos com saldo crítico ou zerado.
• buscar_cliente: busca de clientes por CPF/CNPJ ou nome.
Agora você pode conversar naturalmente com o Spark! Exemplos de comandos que funcionam imediatamente:
"Quanto vendemos hoje na loja?"
"Qual é o preço e o estoque do produto Camiseta?"
"Quais contas a pagar vencem nos próximos 15 dias?"
"Como está o atingimento da meta da loja este mês?"
Respostas para os problemas mais comuns de uso.
Cada usuário visualiza apenas os recursos liberados pelo administrador. Solicite a revisão do perfil caso uma função necessária não apareça.
Use o seletor de empresa na barra superior. Quando houver mais de um banco configurado, selecione primeiro o banco e depois a loja.
O navegador pode bloquear o microfone em conexão HTTP. Ao tentar gravar, siga o guia exibido pelo sistema ou use a seleção de um arquivo de áudio.
Clique em “Início” ou “Nova conversa”. A conversa atual será limpa e uma nova solicitação poderá ser iniciada.
Ao solicitar atendimento, informe seu usuário, a empresa selecionada e uma descrição do que ocorreu.
Nenhum conteúdo encontrado. Tente buscar com outra palavra.
O sistema guarda o CNPJ e, no “sim”, consulta a Receita na hora — sem recomeçar com olá. Depois lista as lojas se houver mais de uma.
Depois de enviar o CNPJ, o “sim” dispara a consulta oficial e mostra razão, situação e endereço. Não volta mais para o cumprimento.
No Histórico das IAs: hoje, ontem, 7 ou 30 dias, este mês ou intervalo personalizado. Tabelas e abas no contraste do tema claro.
No chatbot da API, o “sim” da consulta CNPJ usa o histórico da conversa. A Receita é consultada e o cadastro segue, sem recair no olá da loja.
Cliente, CNPJ, produto, fornecedor e atendimento: se houver mais de uma empresa ou banco, o sistema pede qual usar. Uma loja só continua cadastrando nela.
POST /api/externa/chat com numero_whatsapp pede o login da plataforma antes de consultar o ERP. Sem o número, a chave continua valendo sozinha.
Se existir mais de um banco, o formulário mostra qual SQL a chave usa. Edite nome, loja, usuário e, se precisar, gere um token novo.
Converse por voz no formato de ligação: a IA ouve, consulta o ERP e responde falando, na mesma conversa do chat.
Antes de consultar o ERP, o zap pede o usuário e a senha cadastrados na plataforma. Sessão válida por 3 horas. /sair encerra.
Servidor Evolution nativo (QR, mídia, webhook) e chatbot inbound: mensagem no WhatsApp vira conversa com a IA.
Administração
Defina o que cada pessoa pode fazer no chat e vincule ao usuário do Ergon (TbCad_Usuario) para auditoria fiel das alterações no banco de dados.
Cadastrados
Gestão Comercial
Cadastre e acompanhe as metas mensais de faturamento por empresa no ERP.
Metas no ERP
Planejamento Orçamentário & Financeiro
A IA analisa o histórico do ano anterior e projeta os 12 meses de despesas por centro de custo e empresa no ERP (TbCad_FinanceiroCentroCustoPrevisao).
| Centro de Custo | Grupo / Subgrupo | Gasto Anterior | Média Mensal | Projeção (+Taxa) | % Orçamento | Criticidade | Ações |
|---|---|---|---|---|---|---|---|
| Clique em "Analisar Histórico (IA)" para carregar o comparativo. | |||||||
Registros em TbCad_FinanceiroCentroCustoPrevisao
| ID | Empresa | Centro de Custo | Vencimento | Valor Previsto | Status | Ações |
|---|---|---|---|---|---|---|
| Nenhuma previsão registrada para o período selecionado. | ||||||
Centro de Custo
Detalhamento dos 12 meses do ano com valores do ano anterior e projeção com taxa de correção.
| Mês | Gasto Real Anterior | Previsão Sugerida (IA) |
|---|
Administração
Edite o prompt do sistema que define o comportamento da assistente. Use {DATA} para inserir a data atual automaticamente.
Administração
Gerencie os bancos SQL Server do Ergon e o backup do SQLite da plataforma (usuários, conversas e configurações).
Cópia do SQLite local (ergon_ia.db): usuários, conversas, chaves de API, agendamentos e configurações. Não inclui o SQL Server do Ergon.
Administração de Produtos
Configure obrigatoriedades, padrões e regras tributárias e operacionais do ERP por ramo de atividade.
Cada produto (pizza, hambúrguer, lanche, açaí, pastel) deve ter sua própria categoria de adicionais e impressora de produção associadas no ERP.
| Produto | Categoria de Adicionais | Impressora Comanda | Ação |
|---|---|---|---|
| Digite o nome do produto ou clique em Buscar para listar os produtos do ERP. | |||
Administração da Plataforma
Status, credenciais e serviços externos integrados ao ErgonERP IA.
Insira uma ou várias chaves de API do Google Gemini (uma por linha ou separadas por vírgula). Se uma chave ficar sem saldo ou com cota esgotada (RESOURCE_EXHAUSTED / 429 / 402 / 403), o Ergon ERP IA alternará automaticamente para a próxima chave sem interromper o atendimento ao usuário.
Roteador universal de alta performance via router.flatkey.ai/v1/chat/completions com compatibilidade total à especificação OpenAI. Permite utilizar modelos como gpt-4o-mini, gpt-4o, claude-3-5-sonnet, deepseek-chat e outros com uma única chave Bearer unificada.
Insira sua chave de 73 caracteres para habilitar a consulta instantânea e cadastro automático de clientes PJ no Ergon ERP.
Relatórios & Apresentações Executivas
Slides interativos com métricas, gráficos e indicadores em tempo real para reuniões, diretoria e exportação para PDF.
Servidor de Instaladores
Verificação de novas versões do ErgonERP IA.
Ativa todos os dias durante a madrugada (03:00) — seu sistema sempre atualizado sem parar a operação.
O instalador oficial está sendo aplicado e os serviços serão reiniciados automaticamente.
Aguardando o serviço reiniciar com a nova versão...
Microfone e Áudio via HTTP
Navegadores de computador bloqueiam a captura de microfone em conexões http:// (sem SSL). Selecione seu navegador para ver o passo a passo:
false para true.💡 No celular (Android ou iPhone), o microfone já funciona diretamente via gravador nativo sem precisar de configuração.
Conversas do Usuário
Acesse, continue ou gerencie todas as suas conversas gravadas com a assistente.
Você ainda não iniciou nenhuma conversa ou nenhuma conversa bate com o termo pesquisado.
Automação de Relatórios
Configure o envio automático de relatórios de vendas, metas, estoque baixo e análises inteligentes da IA por e-mail.
| Título / Assunto | Destinatários | Conteúdo | Frequência / Horário | Próximo Envio | Status | Ações |
|---|---|---|---|---|---|---|
| Carregando agendamentos... | ||||||
Automação de Relatórios
Configure o envio automático de relatórios de vendas, metas, estoque baixo e análises inteligentes da IA por WhatsApp.
| Título | Destinatários | Conteúdo | Frequência / Horário | Próximo Envio | Status | Ações |
|---|---|---|---|---|---|---|
| Carregando agendamentos... | ||||||
Conectividade & Inteligência Artificial Externa
Integre o Google Gemini (direto no chat gemini.google.com via Gems e Google AI Studio), OpenAI ChatGPT, Claude e assistentes externos aos dados em tempo real do seu ERP.
Crie seu Gem Oficial no Google Gemini preenchendo exatamente os 4 campos abaixo na tela de Novo Gem:
No Gemini, clique no botão + Adicione arquivos de referência para o Gem e selecione este arquivo para ensinar ao Gem todas as lojas, metas cadastradas e regras do seu ERP:
O Ergon ERP responde no protocolo oficial do Google Gemini (/v1beta/models/{model}:generateContent) e oferece schema de ferramentas (Tools JSON) para Function Calling.
Copie a URL abaixo e cole no campo Import from URL na configuração de Actions do seu Custom GPT no ChatGPT:
Conecte o Claude Projects para geração de relatórios de diretoria com alta densidade de contexto, gráficos interativos e projeções financeiras.
O Ergon ERP implementa os padrões globais de comunicação com IAs e automações:
Aceita POST /v1/chat/completions com header Authorization: Bearer SUA_CHAVE.
Aceita POST /v1beta/models/{model}:generateContent?key=SUA_CHAVE ou header x-goog-api-key.
Bot de WhatsApp (n8n / Evolution / Dify): além da chave erg_live_, envie o número em
numero_whatsapp (ou header X-WhatsApp / query). Sem sessão a API devolve o pedido de
usuário e senha da plataforma em resposta — o fluxo só encaminha esse texto ao zap.
Sessão de 3 horas. Preferir POST /api/externa/chat com
{"mensagem":"olá","numero_whatsapp":"5593..."}.
O MCP Server permite que Google Gemini Spark (Apps Personalizados), Cursor, VS Code Copilot e Claude Desktop acessem diretamente os dados do seu ERP — clientes, produtos, estoque, vendas, financeiro e notas fiscais — de forma segura e padronizada.
O Spark tem os mesmos recursos da plataforma: consultas (vendas, ranking de vendedores em todas as lojas/bancos, estoque, financeiro) em conversar_ergon_erp e gravações (atendimento, cadastro, estoque) em alterar_ergon_erp, com prévia e confirmação. Identifica o app pelo nome no link e pelo ícone PNG. Após atualizar o servidor, reconecte o app no Spark.
Atalho no chat: @ErgonERP IA
Cada IA (Gemini, ChatGPT, Claude, Bot) deve utilizar uma chave de API para segurança e auditoria.
✅ Nova Chave de API gerada com sucesso!
Copie sua chave agora. Por segurança, ela não será exibida por completo novamente:
| Nome da Aplicação | Token / Chave | Banco / Loja | Usuário Ergon | Criada Em | Último Uso | Status | Ações |
|---|---|---|---|---|---|---|---|
| Carregando chaves... | |||||||
| Data / Hora | IA / Aplicação | Ação / Endpoint | Pergunta / Prompt | Resposta Gerada | Tempo | Status | Detalhes |
|---|---|---|---|---|---|---|---|
| Carregando histórico... | |||||||
Auditoria de Execução
Inspeção completa de requisição e resposta do ERP.
Ações Rápidas da IA
Revise por banco de dados e por empresa. Ações gravam no ERP da origem do recado.
Comunicação Interna
ErgonERP IA
Ligando…
00:00
Fale com naturalidade. A conversa também aparece no chat.