Imagem gerada por IA para a LHCX (ElevenLabs), 19/10/2026
Como integrar sistemas com API e webhook
Para integrar dois sistemas, pelo menos um deles precisa de uma API: um endereço que aceita pedidos para consultar, criar ou alterar dados. O webhook é o caminho inverso: o sistema avisa o outro, com uma requisição, assim que algo acontece. Na prática, a integração usa os dois: o webhook avisa e a API busca ou grava os dados.
Atualizado em · Por Luis Henrique Cuba
API e webhook: qual a diferença
Os dois trocam dados pela internet, no mesmo formato (em geral JSON sobre HTTPS). A diferença é quem começa a conversa. Na API, o seu sistema pergunta. No webhook, o outro sistema avisa sem ser perguntado.
| API | Webhook | |
|---|---|---|
| Quem começa | O seu sistema faz o pedido | O outro sistema envia o aviso |
| Quando usar | Consultar, criar ou alterar dados quando você precisa | Saber na hora que algo mudou (pagamento, pedido, cadastro) |
| Sem o outro | Para saber de mudanças, é preciso perguntar de tempos em tempos | O aviso chega, mas costuma trazer só o essencial |
| Exemplo no Omie | Consultar um cliente ou lançar uma conta a pagar | Avisar que um cadastro foi incluído ou alterado |
Como integrar dois sistemas, passo a passo
- 01
Escreva o fluxo em uma frase
Quando acontecer X no sistema A, fazer Y no sistema B. Exemplo: quando um pedido for pago na loja, criar o lançamento no ERP. Se não cabe em uma frase, divida em mais de uma integração.
- 02
Leia a documentação de API dos dois sistemas
Procure três coisas: como autenticar (chave, token), os limites de requisição e se existe webhook para o evento que dispara o fluxo.
- 03
Faça o de-para dos campos
Uma tabela com o campo de origem, o campo de destino e a regra de conversão (formato de data, código de produto, centro de custo). É aqui que a maioria das integrações quebra.
- 04
Escolha onde a integração vai rodar
Ferramentas como n8n, Make ou Zapier resolvem boa parte dos casos sem programar. Código próprio faz sentido quando o volume é alto ou a regra é muito específica.
- 05
Receba o webhook e responda rápido
O endpoint (o endereço que recebe o aviso) registra o evento e responde na hora. O processamento pesado vem depois, para não estourar o tempo de resposta que o sistema de origem espera.
- 06
Confirme pela API, grave e registre
Busque os dados completos pela API, grave no destino e guarde um registro do que foi feito. Sem registro, não há como saber o que falhou.
- 07
Trate erro e reprocesse
Defina o que acontece quando o destino está fora do ar ou recusa o dado: tentar de novo, avisar alguém e permitir reprocessar depois.
Exemplo real: o webhook do Omie
O Omie avisa outro sistema por webhook quando um evento marcado acontece, como um cadastro incluído ou alterado. O webhook é configurado na Área do Desenvolvedor, em Aplicativos, por um usuário administrador, que informa a URL do endpoint e escolhe os eventos.
Pelas regras publicadas na Central de Ajuda do Omie, o endpoint precisa responder 2XX em poucos segundos. Se falhar, o Omie tenta de novo e, persistindo o erro, guarda o evento em uma fila de reprocessamento por até 5 dias. Por isso a integração registra o aviso e responde na hora, e só depois consulta a API e grava no outro sistema.
A API do Omie também tem limites de requisição por minuto e de chamadas simultâneas. Integração que ignora esses limites funciona no teste e trava no primeiro dia de volume.
Cuidados de segurança
- Guarde chaves e tokens no servidor ou nas credenciais da ferramenta de automação, nunca no navegador nem na planilha.
- Use só endereços HTTPS para receber webhooks.
- Confira a origem do aviso: quando o sistema oferece token ou assinatura no webhook, valide antes de processar.
- Prepare o fluxo para receber o mesmo evento duas vezes (as tentativas de reenvio fazem isso). Processar duas vezes não pode gerar dois lançamentos.
- Não confie só no conteúdo do aviso: confirme pela API antes de gravar algo importante, como um pagamento.
Erros comuns
Processar tudo dentro do webhook
O sistema de origem espera resposta em poucos segundos. Se a integração consulta, grava e manda e-mail antes de responder, o aviso dá erro e volta a chegar.
Ignorar os limites da API
Uma carga inicial com milhares de registros dispara bloqueio por excesso de requisições. A integração precisa esperar e tentar de novo.
Não guardar registro
Quando um dado some, ninguém sabe se o aviso não chegou, se o destino recusou ou se a regra estava errada.
De-para incompleto
Um código de produto ou de cliente que existe em um sistema e não no outro trava o fluxo inteiro. Defina o que fazer com o que não tem par.
Quando vale contratar alguém
Um fluxo simples entre duas ferramentas com conectores prontos dá para montar sozinho no n8n, no Make ou no Zapier. Vale contratar quando o fluxo mexe com dinheiro ou nota fiscal, quando um dos sistemas não tem conector pronto, quando o volume esbarra nos limites da API ou quando ninguém da equipe vai cuidar dos erros.
Como integrar sistemas com API e webhook: dúvidas comuns
O que é webhook, em uma frase?
É um aviso automático que um sistema manda para outro, por uma requisição HTTP, quando algo acontece, como um pagamento confirmado ou um pedido criado.
Qual a diferença entre API REST e webhook?
Na API REST, o seu sistema faz o pedido quando precisa. No webhook, o outro sistema avisa por conta própria. A maioria das integrações usa os dois: o webhook avisa e a API busca os dados completos.
Todo sistema tem API?
Não. Quando não tem, as alternativas são exportações em arquivo, leitura direta do banco de dados (se permitido), e-mails automáticos ou, em último caso, automação da tela. Cada uma tem riscos diferentes.
Preciso saber programar para integrar dois sistemas?
Para fluxos simples, não: n8n, Make e Zapier têm conectores prontos e montam a integração arrastando blocos. Para regras específicas, volume alto ou sistemas sem conector, entra código ou uma configuração mais técnica.
Como integrar meu sistema com o Omie?
Pela API oficial do Omie, com as chaves de acesso do aplicativo (App Key e App Secret), e pelos webhooks para saber das mudanças na hora. A página de integração com o Omie traz os limites e os cuidados.
Perguntas parecidas
Mais sobre automação
- Como instalar o n8n
- Como integrar o WhatsApp com o n8n
- n8n vs Zapier vs Make
- Como automatizar o Google Sheets
- Como automatizar relatórios em Excel com Python
- Estratégia de automação de dados: como montar a sua
- Como gerar link de pagamento na iugu pela API
- Webhook da iugu: como atualizar o status do pedido em tempo real
Ficou com alguma dúvida sobre o guia?
Escreva a sua dúvida. A LHCX responde pelo e-mail ou pelo WhatsApp que você deixar.