Skip to main content

​
O que são Webhooks

Webhooks são requisições HTTP que o Vistum envia automaticamente para uma URL da sua escolha quando um evento acontece no CRM — por exemplo, quando um novo lead chega, uma mensagem é recebida ou um card muda de etapa. Diferente de polling (ficar fazendo GET a cada X segundos), webhooks são push: você recebe a notificação imediatamente, sem desperdício de requisições.
Esta página trata dos webhooks de saída (outbound): Vistum → seu sistema. O caminho inverso — um sistema externo enviando eventos para dentro do CRM (Hotmart, Kiwify, Eduzz, n8n, formulários) — tem cota própria e está em Webhooks de Entrada.

​
Como configurar

1

Abra as configurações de Webhooks

Acesse Configurações → Desenvolvedor → Webhooks no CRM.
2

Crie um novo webhook

Clique em Novo Webhook e preencha:
  • URL: endpoint HTTPS que receberá as notificações
  • Eventos: selecione quais eventos deseja receber
  • Descrição: identificação amigável (ex: n8n-pipeline)
3

Copie o secret

O Vistum gera um secret de assinatura para cada webhook. Guarde-o — você precisará dele para verificar a autenticidade das requisições.
4

Teste com Ping

Use o botão Ping para enviar um evento test.ping e confirmar que a URL está recebendo corretamente.

​
Requisitos da URL

  • Deve ser HTTPS
  • Deve retornar 2xx em até 10 segundos
  • Deve estar acessível publicamente na internet
Em desenvolvimento, use ngrok, localtunnel ou Webhook.site para expor seu servidor local.

​
Retentativas

Se a URL retornar um erro (status não-2xx) ou não responder em 10 segundos, o Vistum tentará reenviar automaticamente com backoff exponencial (via BullMQ): Após 5 falhas consecutivas, o webhook é desativado automaticamente. Corrija o endpoint e reative-o nas configurações. Você também pode reenviar qualquer delivery manualmente em Configurações → Webhooks → Deliveries.

​
Planos e limites

As duas direções têm cotas separadas — consumir uma não afeta a outra:
O plano Essencial não inclui webhooks outbound — faça upgrade para Crescimento ou Sob consulta para recebê-los. Isso não impede integrar plataformas externas: os webhooks de entrada (Hotmart, Kiwify, Eduzz, n8n, formulários) estão disponíveis no Essencial, com cota própria. Veja Planos e Limites.