Webhooks: avisos em tempo real
O que é um webhook, os 3 eventos que o Fala Cheese dispara e como usar isso pra nunca mais descobrir tarde que um post falhou.
Aula 5 de 6 · 2 min de leitura
Na aula da API, você fazia perguntas ao garçom. Webhook é o contrário: é o Fala Cheese que bate na SUA porta quando algo acontece.
Campainha vs vigiar a porta
Imagine que você espera uma encomenda. Dois jeitos de saber que chegou:
- Vigiar a porta: olhar pela janela a cada 5 minutos. Cansativo e você ainda pode perder o momento. (Em automação, isso se chama polling.)
- Campainha: o entregador aperta o botão e você fica sabendo NA HORA, sem gastar atenção antes.
Webhook é a campainha. Você cadastra uma URL sua (de um fluxo n8n, Make, Zapier), e quando o evento acontece, o Fala Cheese envia os dados pra essa URL imediatamente.
Os 3 eventos disponíveis
| Evento | Dispara quando | Uso típico |
|---|---|---|
| post.published | Um post foi publicado com sucesso | Registrar na planilha, avisar o time |
| post.failed | Uma publicação falhou | Alerta urgente pra você agir |
| comment.created | Chegou comentário num post seu | Notificação pra responder rápido |
A assinatura: como saber que foi a gente
Qualquer pessoa que descubra sua URL poderia enviar dados falsos pra ela. Por isso, todo webhook do Fala Cheese vai assinado com HMAC.
Sem entrar na matemática: você e o Fala Cheese compartilham um segredo (definido quando você cadastra o webhook). Cada aviso chega com um "lacre" calculado a partir desse segredo + o conteúdo da mensagem. Seu fluxo recalcula o lacre e compara. Bateu? A mensagem é legítima e íntegra. Não bateu? Descarte. n8n e Make têm nodes prontos pra essa verificação — você configura uma vez e esquece.
Caso prático: post falhou → alerta no Telegram
O pior jeito de descobrir que um post não saiu é abrir a rede 6 horas depois. O fluxo que resolve:
- Webhook node recebendo
post.failed - Verificação da assinatura (o lacre acima)
- Node do Telegram mandando mensagem pra você: "⚠️ O post 'X' falhou no LinkedIn: token expirado. Reconecte a conta."
Da falha ao seu bolso: segundos. Você reconecta a conta e reagenda antes que o horário bom passe.
O mesmo desenho serve pros outros eventos: comment.created virando notificação ajuda você a aproveitar a janela de engajamento; post.published alimentando uma planilha monta seu histórico sem esforço.
Regra pra levar: API é você perguntando; webhook é o sistema avisando. Operação madura usa os dois — e verifica a assinatura sempre.