Integrar um agente de IA ao ERP depende menos do modelo de IA e mais de três condições do lado do sistema: acesso programático, identificador estável de produto e gravação idempotente. Sem as três, o projeto não sai — independentemente de qual IA você use.
Este texto é sobre o que verificar antes de contratar qualquer coisa. É a conversa que a gente tem com cliente na primeira reunião — e que evita descobrir, três meses depois, que o projeto era inviável desde o começo.
Por que a maioria dos projetos trava antes de chegar na IA
A conversa sobre agente de IA quase sempre começa pelo lugar errado: qual modelo usar, qual plataforma, quanto custa o token. Essas perguntas importam, mas nenhuma delas é o gargalo.
O gargalo está no acesso ao dado. Um agente que precisa criar um pedido no ERP tem que conseguir três coisas: ler o cadastro do cliente e a tabela de preço, validar as regras de negócio que já existem no sistema, e gravar o resultado de forma confiável. Se qualquer uma dessas três não for possível tecnicamente, o projeto não existe — existe uma demonstração bonita que nunca vira operação.
É por isso que a primeira reunião de um projeto sério não fala só de IA — fala de integrações. É aí que se decide se o agente vai executar processo de verdade ou apenas conversar.
Os quatro níveis de integração
“Integrado ao ERP” descreve coisas muito diferentes. Vale saber em qual nível a proposta que você recebeu se encaixa — porque o preço, o prazo e o resultado mudam completamente entre eles.
| Nível | O que o agente faz | O que exige do ERP |
|---|---|---|
| 1. Só leitura | Responde consultas: status de pedido, saldo, prazo, segunda via | API de consulta ou acesso de leitura ao banco |
| 2. Leitura e escrita | Cria registros — pedido, chamado, cadastro | API que cria, não só consulta |
| 3. Escrita com validação | Cria respeitando regra de negócio: limite de crédito, pedido mínimo, tabela do cliente | Regras consultáveis por chamada, não apenas documentadas |
| 4. Orquestração | Coordena múltiplos sistemas numa mesma execução | Acesso a todos eles, e um lugar para guardar o estado |
Uma pergunta útil para fazer ao fornecedor: “em qual desses quatro níveis está a sua proposta?” Se a resposta for vaga, a proposta provavelmente é nível 1 com apresentação de nível 4.
O checklist do lado do ERP
Cinco itens. O primeiro é eliminatório — sem ele não há integração, há automação de tela, que é outra conversa e outro nível de fragilidade.
| Requisito | Por que importa | Como verificar |
|---|---|---|
| Acesso programático | Sem API ou banco, não existe integração — só automação de tela, que quebra a cada atualização do sistema | Peça a documentação da API e confirme se ela cria registro, não só consulta |
| Identificador estável de produto | Se o mesmo item aparece com três descrições diferentes, o agente erra como um vendedor novo erraria | Exporte o catálogo e procure duplicatas do mesmo produto com códigos diferentes |
| Regra de preço consultável | A tabela do cliente precisa vir de consulta ao sistema, não da memória de alguém | Pergunte se dá para obter o preço de um cliente específico por chamada, não a lista geral |
| Gravação idempotente | Um timeout de rede não pode virar dois pedidos iguais | Confirme se a criação aceita chave externa ou código de integração para deduplicar |
| Lugar para o rastro | Meses depois alguém vai perguntar por que aquele registro saiu assim | Defina onde ficam input, ferramenta chamada e resposta do ERP — antes de ligar o agente |
O item que mais surpreende é o segundo. Catálogo malpadronizado é o problema mais comum e o menos esperado — e não é um problema de IA. Se ninguém da sua equipe consegue dizer com certeza qual código corresponde a qual produto, nenhum modelo vai adivinhar. Isso se resolve antes, e do seu lado.
Compatibilidade por ERP
| ERP | Acesso programático | O que esperar |
|---|---|---|
| Omie | API oficial | Caminho direto, inclusive gravação de pedido |
| Bling | API oficial | Caminho direto |
| Sankhya | API oficial | Caminho direto |
| TOTVS Protheus | Varia | Depende da versão e do nível de customização |
| SAP Business One | Varia | Depende da versão e do nível de customização |
| ERP sem API | Só banco, ou automação de tela | Último recurso: quebra a cada atualização do sistema |
Sobre os dois casos marcados como “varia”: Protheus e SAP Business One são sistemas altamente customizáveis, e é justamente a customização que decide o escopo. Uma instalação padrão costuma ter caminho direto; uma instalação com dez anos de adaptações feitas por fornecedores diferentes exige um levantamento antes de qualquer promessa de prazo.
Uma boa notícia para quem usa ERP conhecido: na maioria dos casos a integração não precisa ser construída do zero. A HopeAgents opera com mais de 40 conectores nativos — incluindo Omie, Bling, Sankhya, TOTVS Protheus, SAP Business One, Senior, SEFAZ/NF-e e WhatsApp Business — além de qualquer API externa via REST ou webhook. E quando o conector não existe, a gente desenvolve: ele passa a fazer parte da plataforma. O trabalho de projeto se concentra no que é específico da sua operação — as regras de negócio, não o encanamento.
Vale registrar também que não existe arquitetura única. A forma como o agente conversa com o ERP — o que consulta em tempo real, o que valida antes de gravar, como trata indisponibilidade — se define caso a caso, a partir do sistema, do volume e das regras de negócio de cada operação. Desconfie de quem chega com a solução pronta antes de olhar o seu processo.
O que costuma atrasar o projeto
Na maior parte dos projetos que demoram mais que o previsto, o atraso não vem da tecnologia. Vem de quatro coisas que estão do lado de quem contrata — e que dá para adiantar antes mesmo da primeira reunião.
Catálogo sem padronização
É o campeão. O mesmo produto cadastrado três vezes, com descrições diferentes e códigos diferentes, herdado de anos de operação. Enquanto isso não for resolvido, nenhum agente vai acertar consistentemente — e nem um vendedor humano novo acertaria.
Acesso ao ERP que depende de terceiros
Quando o ERP é mantido por outro fornecedor, liberar credencial de acesso pode virar um projeto à parte. Vale abrir essa conversa cedo, antes de contratar qualquer automação — a resposta define prazo e, às vezes, viabilidade.
Regra de negócio que ninguém consegue escrever
“Depende” é a resposta mais cara de um projeto de automação. Se o desconto varia conforme a relação com o cliente e ninguém sabe explicar o critério, não há regra a implementar. Automatizar exceção sem critério é automatizar o improviso.
Falta de dono do projeto
Automação toca comercial, fiscal, logística e TI ao mesmo tempo. Sem uma pessoa com autoridade para decidir e responder rápido, cada validação vira uma semana. É o fator que mais alonga cronograma — e o único que não se resolve com dinheiro.
Como começar sem virar piloto abandonado
- Escolha um processo e um recorte. “Pedido de recompra de clientes ativos” é um bom começo. “Todo o comercial” não é.
- Meça o baseline antes. Quantas vezes por mês, quanto tempo cada uma, quantos erros. Sem esse número você nunca vai saber se funcionou.
- Comece com humano no circuito. Nas primeiras semanas o agente monta e uma pessoa confirma antes de gravar. Você descobre os erros de catálogo com custo baixo.
- Defina o que acontece quando o agente não sabe. A regra de escalonamento é parte do projeto, não detalhe. Agente que inventa resposta para não admitir dúvida é o pior resultado possível.
Em operação, isso funciona: numa indústria alimentícia, um agente integrado ao Omie processa mais de 340 pedidos por mês, 24 horas por dia, com 100% dos pedidos lançados no ERP sem redigitação. O caminho até lá passou por cada um dos quatro passos acima. O detalhamento desse fluxo está no guia de automação de pedidos pelo WhatsApp.
Quer saber se o seu ERP tem caminho? A HopeAgents faz uma conversa de 20 minutos para verificar a viabilidade técnica antes de propor qualquer coisa — inclusive para dizer quando não vale a pena. Falar com um especialista.
Perguntas frequentes
Qual o primeiro passo para integrar um agente de IA ao ERP?
Verificar se o ERP tem acesso programático que cria registros, não apenas consulta. É o requisito eliminatório: sem ele não existe integração, apenas automação de tela, que quebra a cada atualização do sistema.
Preciso construir a integração do zero?
Nem sempre. Para os ERPs mais usados no Brasil já existem conectores nativos prontos — a HopeAgents opera com mais de 40. E quando o conector não existe, ele é desenvolvido e passa a fazer parte da plataforma. Nos dois casos, o trabalho de projeto se concentra nas regras de negócio da sua operação, não na construção da conexão.
Quanto tempo leva uma integração de agente de IA com ERP?
Varia bastante conforme a complexidade do processo. Pode levar de dias a semanas, dependendo do nível de integração, do estado do catálogo e das regras de negócio envolvidas. Com conector nativo disponível, o prazo tende a cair. O que mais atrasa projeto não é a IA — é catálogo malpadronizado e falta de um dono da decisão do lado do cliente.
Meu ERP não tem API. Ainda dá para automatizar?
Dá, com acesso ao banco de dados ou automação de tela — mas trate como último recurso, não como plano. Automação de tela quebra a cada atualização do sistema e gera manutenção recorrente. Vale antes verificar se o fornecedor do ERP oferece API em versão mais nova.
O que é gravação idempotente e por que importa?
É a capacidade de a mesma operação ser executada duas vezes sem gerar dois registros. Importa porque falha de rede acontece: se o agente tentar gravar de novo após um timeout e a API não deduplicar, você terá dois pedidos idênticos no sistema.
Existe uma arquitetura padrão para integrar IA ao ERP?
Não. O desenho da integração depende do ERP, do volume, das regras de negócio e do nível de disponibilidade exigido. Fornecedor que apresenta arquitetura fechada antes de conhecer o processo está vendendo produto, não resolvendo problema.
Preciso trocar de ERP para usar agente de IA?
Na maioria dos casos, não. Omie, Bling e Sankhya têm caminho direto. TOTVS Protheus e SAP Business One dependem da versão e do nível de customização — mas raramente a conclusão é trocar o ERP, e sim ajustar o escopo da integração.
A HopeAgents constrói e opera agentes de IA que executam processos ponta a ponta, integrados ao WhatsApp, ao seu ERP e às suas APIs, com rastreabilidade de cada decisão. É um produto da SystemHope, software house brasileira com mais de 25 anos de engenharia de software. Fale com um especialista.