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.

Como funciona

A ação Enviar Webhook em uma automação faz uma chamada HTTP POST para qualquer URL externa quando o fluxo chega naquele nó. É diferente dos webhooks outbound (que disparam por eventos do CRM) — aqui você tem controle total de quando o disparo acontece dentro do fluxo.

Configurar a ação

1

Abra o editor de automações

Acesse Automações → crie ou edite uma automação existente.
2

Adicione um nó Ação

Clique em + no canvas e selecione Ação (nó laranja).
3

Selecione Enviar Webhook

No campo Tipo de ação, escolha Enviar webhook.
4

Configure a URL

Cole a URL de destino (HTTPS obrigatório).
5

Personalize o body (opcional)

Use variáveis para incluir dados do contexto:
{
  "contato": "{{contact.name}}",
  "telefone": "{{contact.phone}}",
  "etapa": "{{pipeline.stage}}"
}

Variáveis disponíveis

VariávelDescrição
{{contact.name}}Nome do contato
{{contact.phone}}Telefone (formato E.164)
{{contact.email}}Email do contato
{{message.type}}Tipo da mensagem que disparou
{{pipeline.stage}}Nome da etapa do pipeline

Payload padrão (sem body customizado)

{
  "event": "automation.webhook",
  "automationId": "auto_xxx",
  "workspaceId": "wks_xxx",
  "timestamp": "2025-05-07T14:30:00.000Z",
  "contact": {
    "id": "cnt_xxx",
    "name": "Nome do Contato",
    "phone": "5511999887766"
  },
  "pipeline": {
    "cardId": "card_xxx",
    "fromStageId": "stage_xxx",
    "toStageId": "stage_yyy"
  }
}

Exemplos práticos

Notificar n8n quando card mudar de etapa

  1. Gatilho: Mudança de etapa no pipeline → etapa Proposta Enviada
  2. Nó Ação: Enviar Webhook → URL do n8n
  3. Body:
    {
      "evento": "proposta_enviada",
      "cliente": "{{contact.name}}",
      "telefone": "{{contact.phone}}"
    }
    

Criar registro no Google Sheets via n8n

  1. Gatilho: Novo contato criado
  2. Nó Ação: Enviar Webhook → URL do workflow n8n de planilha
  3. O n8n recebe os dados e adiciona uma linha na planilha

Alertar o time no Slack quando negócio for ganho

  1. Gatilho: Negócio marcado como ganho
  2. Nó Ação: Enviar Webhook → URL do n8n
  3. O n8n posta mensagem no Slack: 🎉 {{contact.name}} fechou negócio!

Limites e comportamento

  • Timeout: 10 segundos por chamada
  • Sem retry: se a URL falhar, o nó de automação registra o erro mas o fluxo continua
  • Log: cada execução aparece no histórico com URL mascarada, HTTP status e tempo
  • SSRF: URLs de redes privadas são bloqueadas automaticamente (localhost, IPs internos)