Webhook

Um webhook é um callback HTTP que envia automaticamente dados de uma aplicação para outra quando um evento específico ocorre. Diferente das [APIs](/glossary/api) onde você consulta por atualizações, webhooks enviam dados em tempo real conforme os eventos acontecem. A aplicação receptora aguarda em um endpoint URL especificado e processa os dados recebidos imediatamente. Webhooks seguem um modelo publicador-assinante: a aplicação de origem envia uma requisição HTTP POST para uma URL pré-registrada sempre que um evento disparador ocorre, e o assinante processa o payload sem nunca precisar solicitá-lo.

Webhooks eliminam a necessidade de transferências manuais de dados ou polling constante entre sistemas. Para editores digitais, isso significa que leads capturados, transações de vendas e atividade de visualizadores podem fluir automaticamente para CRMs, plataformas de e-mail ou bancos de dados internos no momento em que acontecem. Isso reduz atrasos de minutos ou horas para milissegundos, elimina o trabalho manual de exportação-importação e garante que seus sistemas empresariais sempre tenham dados atualizados. Sem webhooks, equipes precisam verificar dashboards manualmente ou construir processos em lote que ficam atrás dos eventos em tempo real.

O recurso de [automação e integrações](/features/automation-and-integrations) do FlipLink suporta webhooks que disparam quando eventos-chave ocorrem. Você pode configurar endpoints de webhooks para receber dados quando um novo lead é capturado, um documento é visualizado ou uma venda é completada via Stripe. Cada webhook envia um payload JSON estruturado contendo os detalhes do evento para sua URL especificada. Isso permite conectar o FlipLink a virtualmente qualquer sistema, incluindo ferramentas como Zapier, Make ou backends personalizados. Combinados com a [integração Google Sheets](/features/automation-and-integrations), webhooks oferecem aos editores uma forma flexível de automatizar todo o fluxo de trabalho de publicação sem escrever código.

Quando um evento disparador ocorre, o FlipLink envia uma requisição HTTP POST para seu endpoint URL registrado. O corpo da requisição contém um payload JSON estruturado assim: - **Tipo de evento** — uma string identificando o evento (ex.: `lead.captured`, `document.viewed`, `sale.completed`) - **Timestamp** — data e hora do evento no formato ISO 8601 - **Dados do payload** — os campos específicos do evento como nome do contato, e-mail, título do documento ou valor da transação Seu endpoint deve retornar um código de status HTTP 200 para confirmar o recebimento. Se o endpoint retornar um erro ou expirar o tempo, o FlipLink tenta novamente a entrega para garantir que nenhum evento seja perdido. Todos os payloads de webhooks são enviados via [HTTPS](/glossary/https), então os dados são criptografados em trânsito. Para desenvolvedores construindo integrações personalizadas, a estrutura JSON consistente facilita analisar e rotear eventos para o handler correto em sua aplicação.

1. **Prepare seu endpoint.** Configure uma URL HTTPS em seu servidor, Zapier, Make ou qualquer serviço que possa receber requisições POST. O endpoint deve ser publicamente acessível e retornar uma resposta 200. 2. **Navegue até integrações.** No seu painel FlipLink, vá para as configurações de [automação e integrações](/features/automation-and-integrations) da sua publicação. 3. **Adicione a URL do webhook.** Cole a URL do seu endpoint no campo de configuração do webhook. 4. **Selecione os eventos disparadores.** Escolha quais eventos devem acionar o webhook — captura de lead, visualização de documento, conclusão de venda ou outros conforme suas necessidades de fluxo de trabalho. 5. **Envie um evento de teste.** Use a função de teste para enviar um payload de exemplo para seu endpoint. Verifique se seu sistema recebe e processa os dados corretamente. 6. **Coloque em produção.** Salve sua configuração. A partir deste ponto, todo evento correspondente no seu [flipbook](/glossary/flipbook) acionará um POST em tempo real para seu endpoint. 7. **Monitore a entrega.** Verifique os logs do seu endpoint periodicamente para confirmar que os webhooks estão chegando. Se notar falhas, verifique se seu endpoint está retornando respostas 200 e se seu servidor não possui regras de firewall bloqueando requisições do FlipLink.

| Aspecto | Webhook | API Polling | |---------|---------|-------------| | **Entrega de dados** | Push automático quando eventos ocorrem | Pull em um cronograma definido | | **Latência** | Quase instantânea (milissegundos) | Depende do intervalo de polling (segundos a minutos) | | **Carga do servidor** | Mínima — requisições acontecem apenas quando eventos disparam | Maior — requisições acontecem a cada intervalo mesmo sem mudanças | | **Implementação** | Registrar uma URL e tratar requisições POST recebidas | Construir um job agendado que chama o endpoint da API repetidamente | | **Ideal para** | Notificações em tempo real, sincronização com CRM, alertas instantâneos | Processamento em lote, relatórios periódicos, snapshots de dados | | **Risco** | Indisponibilidade do endpoint pode perder eventos sem lógica de retry | Sem eventos perdidos se o polling acompanhar, mas conhecimento atrasado | Para a maioria dos editores FlipLink, webhooks são a melhor escolha para eventos de captura de leads e vendas onde a velocidade importa. API polling funciona melhor para exportações periódicas de analytics ou dashboards que atualizam em intervalos fixos. Muitas equipes usam ambos: webhooks para roteamento de leads em tempo real e a [REST API](/glossary/rest-api) para extrações noturnas de analytics.