Recurso Kommo: integração com n8n
Kommo e n8n: quando o CRM precisa conversar com outros sistemas
Integração nativa resolve o comum. O n8n resolve o seu caso específico, aquele que nenhum marketplace previu.
Efeito Digital · BrasíliaAtualizado em 23 de outubro de 20263 min de leitura
Em resumo
Integrar o Kommo ao n8n é usar a API e os webhooks do Kommo para trocar dados com sistemas que não têm integração pronta, como ERP, agenda, planilha ou plataforma de pagamento. O n8n recebe o evento, trata a informação e devolve ao CRM. A Efeito Digital, parceira oficial Kommo em Brasília, monta e documenta esses fluxos.
IComo o Kommo se conecta ao n8n
A documentação do Kommo explica que o n8n não tem um conector oficial do Kommo embutido. Na versão em nuvem do n8n, a conexão é feita pelo nó de requisição HTTP, chamando a API do Kommo. Em instalações próprias via Docker, existe também um nó da comunidade chamado n8n-nodes-kommo.
Para autenticar, há dois caminhos descritos pelo Kommo:
- OAuth2Cria-se uma integração no Kommo; o ID da integração e a chave secreta viram as credenciais no n8n.
- Token de longa duraçãoGerado na aba de chaves e escopos da integração no Kommo e usado como autenticação Bearer no n8n.
- PlanoSegundo a documentação, a conexão com o n8n funciona em qualquer plano do Kommo.
O token dá acesso aos dados da conta. Guarde em cofre de credenciais, nunca em planilha ou mensagem.
IIDe onde vêm os eventos: webhooks do Kommo
Para o n8n reagir ao que acontece no CRM, o Kommo envia webhooks. Eles podem nascer em dois lugares:
| Origem | Como funciona | O que chega |
|---|---|---|
| Gatilho no funil | Na automação de uma etapa, o gatilho Enviar webhook dispara quando o card entra ou cumpre a regra. | ID do lead, etapa e funil atuais e anteriores, dados da conta. |
| Configuração da integração | Em Configurações, Integrações, você escolhe a URL e os eventos. | Dados mais completos do lead, com campos alterados e valores antigos e novos. |
IIIEventos disponíveis
Na configuração por integração, o Kommo lista eventos para leads, contatos, empresas, tarefas e clientes: criado, editado, excluído, restaurado, responsável alterado, etapa alterada e nota adicionada, conforme a entidade. Também há eventos de leads de entrada, de mensagens recebidas e de elementos de listas. Pela página de planos, webhooks aparecem a partir do plano Advanced.
IVFluxos que a gente mais monta
- Venda ganha para o financeiroCard em ganho dispara o n8n, que cria o cliente no sistema de cobrança ou emite o pedido.
- Agenda externaConsulta marcada em sistema de clínica atualiza a etapa no Kommo e agenda o lembrete.
- Formulário de site próprioFormulário que não é o webform do Kommo envia dados ao n8n, que cria ou atualiza o lead pela API.
- Distribuição com escalaRegra de rodízio que consulta uma escala de plantão antes de definir o responsável.
- Relatório automáticoToda segunda, o n8n lê o funil e envia um resumo para o gestor.
- Planilha legadaDurante a transição, uma planilha que outra área ainda usa é sincronizada com o CRM.
VArmadilhas comuns
- Loop de atualizaçãoO n8n altera o lead, o Kommo dispara o webhook de edição, que chama o n8n de novo. Use condição para ignorar as próprias alterações.
- Telefone em formato diferenteBusca de contato por telefone falha se um sistema usa formato local e outro internacional. Padronize antes de comparar.
- Fluxo sem donoIntegração que ninguém monitora quebra em silêncio. Toda execução com erro precisa gerar alerta.
- Credencial pessoalIntegração ligada à conta de um funcionário para de funcionar quando ele sai.
VIComo a Efeito constrói
A gente desenha o fluxo antes de abrir o n8n: qual evento dispara, quais dados entram, o que acontece se faltar informação e quem é avisado em caso de erro. A implementação usa credenciais da empresa, não de pessoas, e cada fluxo sai documentado.
O n8n faz parte da caixa de ferramentas da Efeito junto com Kommo, WhatsApp Business API e modelos de IA. É assim que a gente liga, por exemplo, um agente de atendimento ao CRM sem depender de um conector que não existe.
Passo a passo
Como a gente faz, na ordem
- 01Mapear o evento e o destinoO que acontece no Kommo e o que precisa acontecer fora.
- 02Criar a integração no KommoCom credencial da empresa e escopo mínimo.
- 03Configurar o webhookGatilho no funil ou eventos na integração.
- 04Montar o fluxo no n8nTratamento, validação e chamada à API.
- 05Testar com casos reaisInclusive dado faltando e telefone em formato diferente.
- 06Monitorar e documentarAlerta de erro e descrição do fluxo para manutenção.
Perguntas frequentes
O que costumam perguntar
Existe integração oficial entre Kommo e n8n?
Segundo a documentação do Kommo, o n8n não tem um conector oficial do Kommo embutido. A conexão é feita por requisição HTTP à API, ou por um nó da comunidade em instalações próprias.
Preciso saber programar para integrar Kommo e n8n?
Para fluxos simples, não muito. Mas entender API, autenticação e formato de dados evita os erros mais caros, como loops e duplicações.
O que é melhor: n8n ou Zapier com o Kommo?
Os dois chamam a API do Kommo. O n8n pode ser instalado no seu próprio servidor e lida bem com fluxos longos; a escolha depende de volume, custo e de quem vai manter.
O webhook do Kommo funciona em qualquer plano?
A conexão com o n8n via API funciona em qualquer plano, segundo o Kommo. Já os webhooks aparecem na página de planos a partir do Advanced.
A integração com n8n deixa o Kommo mais lento?
Não altera o desempenho da conta. O cuidado é com limites de requisição da API e com fluxos mal desenhados que chamam o CRM sem necessidade.
Continue
Próximo passo
Vamos começar pelo diagnóstico?
Conta pra gente o momento da sua empresa. A gente responde no WhatsApp, marca uma conversa e, se fizer sentido, audita suas contas antes de qualquer proposta.
- Resposta no mesmo dia útil
- Conversa com quem executa, não com um robô de vendas
- Sem compromisso e sem proposta empurrada