Como integrar um agente de IA ao seu ERP, CRM e gateway de pagamento

Um agente de IA sem integração é uma FAQ com sotaque melhor. O valor aparece quando ele consegue ler e escrever nos sistemas onde a empresa realmente opera — o ERP, o CRM, o gateway de pagamento, a agenda, o sistema de chamados.

Este post é sobre a parte que dá trabalho de verdade: desenhar essas conexões sem criar um buraco de segurança nem um monstro de manutenção.

O conceito central: ferramenta (tool)

Para o agente, uma integração é uma ferramenta: uma função com nome, descrição e parâmetros tipados, que ele pode escolher chamar. O modelo não "acessa o banco" — ele decide chamar consultar_pedido(numero) e recebe de volta um JSON. Quem executa é o seu backend, com as credenciais e as regras de sempre.

Três consequências práticas disso:

• A descrição da ferramenta é parte do produto. "Consulta o pedido pelo número; use quando o cliente perguntar sobre status, prazo ou rastreio" funciona muito melhor que "get order".
• O que a ferramenta não expõe, o agente não vê. Segurança é decidida no desenho da função, não no texto do prompt.
• Erro de ferramenta precisa ser texto útil. {"erro":"pedido não encontrado"} faz o agente pedir o número de novo. Um 500 cru faz ele improvisar.

Comece pelas ferramentas de leitura

Ordem que evita sustos: leitura antes de escrita.

Ferramentas de leitura típicas:

• consultar_pedido(numero | cpf) — status, prazo, transportadora
• consultar_cliente(documento) — cadastro, contratos ativos, pendências
• consultar_fatura(id) — valor, vencimento, situação
• consultar_disponibilidade(servico, periodo) — horários livres na agenda

Já esse conjunto resolve a maior parte do volume de suporte de nível 1, com risco quase zero: se algo der errado, o pior caso é uma resposta incompleta.

Depois, as de escrita — com trava

Ferramentas de escrita mudam o mundo real e merecem cuidado extra:

• gerar_link_pagamento(fatura, valor)
• emitir_segunda_via(fatura)
• agendar(servico, horario, cliente)
• abrir_chamado(assunto, descricao, prioridade)

Quatro travas que valem para todas elas:

1. Idempotência. Toda escrita precisa de uma chave de idempotência derivada do caso (por exemplo, o id da fatura + o dia). Modelos repetem chamadas quando a rede falha; sem essa trava, o cliente recebe três cobranças.

2. Limite de alçada. Valor acima de X, desconto acima de Y, cancelamento — não executa: escala para humano com o contexto pronto.

3. Escopo mínimo de credencial. A chave que o agente usa não é a chave de administrador do ERP. É um usuário próprio, com permissão apenas nos endpoints das ferramentas, e auditável.

4. Registro de tudo. Cada chamada gravada com entrada, saída, duração e a conversa que a originou. Sem isso, não há como responder "por que o agente fez isso?" — pergunta que vai aparecer.

Onde o MCP entra

O Model Context Protocol (MCP) padronizou a forma de expor ferramentas para agentes. Em vez de cada agente ter seu próprio código de integração, você sobe um servidor MCP por sistema — um para o ERP, um para o financeiro, um para a agenda — e qualquer agente da empresa passa a poder usá-lo.

O ganho não é técnico, é organizacional: a integração vira ativo reutilizável. O segundo agente custa uma fração do primeiro, porque as ferramentas já existem. E a governança fica em um lugar só — quem pode chamar o quê é decidido no servidor, não espalhado por dez prompts.

Quando o sistema não tem API

Situação frequente no Brasil: o ERP é antigo, o fornecedor cobra caro pelo módulo de integração ou simplesmente não existe API. Alternativas, em ordem de preferência:

1. Banco de dados em réplica de leitura. Uma view somente-leitura com os campos necessários resolve boa parte das consultas, sem tocar no sistema.
2. Exportação agendada. Um arquivo diário/horário para uma tabela intermediária. Aceita dado com atraso; não serve para saldo em tempo real.
3. Camada intermediária (BFF). Um pequeno serviço que fala com o sistema legado do jeito que der (inclusive arquivo ou fila) e expõe HTTP limpo para o agente.
4. Automação de interface. Último recurso, frágil, quebra a cada atualização de tela. Use com prazo de validade declarado.

O que não funciona é adiar o agente até o ERP ser trocado. Comece pelas consultas possíveis hoje e amplie conforme a integração amadurece.

Como o agente escolhe a ferramenta certa

Alguns cuidados de desenho reduzem drasticamente o erro de escolha:

• Poucas ferramentas, bem nomeadas. Vinte ferramentas parecidas confundem o modelo. Prefira uma função com parâmetros a cinco variações.
• Descrições com o quando, não só o o quê. Diga em que situação usar e em que situação não usar.
• Parâmetros validados no servidor. Nunca confie no formato que o modelo enviou: CPF, datas e valores passam por validação normal antes de chegar ao sistema.
• Retorno enxuto. Devolver o objeto inteiro do ERP com 80 campos gasta tokens e atrapalha. Devolva os campos que o atendimento usa. (Esse detalhe aparece direto na fatura — veja quanto custa manter um agente.)

Latência: o requisito esquecido

Conversa é síncrona. Se a ferramenta demora 12 segundos, o cliente manda outra mensagem antes da resposta e a conversa embaralha.

Padrões que resolvem:

• Responda em duas etapas. "Deixa eu verificar aqui" e, terminado, a resposta com o dado. Isso mantém a conversa viva e é honesto.
• Timeout curto com fallback. 5 a 8 segundos; se estourar, avise que o sistema está lento e ofereça retorno — o agente volta sozinho quando obtiver a informação.
• Cache do que muda pouco. Tabela de preço, políticas, horários de funcionamento.

Um roteiro de implantação de duas semanas

1. Liste os cinco pedidos mais frequentes da sua fila de atendimento. Eles definem as ferramentas.
2. Implemente as leituras correspondentes e coloque o agente em modo somente-consulta.
3. Rode uma semana com humano supervisionando as conversas e corrija instruções e retornos.
4. Ative uma escrita — a de menor risco, normalmente gerar link de pagamento ou abrir chamado — com idempotência e alçada.
5. Meça resolução sem humano, erro de ferramenta e tempo de resposta. Só então adicione a próxima escrita.

Sem pular a etapa 3. É nela que se descobre que o campo "status" do ERP tem sete valores e três significam a mesma coisa.

Para continuar

Se o seu caso é atendimento, siga por agente de IA para suporte nível 1. Se for financeiro, automatizar cobrança no WhatsApp mostra o desenho completo com gateway de pagamento. E se quiser olhar as suas integrações com alguém do lado, agende 40 minutos.