Skip to main content

Documentation Index

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

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

​
O que é a ação “Enviar Webhook”

A ação Enviar Webhook permite que uma automação do Vistum faça uma requisição HTTP para qualquer URL externa — como um workflow no n8n, Make, Zapier ou seu próprio sistema.

​
Quando usar

  • Quando quiser que o n8n/Make execute algo ao receber uma mensagem específica
  • Quando precisar criar registros em sistemas externos (CRM legacy, ERP, planilha)
  • Quando quiser notificar um servidor próprio sobre eventos do atendimento

​
Configurar a ação

1

Adicione um nó Ação ao fluxo

No editor de automações, clique em + e selecione o nó Ação (laranja).
2

Selecione Enviar Webhook

No campo Tipo de ação, selecione Enviar webhook.
3

Configure a URL

Cole a URL de destino (deve ser HTTPS e acessível publicamente).Exemplos:
  • n8n: https://n8n.seudominio.com/webhook/abc123
  • Make: https://hook.make.com/xyz...
  • Seu servidor: https://api.seusite.com/webhook/vistum
4

Configure o body (opcional)

Você pode personalizar o payload JSON usando variáveis:
{
  "nome": "{{contact.name}}",
  "telefone": "{{contact.phone}}",
  "etapa": "{{pipeline.stage}}"
}
5

Salve e teste

Salve a automação e dispare manualmente para testar (ou use o nó de teste).

​
Variáveis disponíveis no body

VariávelValor
{{contact.name}}Nome do contato
{{contact.phone}}Telefone do contato
{{contact.email}}Email do contato
{{message.type}}Tipo da mensagem que disparou (text, image, audio…)
{{pipeline.stage}}Nome da etapa atual do pipeline

​
Payload automático (sem body customizado)

Se você não preencher o body, o Vistum envia um payload padrão estruturado: 
{
  "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"
  }
}

​
Detalhes técnicos

  • Timeout: 10 segundos
  • Método: POST
  • Content-Type: application/json
  • User-Agent: Vistum-Automations/1.0
  • Tentativas: 1 (sem retry automático na ação de automação)
  • Log: cada execução é registrada no histórico com URL mascarada + HTTP status + tempo de resposta
A URL de destino deve ser HTTPS e acessível pela internet. URLs internas (localhost, IPs privados) são bloqueadas automaticamente por segurança.

​
Diferença: ação de automação vs webhook outbound

Ação webhook na automaçãoWebhook outbound (Configurações)
DisparoQuando a automação executaQuando eventos do CRM acontecem
ConfiguraçãoDentro do fluxo da automaçãoConfigurações → Webhooks
URL customizávelSimSim
Body customizávelSim (com variáveis)Não (payload padrão)
LogHistórico da automaçãoHistórico de deliveries do webhook
Retry automáticoNãoSim (5x exponencial)