Ir para o conteúdo
CL3 Marketing Orçamento grátis

Webhook: o que é, explicado para quem toca uma empresa


Em 30 segundos

  • Webhook é o aviso que um sistema manda a outro quando um evento acontece, como pagamento aprovado, formulário enviado ou horário cancelado.
  • A API é o balcão onde o seu sistema pergunta; o webhook é o aviso que chega sozinho. As boas integrações usam os dois.
  • Se o aviso falhar, o seu sistema pode nunca saber do evento, por isso uma integração confiável tem nova tentativa, registro, conferência e alerta.
  • Ao pedir orçamento, pergunte se a ferramenta tem webhook, o que acontece quando falha, quem monitora e quem cuida quando a ferramenta mudar.

Webhook é o aviso automático que um sistema manda a outro quando algo acontece: o pagamento foi aprovado, o formulário foi enviado, o horário foi cancelado. Em vez de um programa ficar perguntando toda hora se há novidade, a novidade chega sozinha, na hora, no sistema que precisa dela.

Webhook, em linguagem de dono de empresa, é o quê?

É o equivalente digital de pedir ao porteiro que toque o interfone quando a encomenda chegar, em vez de descer de hora em hora para olhar. Um sistema (a loja virtual, o gateway de pagamento, a agenda) é programado para, quando um evento específico ocorre, enviar uma mensagem estruturada para o endereço de outro sistema (o ERP, o CRM, a planilha, o painel da equipe). O nome vem de "web" mais "hook" (gancho): um gancho na web, onde um sistema se prende ao evento do outro.

Duas ideias bastam para entender o resto:

  • Evento: o fato que dispara o aviso (pedido pago, formulário enviado, assinatura cancelada).
  • Destino: o endereço que vai receber o aviso e fazer algo com ele (liberar o pedido, criar um contato, avisar o vendedor).

Você não vê o webhook funcionando. Vê o resultado: o pedido aparece como pago sem ninguém conferir o extrato, o contato cai no CRM sem ninguém digitar. O que a empresa precisa saber é que ele existe, onde está configurado e o que acontece se falhar.

Qual a diferença entre webhook e API?

A API é o balcão onde um sistema faz perguntas e pedidos ao outro; o webhook é o aviso que o outro manda sem ser perguntado. Os dois costumam trabalhar juntos, e a escolha entre eles não é "um ou outro".

PontoAPI (consulta)Webhook (aviso)
Quem começa a conversaSeu sistema pergunta ou pede algoO outro sistema avisa quando algo acontece
Quando aconteceQuando seu sistema decide consultarNo momento do evento
Exemplo do dia a diaLigar para a transportadora e perguntar onde está a entregaA transportadora ligar quando a entrega sair
Ponto de atençãoConsultar demais gasta recurso e pode ter limite de usoSe o aviso falhar, o seu sistema pode nunca saber do evento
Uso típicoBuscar o histórico, criar um registro, atualizar um dadoReagir na hora a pagamento, cadastro, cancelamento

Numa integração bem feita, o webhook avisa que "o pedido 123 foi pago" e o seu sistema usa a API para buscar os detalhes completos desse pedido. Esse desenho é comum em integrações de loja com ERP, que o post sobre site integrado com ERP detalha, e em ligações com CRM, como em site com integração com CRM.

Que exemplos de webhook existem no dia a dia da empresa?

Quase toda automação que "acontece sozinha" entre o site e os outros sistemas é um webhook por trás. Os cinco exemplos abaixo funcionam como glossário prático: o que acontece, o que o webhook faz e o que a empresa ganha.

Pagamento aprovado libera o pedido

O gateway de pagamento avisa a loja de que o pagamento do pedido foi aprovado. A loja muda o status para pago, baixa o estoque e avisa a expedição. Sem webhook, alguém conferiria o extrato, ou a loja ficaria consultando o gateway de minuto em minuto.

Formulário avisa o vendedor

Quando um interessado envia o formulário do site, o site avisa o CRM, que cria o contato e notifica o vendedor da região. O tempo entre o pedido e o primeiro contato cai, porque ninguém depende de abrir a caixa de e-mail. O mesmo raciocínio vale para mandar a linha para uma planilha, tema do post sobre site e CRM juntos.

Agendamento cancelado reabre o horário

Quando o cliente cancela pelo link do lembrete, a agenda avisa o sistema da clínica ou do salão, que libera o horário, avisa a equipe e convida o próximo da lista de espera. É o que sustenta, por exemplo, o fluxo de um site com reserva online.

Assinatura renovada ou cancelada atualiza o acesso

Num serviço por assinatura, o aviso de renovação mantém o acesso do cliente liberado, e o de cancelamento ou falta de pagamento o suspende, sem alguém mexer na mão.

Nota fiscal emitida chega ao cliente

Quando o sistema de emissão avisa que a nota saiu, o site ou o portal do cliente anexa o arquivo ao pedido, e o cliente baixa por conta própria.

O que acontece quando o webhook falha?

O aviso se perde, e o seu sistema continua achando que nada aconteceu, a menos que a integração tenha sido desenhada para reagir a falhas. Esse é o ponto que mais separa uma integração amadora de uma confiável. Os motivos mais comuns de falha são banais: o sistema de destino ficou fora do ar por alguns minutos, o endereço mudou, a senha ou a chave expirou, o formato dos dados foi alterado numa atualização.

Uma integração bem feita prevê quatro proteções:

  • Nova tentativa: quem envia o aviso tenta de novo, em intervalos, quando o destino não responde. Muitos serviços fazem isso, mas as regras variam; confira na documentação do que você usa.
  • Registro (log): todo aviso recebido é gravado, com data, conteúdo e resultado, para a equipe técnica investigar depois.
  • Conferência periódica: uma rotina que consulta, de tempos em tempos, o que deveria ter chegado e não chegou (aqui entra a API, como rede de segurança).
  • Alerta para uma pessoa: quando algo falha repetidas vezes, alguém é avisado por e-mail ou mensagem, em vez de a falha ficar invisível.

Evite também o aviso duplicado: um mesmo evento pode chegar duas vezes, e o sistema precisa reconhecer e não gerar dois pedidos ou dois contatos. Para quem contrata, o importante é saber se alguém previu isso.

O que perguntar sobre webhook ao pedir um orçamento de integração?

Seis perguntas mostram se o fornecedor pensou na integração além do caso feliz. Leve-as para a reunião:

  1. A ferramenta que eu uso (loja, pagamento, agenda, CRM) oferece webhook? Para quais eventos?
  2. Se o aviso falhar, existe nova tentativa? Existe uma conferência que recupera o que se perdeu?
  3. Onde ficam os registros dos avisos, e por quanto tempo?
  4. Quem monitora a integração depois de entregue, e como eu sou avisado de um problema?
  5. O que acontece se o mesmo aviso chegar duas vezes?
  6. Quem cuida da integração quando a ferramenta mudar a regra ou o formato dos dados?

A última pergunta pesa no custo ao longo do tempo. Integração depende de sistemas de terceiros que mudam, então ela precisa de manutenção, e o orçamento deve dizer quem faz e como é cobrado. A conversa sobre contratar quem programa, com o perfil certo, está em web designer ou desenvolvedor: qual contratar.

Quando a integração com webhook vale o investimento?

Vale quando um trabalho manual se repete todo dia, o atraso custa dinheiro ou o erro de digitação gera retrabalho. Se a equipe confere pagamento no extrato, redigita pedido em outro sistema ou descobre um cancelamento tarde demais, existe candidato a automação. Se o volume é de quatro pedidos por semana, a planilha e uma boa rotina podem ser mais barato do que qualquer integração; a régua de decisão está em sistema web ou planilha.

A segunda decisão é entre usar o que uma plataforma pronta já integra ou construir a ligação sob medida, assunto de site com sistema próprio ou plataforma. As plataformas costumam trazer integrações prontas para os casos comuns. O sob medida entra quando o seu processo tem regra que o conector pronto não cobre. Para ter uma ideia do que pesa no custo, veja quanto custa desenvolver um sistema web e o texto sobre a diferença entre site e sistema web, que ajuda a ver em que ponto uma integração deixa de ser detalhe do site.

Como a CL3 faz integrações com webhook em sistemas web sob medida?

A CL3 parte do processo da empresa: o que acontece, em que ordem, quem precisa saber e o que hoje é feito à mão. Só depois escolhe os eventos que merecem webhook e desenha o que fazer quando o aviso falha.

Em projetos de sistema web sob medida, a CL3 entrega a integração com registro dos avisos, nova tentativa e conferência dos casos perdidos, e explica em linguagem de dono de empresa onde cada ligação está e quem a monitora. A proposta vem por escrito, com valor fechado e sem mensalidade obrigatória, e a empresa aprova uma prévia num endereço provisório antes de ir ao ar. O domínio e os acessos ficam no CNPJ do cliente.

Para pedir um orçamento sem perder tempo, liste os sistemas que a empresa usa hoje (loja, pagamento, agenda, CRM, ERP, planilha) e os dois momentos em que a equipe mais copia informação de um para outro. Com essa lista, a conversa sobre integrações em sistema web sob medida sai direto ao ponto.

Perguntas frequentes

Preciso saber programar para usar webhook?

Não para entender o que ele faz nem para decidir se vale a pena. Muitas ferramentas oferecem webhooks por configuração, e outras exigem quem programe o destino. O que o dono precisa saber é perguntar o que acontece quando o aviso falha, quem monitora e quem mantém a ligação quando a ferramenta muda.

Webhook é seguro?

Depende de como é feito. Uma integração bem desenhada confere a origem do aviso, usa conexão segura e não deixa o endereço de destino aberto a qualquer pessoa. Por trazer dados do negócio, o desenho deve ser revisado por quem entende de segurança, e a conversa sobre o que a ferramenta oferece vale antes de contratar.

Webhook substitui a integração por API?

Não: eles se complementam. O webhook avisa que algo aconteceu, e a API busca os detalhes ou executa uma ação. Muitas integrações de loja com ERP usam os dois, como mostra o post sobre site integrado com ERP.

Compartilhar no WhatsApp Marcar a CL3 como fonte preferida no Google

Pronto para ter um site que trabalha pela sua empresa?

Conte o que a sua empresa faz e a gente responde com uma proposta clara, sem enrolação.

Solicitar atendimento