Integração de Sistemas via API: O Guia Para Não-Técnicos

"Nossos sistemas não conversam entre si." O vendedor fecha no CRM, alguém digita o pedido no ERP, outra pessoa copia para a planilha do financeiro. Cada cópia é tempo perdido e uma chance de erro. Integração via API resolve isso fazendo os sistemas trocarem dados sozinhos. Este guia explica, sem jargão, como funciona, quanto custa e como fazer sem criar um problema novo.

O que é uma API

API (Application Programming Interface) é a porta oficial que um sistema abre para outros sistemas conversarem com ele. Em vez de uma pessoa entrar na tela e digitar, um programa envia os dados diretamente, num formato combinado.

Analogia: pense no garçom de um restaurante. Você não entra na cozinha; faz o pedido ao garçom, que leva à cozinha e traz o prato. A API é o garçom: recebe pedidos num formato padrão e devolve respostas, sem que um sistema precise conhecer o funcionamento interno do outro.

Os termos que você vai ouvir

• REST e JSON: o padrão mais comum hoje. O sistema faz uma requisição a um endereço (por exemplo, "criar pedido") e envia os dados em JSON, um formato de texto organizado.
• Webhook: o caminho inverso. Em vez de você perguntar a cada minuto "tem pedido novo?", o sistema avisa você no momento em que algo acontece.
• Token / chave de API: a senha que identifica quem está fazendo a requisição e o que pode fazer.
• Limite de requisições (rate limit): quantas chamadas por minuto o sistema aceita. Importante em integrações com volume alto.

Integrações que mais dão retorno

Loja virtual + ERP

Venda na loja gera o pedido no ERP, baixa o estoque e dispara a nota fiscal. Estoque alterado no ERP aparece na loja. Sem isso, a empresa vende produto que não tem ou deixa de vender o que tem. ERPs populares no Brasil, como Bling, Tiny e Omie, têm API pública.

Formulário do site + CRM

O lead preenche o formulário e cai no funil de vendas com origem, campanha e página de entrada. O vendedor recebe uma notificação na hora. Responder em minutos, e não no dia seguinte, faz diferença grande na conversão.

Pagamento + financeiro + nota fiscal

O gateway confirma o pagamento por webhook, o sistema financeiro registra a receita e a nota é emitida automaticamente. Elimina a conciliação manual no fim do mês.

CRM + WhatsApp

Mudança de etapa no funil dispara uma mensagem pela API oficial do WhatsApp Business: confirmação de reunião, envio de proposta, lembrete de pagamento. Veja mais em automação de WhatsApp Business.

Exemplo real: do pedido à nota fiscal

Um fluxo típico que implemento para lojas pequenas:

1. Cliente paga na loja virtual.
2. A loja envia um webhook "pedido pago" para o integrador.
3. O integrador cria o pedido no ERP via API, com cliente, itens e frete.
4. O ERP baixa o estoque e emite a NF-e.
5. O integrador devolve o número da nota e o código de rastreio para a loja, que avisa o cliente.
6. Se qualquer etapa falhar, alguém da equipe recebe um alerta com o número do pedido.

O passo 6 é o que separa uma integração profissional de uma gambiarra: falhas vão acontecer (sistema fora do ar, dado inválido), e alguém precisa saber.

Três formas de integrar

1. Conectores prontos

Muitos sistemas já se integram nativamente: a loja tem um "app" do ERP, o CRM tem integração com o formulário. Sempre verifique isso primeiro. É a opção mais barata e com menos manutenção.

2. Plataformas no-code

Ferramentas que ligam sistemas por blocos visuais:

• Zapier: o maior catálogo de aplicativos, simples de usar, fica caro com volume alto.
• Make: mais flexível para fluxos com condições, preço melhor por operação.
• n8n: código aberto, pode rodar no seu próprio servidor sem custo por execução.
• Pluga: brasileira, com conectores para sistemas nacionais.

O custo vai de zero a algumas centenas de reais por mês, conforme o volume de execuções.

3. Desenvolvimento sob medida

Necessário quando não há conector, quando o volume é alto ou quando a regra de negócio é específica. Um projeto de integração costuma custar de R$ 2.000 a R$ 20.000, dependendo do número de sistemas e da complexidade. A vantagem é controle total sobre tratamento de erro, desempenho e custo de operação.

Quando vale a pena integrar

Uma conta simples ajuda a decidir. Some as horas mensais gastas digitando dados de um sistema no outro e multiplique pelo custo da hora de quem faz isso. Some também o custo dos erros (pedido enviado errado, nota refeita, cliente cobrado em dobro).

Se a equipe gasta 20 horas por mês copiando pedidos e a hora custa R$ 30, são R$ 600 por mês, ou R$ 7.200 por ano. Uma integração de R$ 4.000 se paga em menos de sete meses, sem contar os erros evitados.

Cuidados para não criar um problema novo

• Mapeie o processo antes: desenhe quem gera cada dado, onde ele precisa chegar e qual sistema é a "fonte da verdade" para cada informação (estoque, preço, cadastro do cliente).
• Teste em ambiente separado: a maioria dos sistemas oferece sandbox. Nunca teste emitindo nota fiscal de verdade.
• Trate duplicidades: webhooks podem chegar duas vezes. A integração precisa reconhecer um pedido já processado e não criar outro.
• Monitore e alerte: registre cada execução e avise alguém quando falhar.
• Permissão mínima: o token da integração deve acessar só o necessário. Se vazar, o estrago é limitado.
• LGPD: dados pessoais de clientes trafegam entre sistemas. Use conexões HTTPS, guarde só o necessário e saiba onde cada dado fica.

FAQ