Automações com n8n

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:

1. Vá em Configurações → Integrações → n8n
2. Cole a URL do webhook em Endpoint do n8n
3. Cole o token de autenticação (mesmo valor configurado no nó Webhook do n8n)
4. Selecione os eventos que devem disparar o workflow
5. 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:

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": "maria@exemplo.com"
    },
    "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.

1. Webhook (SiteUp) — recebe kanban.card_moved
2. IF — filtra apenas se data.stage == "Lead Quente"
3. Slack — posta mensagem em #vendas com nome do contato, valor e link da conversa
4. 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