Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.vistum.com.br/llms.txt

Use this file to discover all available pages before exploring further.

​
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.

​
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):
TentativaAguarda (aproximado)
1ª (original)—
2ª~5 segundos
3ª~10 segundos
4ª~20 segundos
5ª~40 segundos
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

PlanoWebhooks ativos
Essencial—
Growth5
PRO20