Automação
API e webhook: integração entre sistemas explicada para gestores
Em toda conversa sobre automação aparecem duas palavras: API e webhook. Quem decide o investimento geralmente não é técnico e fica sem saber se o que está sendo proposto é simples ou complicado, barato ou caro. Este texto explica as duas coisas sem código, do ponto de vista de quem precisa decidir.
Por que integrar sistemas
A maior parte do trabalho manual em um escritório existe porque os sistemas não conversam. A venda é registrada em um lugar e alguém copia para outro. O pagamento cai no banco e alguém dá baixa no financeiro. Cada cópia consome tempo e abre espaço para erro.
A Asana estimou, no Anatomy of Work Index de 2021, que cerca de 60% do tempo em trabalho de escritório vai para atividades em torno da tarefa, como procurar informação e passar dados de um lugar para outro. Integrar sistemas ataca diretamente essa fatia. O princípio é um só: o dado entra uma vez e chega sozinho a todos os lugares que precisam dele.
O que é uma API
API é a porta de serviço de um sistema. Pela tela, quem usa é uma pessoa: ela clica, digita e lê. Pela API, quem usa é outro sistema: ele pede uma informação ou manda uma instrução, em um formato combinado, e recebe a resposta.
Uma comparação que ajuda: a tela é o salão do restaurante, a API é o balcão de pedidos para entrega. O prato é o mesmo, mas o balcão foi feito para atender pedidos em volume, sem conversa.
Quando um fornecedor diz que o sistema "tem API", ele está dizendo que outros sistemas conseguem consultar e gravar dados ali sem que ninguém precise abrir a tela. Vale perguntar o que exatamente a API permite, porque algumas liberam só consulta e outras cobrem quase tudo.
O que é um webhook
Com a API, um sistema precisa perguntar: "chegou pagamento novo?". Para saber rápido, teria que perguntar o tempo todo. O webhook inverte a direção. É um aviso automático: quando algo acontece, o sistema de origem manda uma mensagem para um endereço combinado. "Pagamento confirmado, pedido 1048."
Voltando ao restaurante: a API é você ligar para saber se o pedido saiu. O webhook é o restaurante avisar quando sai.
Na prática, os dois trabalham juntos. O webhook avisa que algo aconteceu, e a API é usada em seguida para buscar os detalhes e gravar o resultado em outro lugar.
Quando usar cada um
| Situação | Caminho usual |
|---|---|
| Reagir na hora a um evento (pagamento, mensagem recebida, formulário enviado) | Webhook |
| Buscar ou gravar dados sob demanda | API |
| Rotina com hora marcada (relatório diário, conferência noturna) | API em tarefa agendada |
| Sistema antigo sem API nem webhook | Exportação de arquivo ou troca de sistema |
A última linha é a que mais pesa em decisão de compra. Um sistema barato sem porta de integração sai caro, porque condena alguém a copiar dados para sempre.
Como uma integração fica na prática
Imagine uma loja que vende pelo site e atende pelo WhatsApp. Hoje, quando um pedido é pago, uma pessoa confere o banco, marca o pedido como pago, avisa o estoque e manda mensagem ao cliente. Com integração, o fluxo fica assim:
- O meio de pagamento envia um webhook: pagamento confirmado.
- A automação recebe o aviso e, pela API da loja, marca o pedido como pago.
- Pela API do sistema de estoque, reserva os itens.
- Pela API oficial do WhatsApp, envia a confirmação ao cliente.
- Registra tudo em um histórico e avisa uma pessoa se alguma etapa falhar.
Ninguém tocou em nada, e o cliente recebeu a confirmação em segundos. O quinto passo é o que separa uma integração séria de um improviso.
Perguntas para fazer ao fornecedor ou a quem vai construir
Você não precisa entender o código. Precisa fazer as perguntas certas.
- O que acontece quando falha? Sistemas saem do ar. A integração precisa tentar de novo e avisar alguém, não perder o dado em silêncio.
- Onde vejo o que rodou? Deve existir um registro do que entrou, do que saiu e do que deu erro.
- Quem recebe o alerta? Uma pessoa com nome, não "o time".
- Como as senhas e chaves são guardadas? Chave de API é como a chave da empresa. Não fica em planilha nem em mensagem.
- A API é oficial? Integração por caminho não oficial costuma quebrar quando o sistema muda e pode violar os termos de uso. No WhatsApp isso é especialmente importante, como explicamos em Agente de IA no WhatsApp.
- Existe limite de uso? Muitas APIs limitam o número de chamadas por minuto ou cobram por volume.
Integração boa é a que ninguém percebe até o dia em que falha. E, nesse dia, ela avisa.
Plataforma pronta ou código próprio
Existem dois caminhos para construir, e nenhum é sempre melhor.
Plataformas de automação ligam sistemas conhecidos com blocos visuais. São rápidas para começar e boas para fluxos simples. O custo cresce com o volume, e fluxos complexos ficam difíceis de manter.
Código próprio dá mais controle sobre regras, segurança, custo por volume e tratamento de falhas. Exige quem mantenha.
O critério é o mesmo de qualquer decisão de processo: escolha o menor sistema que resolve. Muitas operações convivem bem com os dois, usando plataforma no que é simples e código no que é crítico.
Por onde começar
Liste os sistemas que a empresa usa e, para cada par, responda: que dado alguém copia de um para o outro hoje? Essa lista é o seu mapa de integrações. Ordene por tempo gasto e risco de erro, como mostramos em O que automatizar primeiro, e comece pela primeira.
Automação de rotinas e integrações é um dos serviços da delpra™. Se quiser saber em que ponto a sua operação está antes de investir, o diagnóstico gratuito mostra.
Escrito pela equipe delpra™Processos, automação e IA para a operação escalar com eficiência.