Integração com n8n
Os dois sentidos da conversa entre o ScalaCRM e as suas automações — webhooks de evento para receber, API de integrações para agir.
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 fala nos dois sentidos. Apesar do nome, tudo funciona com qualquer ferramenta que faça HTTP (n8n, Make, código próprio).
Os dois caminhos vivem em Configurações → Integrações, e é útil não confundi-los:
| O que faz | Onde configurar | |
|---|---|---|
| Webhooks de eventos | O CRM avisa você quando algo acontece: lead novo, mudança de etapa, venda concluída | Card Webhooks de eventos |
| API de integrações | Você fala com o CRM: criar lead, lançar venda, enviar mensagem | Card API de integrações |
Cada um tem a sua credencial, e elas são independentes: cada webhook tem um segredo próprio (só assina o que sai), e a chave de API dá acesso de entrada. Girar uma não afeta a outra.
Recebendo eventos
Cadastre um ou mais endereços e marque quais acontecimentos cada um recebe — são 19 eventos, de lead novo a venda concluída. O passo a passo, o formato do payload e como conferir a assinatura estão em Webhooks de eventos.
Se o que você quer é orquestrar um robô de conversa, assine message.received e message.sent: chegam texto, mídia, se a janela de 24h está aberta e se a IA está ativa.
💡 Dica: quando um humano responde (pelo ScalaCRM ou pelo celular), o evento de mensagem enviada indica que não foi automação — use isso para o seu robô se calar quando a equipe assume.
O caminho antigo, para quem já usa
Antes dos webhooks de evento existia um endereço único que recebia cada mensagem das caixas ligadas, com o switch por caixa de entrada. Ele continua funcionando e está no card API de integrações, dentro de "Orquestrar um agente de IA pelo n8n (modo antigo)". Para montar algo novo, prefira os webhooks de evento: mesma informação, com escolha de eventos e histórico de entregas.
Agindo de volta (API)
Todas as chamadas usam a chave de API 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.
Ainda dá para consultar contato por telefone (GET /api/integrations/contacts?phone=), listar funis e etapas (GET /api/integrations/pipelines), listar produtos (GET /api/integrations/products) e lançar venda (POST /api/integrations/sales, idempotente por external_ref). A lista completa aparece no próprio card, com os exemplos de payload.
⚠️ Atenção: a chave de API é uma senha. Nunca a coloque em código público ou frontend de site — as chamadas devem sair sempre do seu servidor/automação. Se suspeitar de vazamento, gere uma nova 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.