O n8n é uma plataforma open-source de automação de workflows. O SiteUp possui integração nativa que permite disparar fluxos no n8n sempre que um evento acontece. Sem precisar mexer em webhook genérico, autenticação manual ou parsing de payload. Esta página explica como conectar os dois lados e mostra exemplos reais de fluxo.

Pré-requisitos

Uma instância n8n acessível via HTTPS (n8n Cloud, self-hosted ou serviço gerenciado)
Permissão de Administrador no SiteUp para criar integrações
URL pública do webhook receiver no n8n

Passo 1, Criar o webhook receiver no n8n

No editor do n8n, crie um novo workflow e arraste o nó Webhook como ponto de entrada. Configure assim:

HTTP Method: POST
Path: algo identificável, ex.: siteup-eventos
Authentication: Header Auth (recomendado): defina um header customizado, ex.: X-SiteUp-Token: seu-segredo-aqui
Response Mode: When Last Node Finishes (ou Immediately, se preferir resposta rápida)

Ative o workflow e copie a Production URL gerada pelo nó Webhook. Vai ser algo como https://n8n.suaempresa.com/webhook/siteup-eventos.

Passo 2, Plugar a URL no SiteUp

No painel do SiteUp:

Vá em Configurações → Integrações → n8n
Cole a URL do webhook em Endpoint do n8n
Cole o token de autenticação (mesmo valor configurado no nó Webhook do n8n)
Selecione os eventos que devem disparar o workflow
Clique em Testar conexão, o SiteUp envia um payload de teste e mostra o status da resposta

Eventos suportados

Os eventos disponíveis cobrem todo o ciclo de atendimento e funil:

Evento	Quando dispara
`conversation.created`	Nova conversa entra na caixa de entrada
`conversation.assigned`	Conversa atribuída a um atendente
`conversation.resolved`	Conversa resolvida
`message.received`	Mensagem recebida do contato
`message.sent`	Mensagem enviada pelo atendente
`kanban.card_created`	Card criado em qualquer coluna
`kanban.card_moved`	Card muda de coluna
`kanban.card_won`	Card movido pra coluna de ganho
`kanban.card_lost`	Card movido pra coluna de perda
`contact.created`	Novo contato cadastrado
`contact.tagged`	Tag aplicada ao contato

Cada evento envia um payload JSON com a entidade completa e metadados (account_id, event, timestamp).

Exemplo de payload

{
  "event": "kanban.card_won",
  "timestamp": "2026-04-28T14:32:11Z",
  "account_id": 142,
  "data": {
    "card_id": 9821,
    "title": "Plano Premium - Maria Silva",
    "value": 2400.00,
    "stage": "Fechado-Ganho",
    "contact": {
      "id": 8123,
      "name": "Maria Silva",
      "phone": "+5511999998888",
      "email": "[email protected]"
    },
    "assignee": {
      "id": 12,
      "name": "Carlos Atendente"
    }
  }
}

Exemplo de fluxo: lead quente vira notificação no Slack

Cenário comum: quando um card chega na coluna "Lead Quente" do Kanban, notificar o time comercial no Slack imediatamente.

Webhook (SiteUp), recebe kanban.card_moved
IF, filtra apenas se data.stage == "Lead Quente"
Slack: posta mensagem em #vendas com nome do contato, valor e link da conversa
HTTP Request (opcional), chama API REST do SiteUp pra atribuir o card automaticamente ao SDR de plantão

Em poucos minutos você tem um fluxo que costumava exigir um cargo dedicado pra monitorar o Kanban.

Outros casos de uso

Pós-venda automatizado: ao kanban.card_won, criar tarefa no ClickUp e enviar e-mail de boas-vindas
Recuperação de carrinho: ao kanban.card_lost com motivo "preço", agendar follow-up de 7 dias
Enriquecimento de lead: ao contact.created, consultar Apollo/Clearbit e atualizar custom_attributes via API REST
Sincronia com ERP: ao kanban.card_won, criar pedido no Bling/Tiny

Boas práticas

Sempre valide o token no nó Webhook, sem isso, qualquer pessoa que descobrir a URL pode disparar seu workflow
Use IF logo após o Webhook pra filtrar eventos irrelevantes e economizar execuções
Configure timeout generoso (15s+): se o n8n demorar pra responder, o SiteUp tenta reentregar
Logue erros num canal dedicado, não deixe falha silenciosa quebrar a automação

Próximos passos

Webhooks customizados, alternativa quando você não usa n8n
API REST: autenticação, pra fechar o loop e escrever de volta no SiteUp