Como conectar um agente de IA a um sistema legado sem API?

Quase todo decisor B2B que conversa com a gente faz a mesma pergunta na segunda reunião: meu ERP é antigo, fechado, o fornecedor não libera API — dá pra ligar um agente de IA mesmo assim? Dá. Mas o caminho importa, porque alguns desses caminhos quebram em duas semanas e outros aguentam o ano inteiro. Este artigo mostra os quatro que realmente existem, o que cada um exige e quando vale a pena forçar versus contornar.

O que torna o sistema legado o gargalo de um agente de IA?

Agente de IA precisa de dois acessos pra fazer trabalho real: leitura (saber o estado atual — cliente, pedido, saldo, agenda) e escrita (registrar a ação que tomou). Sistema legado costuma travar os dois. Ou não tem API documentada, ou tem uma API parcial dos anos 2010 que só cobre 20% das telas, ou o fornecedor cobra licença separada pra liberar acesso. Sem leitura e escrita o agente vira só um chatbot bonito — e isso a empresa já tinha.

A boa notícia: quase nunca o legado é 100% fechado. Quase sempre tem uma porta — só não é a porta moderna que a documentação de qualquer plataforma de IA pressupõe. Saber qual porta usar é o que separa um piloto que entra no ar do piloto que fica seis meses em discussão técnica.

Quais caminhos existem pra ligar o agente num sistema sem API?

Existem quatro, em ordem do mais elegante pro menos elegante — e o menos elegante é frequentemente o que funciona primeiro:

1. API parcial ou módulo de integração pago. Mesmo ERP fechado costuma ter um pacote de integração que o fornecedor vende separado. Cobre menos endpoints do que o ideal, mas é estável e contratualmente seguro. Quando existe, é por aqui que se começa — vale o custo só de não depender de gambiarra.
2. Exportação em arquivo (CSV, XML, PDF) em janela programada. Muito ERP brasileiro permite agendar exportações de relatório. O agente lê o arquivo no FTP/pasta compartilhada, processa, e devolve a ação por outro arquivo de entrada que o ERP importa. Não é tempo real, mas pra fluxos diários (fechamento, conciliação, listagem de inadimplentes) resolve bem.
3. RPA na tela do sistema. Um bot navega como se fosse um humano: clica, digita, lê o que apareceu. Funciona quando não existe nem API nem exportação. Bom pra repetição alta de tela estável; ruim pra qualquer fluxo crítico, porque uma atualização de layout do fornecedor derruba tudo sem aviso.
4. Wrapper humano (agente prepara, pessoa cola). O agente faz todo o trabalho cognitivo — busca dados em outros sistemas, monta o pedido, valida regra de negócio — e entrega o resultado pronto numa fila pra uma pessoa colar no ERP. Não automatiza 100%, mas tira o operacional repetitivo da cabeça do operador e funciona em qualquer sistema, inclusive o que o fornecedor explicitamente proibiu integrar.

Quando vale forçar a integração e quando NÃO vale?

Forçar uma integração frágil custa caro em manutenção e em moral do time. A regra que a gente usa pra decidir:

• Vale forçar quando: o processo é de altíssimo volume diário, a tela do legado é estável há anos, o erro tem dono claro e o impacto financeiro do tempo economizado é grande o suficiente pra pagar manutenção mensal do conector.
• Vale forçar quando: a alternativa é contratar mais gente pra fazer o mesmo trabalho repetitivo e o sistema legado não vai sair tão cedo do ar (típico de ERP fiscal/contábil).
• NÃO vale quando: o processo é crítico (financeiro, regulatório, decisão clínica) e o caminho disponível é só RPA visual sem fallback humano.
• NÃO vale quando: o ERP tem roadmap real de substituição em 12 meses — gastar 3 meses construindo conector pra um sistema que vai morrer é dinheiro jogado fora.
• NÃO vale quando: o ganho operacional do agente é marginal. Se o processo já é raro ou pouco doloroso, deixe o humano fazer e ligue o agente em outro fluxo.

Por onde começar pra não tomar prejuízo?

Antes de qualquer integração técnica, vale uma sequência simples — quase chata de tão básica, mas que evita 80% das dores. Use este passo a passo na ordem:

1. Liste em uma página: quais sistemas o agente precisa LER e quais precisa ESCREVER. Separe os dois. Leitura readonly é muito mais barata e segura de liberar; escrita exige governança.
2. Pergunte ao fornecedor do legado, por escrito, três coisas: tem API documentada? tem módulo de integração à venda? a leitura direta do banco quebra contrato? A resposta por escrito muda a conversa interna depois.
3. Comece pela leitura. Mesmo agente só lendo já tira muita conversa do humano (consultar status de pedido, buscar histórico de cliente, conferir saldo). Escrita entra na fase 2, depois que a confiança no agente foi medida com base real.
4. Defina um dono operacional do conector — pessoa com nome, não área. Quando o fornecedor atualiza o ERP e a integração quebra, alguém precisa saber em até uma hora. Sem dono nomeado, o agente vira problema de todo mundo, ou seja, de ninguém.

Onde a Elohia se encaixa?

A Elohia entra na camada do agente — o que conversa, decide e aciona. Quando seu sistema legado tem API ou módulo de integração, a gente conecta direto e o agente já lê e escreve dentro dele. Quando não tem, a gente desenha junto com sua TI (ou com seu fornecedor de RPA, quando o caso é esse) o caminho menos frágil disponível: exportação em arquivo, banco readonly, ou wrapper humano numa fila. O que a gente NÃO faz é prometer integração mágica em sistema que o fornecedor explicitamente fechou — se for esse o cenário, a gente vai falar antes de assinar, porque é mais barato pra todo mundo descobrir agora do que descobrir na semana de go-live.

Se você está nessa decisão e ainda não definiu quais critérios usar pra escolher a plataforma de agente em si, vale ler também sobre como escolher plataforma de agentes de IA pra empresa em /blog/como-escolher-plataforma-agentes-ia-empresas e como agente entra em workflow corporativo em /blog/agentes-workflow-corporativo. Pra contabilidade especificamente — onde a dor de ERP fechado é diária — temos uma página dedicada em /solucoes/contabilidade.

Perguntas frequentes

Preciso trocar de ERP pra usar agente de IA?

Não. O agente normalmente entra por cima do ERP — lê, escreve ou aciona via API quando ela existe, ou via outros caminhos quando não. Trocar ERP é projeto de dois dígitos em meses e geralmente não é o que destrava o atendimento ou a operação que está afogada hoje.

RPA na tela serve sempre que não tem API?

Serve, mas com cautela. RPA visual funciona quando a tela do sistema é estável e o volume cabe na janela do bot. Quebra a cada atualização de layout do fornecedor e fica frágil em fluxos longos. É bom pra processos de baixa criticidade e alta repetição; ruim pra qualquer coisa onde o erro silencioso causa estrago.

Posso deixar o agente ler direto do banco do meu ERP?

Em alguns casos sim, em outros viola o contrato com o fornecedor e perde garantia/suporte. Quando é permitido, abra uma view readonly específica, com usuário dedicado e escopo mínimo. Nunca dê ao agente acesso a tabela original do ERP — uma escrita errada num campo crítico pode parar a operação.

E se o fornecedor proibir qualquer tipo de integração?

Aí o caminho é wrapper humano: o agente prepara tudo (busca cliente, monta pedido, valida regra) e entrega pronto pra uma pessoa colar no sistema. Parece pouco, mas em volume alto de tarefa repetitiva o tempo economizado já paga o agente. É menos elegante e mais honesto do que forçar uma integração que vai derrubar o suporte do fornecedor.