Integração via API com IA: como conectar ERP, CRM e planilha

Quarta, fim da manhã. O vendedor fecha a venda no CRM e avisa no grupo. No financeiro, alguém abre o ERP e digita de novo o cliente, os itens e o prazo pra emitir a nota. No fim do mês, a planilha de comissão é montada copiando das duas telas. E o cliente maior nem usa o portal: manda o pedido em PDF por e-mail.

Na reunião com o fornecedor do ERP, a resposta veio rápida: "o sistema tem API, dá pra integrar". Dá mesmo. O que ninguém explicou é o que essa integração faz sozinha, e o que ela faz com aquele PDF.

O que é integração via API

Integração via API é ligar dois sistemas para que um mande dado ao outro sozinho, sem ninguém copiar e colar. A venda fechada no CRM vira pedido no ERP, e a nota emitida no ERP vira linha na planilha. Quando o dado chega em texto livre, como um pedido escrito à mão ou numa mensagem, a inteligência artificial entra antes e entrega o dado já arrumado pra integração levar.

A API é a porta que um sistema abre pra outro programa conversar com ele, em vez de uma pessoa clicando na tela. O glossário de API da MDN, da Mozilla, descreve a API como um contrato entre o sistema que a oferece e quem usa. O contrato diz o que o sistema aceita receber, em que formato, e o que devolve.

Quem busca o que é integração via API, ou só integração api, quase sempre tem um caso na cabeça: a loja que precisa mandar o pedido pro ERP, o CRM que precisa saber se o cliente pagou. Muita gente chama de API de integração ou de integração de API, e é a mesma coisa. Integração de sistemas é o nome do projeto inteiro, e a API é o caminho mais comum pra fazer.

Como funciona a integração via API: requisição, resposta e webhook

Toda conversa por API tem as mesmas partes. É assim que o CRM pede ao ERP pra criar um pedido:

• O endereço. Cada tipo de dado tem um endereço próprio, o endpoint: um pros pedidos, outro pros produtos, outro pras notas.
• A identificação. A chamada leva uma chave ou um token, que prova quem está pedindo e o que pode fazer.
• O pedido. Vai junto o método (buscar, criar, alterar ou apagar) e os dados, quase sempre em JSON, um texto com campo e valor.
• A resposta. O sistema devolve um código dizendo se deu certo, e os dados pedidos.

O estilo mais comum é o REST, que usa os métodos do próprio protocolo da web. Quando alguém lista os tipos de API, aparecem também o SOAP, mais antigo e rígido, e o GraphQL, em que quem pergunta escolhe os campos que quer. Pra ligar ERP e CRM de empresa pequena, quase sempre é REST.

Nos três, é o seu lado que pergunta. No webhook, é o sistema que avisa: quando um pedido é criado, ele manda a novidade pra um endereço que você cadastrou. A documentação de webhooks do Bling, ERP comum em empresa pequena, consultada em outubro de 2026, mostra como isso anda. O aviso sai quando um pedido, produto, estoque ou nota é criado, alterado ou excluído. Se o seu lado não responde, o Bling tenta de novo por até 3 dias e depois desliga o aviso daquele recurso, até alguém religar.

Essa última frase quase nunca aparece na reunião com o fornecedor: a integração pode parar calada.

Como conectar ERP, CRM e planilha por API

O passo que mais pesa vem antes de qualquer tela técnica: decidir qual sistema é a fonte da verdade de cada dado. Alguém precisa decidir se o cadastro do cliente nasce no CRM ou no ERP, e se o preço que vale é o da tabela do ERP ou o que o vendedor digitou. Se dois sistemas podem alterar o mesmo campo, a integração sobrescreve um com o outro, e ninguém sabe depois qual era o certo.

Com isso decidido, a integração com ERP, CRM e planilha costuma seguir esta ordem:

• Liste o que é digitado duas vezes. Cada linha é um dado, de onde ele sai e pra onde vai. É ali que a integração rende primeiro.
• Confira se os dois lados têm API. ERP, CRM e loja virtual costumam ter, e a página de desenvolvedor do fornecedor diz quais dados dá pra ler e gravar. Planilha do Google tem API. Planilha de Excel guardada no computador de alguém, não.
• Leia os limites. O Bling aceita 3 requisições por segundo e 120.000 por dia, segundo a página de limites do Bling. A API do Google Sheets aceita 60 leituras e 60 gravações por minuto por usuário, segundo a documentação atualizada em setembro de 2026. Passou disso, os dois devolvem erro, e a integração precisa saber esperar e tentar de novo.
• Escolha como amarrar. Conector pronto do próprio sistema, ferramenta de automação ou código próprio. Numa ferramenta como o n8n, o nó HTTP Request chama qualquer sistema com API REST, mesmo sem conector pronto. Escrevi sobre o que é n8n e quando a regra fixa basta.

Sistema sem API ainda tem saída, só que mais frágil: exportar um arquivo todo dia e importar no outro, ler o e-mail de aviso que ele manda ou, em último caso, um robô que clica na tela como uma pessoa faria. Cada um desses quebra quando a tela ou o arquivo muda. Antes de montar a gambiarra, pergunte ao fornecedor se a API existe num plano acima.

Onde basta a regra e onde a IA entra na integração

A integração via API é regra fixa: pega o campo do valor de um lado e põe no campo do valor do outro. Ela é barata, previsível e faz igual toda vez, desde que o dado nasça arrumado dentro de um sistema. A venda fechada no CRM e a nota emitida no ERP são assim, e aí não precisa de IA nenhuma.

O pedido em PDF da cena do começo não nasce em sistema nenhum. Nem o "me manda 40 daquelas caixas pra semana que vem" no WhatsApp, nem o e-mail do fornecedor com o boleto anexo. Nenhuma regra fixa entende texto livre. É aqui que a automação com IA entra: a IA lê a mensagem ou o documento e devolve os campos que a API do outro lado espera.

Pra isso funcionar, o modelo precisa devolver os campos sempre no mesmo formato. A OpenAI e a Anthropic têm um recurso pra isso, a saída estruturada. A documentação de saída estruturada da Anthropic, consultada em outubro de 2026, diz que ela obriga a resposta a seguir o formato combinado, pronta pro próximo sistema ler. O formato vem garantido, o valor não. A IA pode trocar o vencimento pela data de emissão, e o campo sai perfeito, com a data errada dentro.

Por isso, cada dado cai num destes lugares:

• Dado que nasce num sistema: regra fixa pela API, sem IA.
• Dado que chega em PDF, foto, e-mail ou WhatsApp: IA na leitura, regra fixa daí em diante.
• Leitura com dúvida ou fora do padrão: fila pra uma pessoa conferir antes de virar pedido ou dinheiro.

O jeito de tirar os campos de nota, boleto e guia, e de conferir essa leitura, está no post sobre extração de dados de documentos.

Como implementar a integração via API na empresa

Comece pela cópia que mais dói. Pegue a lista de dados digitados duas vezes e escolha um fluxo só, com começo e fim claros, como "venda fechada no CRM vira pedido no ERP". É o primeiro passo do protocolo antivibe, mapear o terreno: entender como o dado anda hoje antes de abrir qualquer ferramenta.

Antes de ligar, isto precisa estar pronto:

• O dado. Os campos de cada lado, com nome e formato. CNPJ com ou sem ponto, data em que ordem, produto pelo código ou pelo nome.
• A regra. Qual sistema manda em cada campo, o que acontece com pedido cancelado, o que fazer quando o cliente ainda não existe do outro lado.
• Quem confere. Uma pessoa que recebe o aviso quando a integração falha e olha a fila do que a IA não leu com segurança.
• O acesso. A chave da API guardada num lugar só, com a permissão mínima que a integração precisa.

O ChatGPT, o Claude ou o Gemini ajudam nesse trabalho, mesmo sem time técnico:

• Ler a documentação. Mande a página de desenvolvedor do ERP e peça a lista de campos do pedido, quais são obrigatórios e o que cada código de erro quer dizer.
• Montar o mapa de campos. Cole o cabeçalho da planilha e a lista de campos da API e peça a correspondência, marcando o que não tem par. Confira linha por linha com quem usa a planilha.
• Entender o erro. Quando a chamada falhar, mande a resposta inteira, sem a chave de acesso, e peça a explicação em português.

O assistente pode até abrir o navegador e testar uma chamada por você, mas é você quem pede a cada vez, e isso é uso geral. A integração que roda sozinha toda vez que a venda fecha é ferramenta própria, a segunda das camadas da IA na empresa, e precisa de alguém que monte e cuide dela. No Colaboratório, eu monto essas integrações para empresas que querem parar de digitar a mesma informação duas vezes, começando por um fluxo só e medindo o antes e o depois.

O que a integração faz sozinha continua sendo decisão sua

A API executa o que foi desenhado, rápido e sem cansar. Os limites desse desenho continuam sendo seus:

• O que passa direto. Venda fechada no CRM pode virar pedido no ERP sem ninguém olhar. Pedido lido de um PDF pela IA, com valor fora do normal ou cliente novo, para numa fila.
• Quem confere a leitura da IA. Uma pessoa olha o que a IA marcou como dúvida e, no começo, uma amostra do que ela marcou como certo.
• Quem é avisado quando para. A senha muda, o fornecedor atualiza a API, o webhook é desligado depois de dias sem resposta. Alguém precisa receber o aviso no mesmo dia e saber o que fazer.
• Que dado sai da empresa. Cada documento lido pela IA vai pra quem roda o modelo. Contrato e dado pessoal de cliente pedem ler antes os termos do fornecedor, e a LGPD vale aqui também.

Por isso, nada que vira nota, cobrança ou pagamento sai de uma leitura da IA sem uma pessoa poder conferir. Ficou mais fácil ligar sistemas, mas continua sendo trabalho: você para de digitar e passa a decidir o que pode passar sem ninguém olhar.

Até empresa grande deixa sistema sem conversar

Se a sua empresa ainda tem sistema que não conversa, ela está bem acompanhada. No relatório de conectividade da MuleSoft, publicado em 2025 com mais de 1.050 líderes de TI, a empresa média usa 897 aplicativos e só 29% deles estão integrados. As equipes de TI dessas empresas gastam 39% do tempo construindo integração sob medida.

São empresas grandes, com time de TI inteiro, e a maior parte dos sistemas continua sem conversar. Pra empresa pequena, a conta que fecha é escolher a cópia que mais custa, integrar essa primeiro e decidir quem confere antes de ligar.

Ligar o ERP, o CRM e a planilha por API acaba com a digitação dupla. A IA entra onde o dado chega bagunçado, em PDF, WhatsApp ou e-mail, e a regra fixa não dá conta. Decidir o que integrar primeiro e pôr no ar é o trabalho de uma primeira rodada. Montei uma página sobre integração de sistemas pra quem tem ERP, CRM e planilha que ainda não conversam. E se o pedido em PDF do começo deste texto ainda é digitado à mão aí, entre em contato comigo e conte qual informação a sua equipe digita duas vezes.