Integração com n8n
Construa automações próprias: receba cada mensagem por webhook e responda, pause a IA ou crie leads pela API.
Para quem quer construir automações sob medida — um robô próprio, integrações com outros sistemas, captura de leads de landing page — o ScalaCRM oferece a Integração com n8n: um webhook que avisa sua automação a cada mensagem e uma API para agir de volta. Apesar do nome, funciona com qualquer ferramenta que fale HTTP (n8n, Make, código próprio).
Tudo começa em Configurações → Integrações, no card Integração com n8n: lá você cola a URL do seu webhook e copia o secret — a chave secreta que autentica os dois sentidos da conversa. Dá para regenerar o secret a qualquer momento (as automações antigas param de funcionar até atualizar).
Recebendo eventos (webhook)
Com a integração ativa, você liga o envio de eventos por caixa de entrada (o switch fica na conexão, em Configurações). Cada mensagem recebida do cliente — e cada resposta enviada por um humano — dispara um POST para a sua URL com:
- A mensagem (texto, ou mídia com link temporário para download);
- O contato (nome, telefone);
- A conversa (se a IA está ativa, se a janela de 24h está aberta, qual caixa).
Todo POST vai assinado com o header X-Scala-Signature (HMAC do corpo usando o secret) — sua automação valida a assinatura e descarta qualquer chamada que não veio do ScalaCRM.
💡 Dica: quando um humano responde (pelo ScalaCRM ou pelo celular), o evento chega com a marcação de "humano atendendo" — use isso para o seu robô se calar quando a equipe assume.
Agindo de volta (API)
Todas as chamadas usam o secret como Bearer token no header Authorization:
POST /api/integrations/send— envia mensagem na conversa: texto, mídia (por URL) ou template aprovado. As mensagens enviadas por aqui ganham o selo IA no chat, para a equipe saber que foi automação.POST /api/integrations/conversations/ai— liga ou pausa a IA numa conversa específica. É o mesmo estado do botão IA no chat: sua automação pode se auto-pausar quando o cliente pede um humano.POST /api/integrations/contacts— cria um lead vindo de fora (típico: formulário de landing page). Aceita nome, telefone, e-mail, parâmetros UTM, campos personalizados, uma nota e a opção de já criar o card na entrada do funil. Se o telefone já existe, atualiza em vez de duplicar. Quando enviado com UTM e as conversões offline da Meta estão configuradas, o lead também dispara o evento Lead (padrão Conversion Leads) automaticamente.
Os exemplos de payload completos aparecem no próprio card da integração.
⚠️ Atenção: o secret é uma senha. Nunca o coloque em código público ou frontend de site — as chamadas devem sair sempre do seu servidor/automação. Se suspeitar de vazamento, regenere no card.
n8n ou agente nativo?
O agente de IA nativo do ScalaCRM (menu Agentes IA) resolve atendimento com IA sem você programar nada. A integração com n8n é para quem quer controle total ou integrações que vão além do atendimento. Os dois podem conviver: o modo de IA é escolhido por caixa de entrada.