Pular para o conteúdo principal

Visão geral

Os webhooks permitem que você receba uma notificação HTTP POST no seu próprio endpoint toda vez que uma conversão é concluída. Use-os para acionar fluxos de trabalho no Zapier, Make, n8n ou em qualquer backend personalizado.
Webhooks são um recurso do plano PRO. Cada usuário pode registrar até 3 endpoints de webhook.

Configuração

  1. Abra a extensão do Web2MD e vá até Settings.
  2. Role até a seção Webhooks.
  3. Digite a URL do seu endpoint e clique em Add Webhook.
  4. Copie o signing secret — você precisará dele para verificar as requisições recebidas.

Payload

Quando uma conversão é concluída, o Web2MD envia uma requisição POST para o seu endpoint com o seguinte corpo JSON:

Segurança

Toda requisição de webhook inclui um cabeçalho X-Web2MD-Signature contendo uma assinatura HMAC-SHA256 do corpo bruto da requisição, assinada com o signing secret do seu webhook.
Sempre verifique a assinatura antes de processar um webhook. Isso evita que atacantes enviem requisições forjadas para o seu endpoint.

Exemplo de verificação (Node.js)

Use crypto.timingSafeEqual em vez de === para evitar ataques de temporização (timing attacks) ao comparar assinaturas.

Comportamento de retentativas

Se ambas as tentativas falharem (resposta não-2xx ou timeout), a entrega é descartada. O Web2MD não tenta novamente além dessa única retentativa.

Casos de uso

Zapier / Make / n8n

Use um gatilho de Webhook na sua plataforma de automação para iniciar um fluxo de trabalho sempre que uma página for convertida — postar no Slack, adicionar uma linha em uma planilha ou salvar no Notion.

Notificações no Slack

Envie uma mensagem para um canal do Slack toda vez que um membro da equipe converter uma página, mantendo todos informados.

Salvamento automático em armazenamento externo

Busque o Markdown completo via REST API (usando o conversionId) e salve no S3, Google Drive ou no seu próprio banco de dados.

Pipeline de analytics

Acompanhe o volume de conversões e os tipos de conteúdo encaminhando eventos de webhook para seu backend de analytics.

Testando webhooks

Durante o desenvolvimento, use uma ferramenta como webhook.site ou ngrok para expor um endpoint local e inspecionar os payloads recebidos antes de colocar seu handler em produção.