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
- Abra a extensão do Web2MD e vá até Settings.
- Role até a seção Webhooks.
- Digite a URL do seu endpoint e clique em Add Webhook.
- 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çãoPOST para o seu endpoint com o seguinte corpo JSON:
Segurança
Toda requisição de webhook inclui um cabeçalhoX-Web2MD-Signature contendo uma assinatura HMAC-SHA256 do corpo bruto da requisição, assinada com o signing secret do seu webhook.
Exemplo de verificação (Node.js)
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.