Integração Kommo: o que sincroniza e como configurar

A integração com o Kommo conecta a captação de leads ao North Clinic CRM e permite refletir no Kommo determinadas movimentações realizadas no funil do CRM.

Resumo: o que entra, o que sai e o que fica de fora

Fluxo	Direção	O que acontece
Leads novos	Kommo → North Clinic CRM	Um lead captado no Kommo pode ser criado ou vinculado no CRM, desde que tenha telefone e o webhook esteja configurado.
Importação de uma base existente	Kommo → North Clinic CRM	A clínica escolhe uma pipeline, revisa os campos e seleciona os leads antes de importar.
Movimentação no funil	North Clinic CRM → Kommo	Quando um lead vinculado muda para uma etapa mapeada no funil principal do CRM, ele pode ser movido para a coluna correspondente no Kommo. A confirmação de uma venda também executa o marco Comprou.
Reabertura de agendamento	North Clinic CRM → Kommo	É um evento separado e opcional. Pode mover o lead para uma coluna própria ou não sincronizar nada. Nunca reutiliza automaticamente a coluna de novo agendamento.
Data do agendamento	North Clinic CRM → Kommo	Pode ser enviada para um campo de data do Kommo escolhido durante a configuração.
Chat e mensagens	Não sincroniza	O histórico do chat, as mensagens recebidas e as mensagens automáticas não são copiadas entre os sistemas.

A integração não cria no Kommo um lead que existe apenas no North Clinic CRM. Para a movimentação de saída funcionar, o lead precisa ter vindo do Kommo, ter sido importado ou ser localizado lá pelo mesmo telefone.

Como acessar

No CRM, acesse Configurações → Integrações → Integração Kommo.

A tela exige o módulo Integração Kommo ativo. Esse módulo é uma contratação separada e pode não estar incluído no plano atual da clínica. Sem ele, a tela apresenta uma orientação para falar com o suporte.

Consultar a configuração é diferente de alterá-la. Conectar ou desconectar a conta, importar leads, ativar ou pausar a sincronização e salvar mapeamentos exige a permissão de gerenciamento das configurações da clínica.

Antes de começar, confirme que você tem:

• O módulo Integração Kommo ativo para a unidade.
• A permissão de gerenciamento das configurações da clínica.
• Acesso administrativo à conta Kommo que será conectada.
• O subdomínio da conta Kommo.
• Um token de longa duração válido.
• Permissão no Kommo para consultar leads, contatos, pipelines e campos e para atualizar os leads vinculados.

Não é necessário informar uma chave diferente para cada lead ou serviço.

Etapas iniciais

O indicador de configuração mostra o que ainda falta para colocar a integração em funcionamento. As abas Importar e Sincronizar etapas ficam indisponíveis até que a conta esteja conectada.

Conexão

Para conectar, informe:

• O subdomínio da conta Kommo.
• Um token de longa duração gerado no Kommo.

A própria tela apresenta instruções e os endereços de webhook e redirecionamento que podem ser necessários na configuração da integração no Kommo.

Depois da conexão, é possível:

• Testar a comunicação com a conta.
• Ver avisos de bloqueio ou falha de conexão.
• Consultar diagnósticos e a atividade recente de entrada e saída.
• Ativar ou pausar a sincronização.
• Desconectar a conta.

Se o sistema detectar uma configuração compatível no sistema anterior, poderá oferecer a importação dessa configuração. A tela também informa quando a mesma conta Kommo está compartilhada entre clínicas.

Segurança: trate o token como uma senha. Não envie por mensagens, não o coloque em documentos públicos e gere outro token se houver suspeita de exposição.

O chat e as mensagens entram na integração?

Não. A integração usa eventos do Kommo para identificar leads e sincroniza dados de cadastro, vínculo, etapa e, quando configurada, a data do agendamento. Ela não copia conversas nem assume a entrega de mensagens automáticas do Kommo.

Na prática:

• A conversa continua no canal em que foi atendida.
• Mensagens automáticas configuradas no Kommo continuam sendo enviadas e monitoradas pelo Kommo e pelo provedor conectado a ele.
• Mensagens automáticas configuradas no North Clinic CRM continuam sendo enviadas e monitoradas pelo próprio CRM.
• Uma mensagem recebida no Kommo pode originar um lead que entra no North, mas o conteúdo da mensagem não acompanha esse cadastro.

Se algumas mensagens automáticas chegam e outras não, primeiro identifique em qual sistema a automação foi configurada. Esse diagnóstico é diferente de verificar se um lead novo entrou no CRM.

Recebimento de novos leads

O webhook configurado no Kommo permite que novos leads captados por canais conectados ao Kommo sejam recebidos pelo CRM. A tela mostra o endereço que deve ser cadastrado e indica se houve atividade recente.

Esse recebimento não significa que todas as alterações de etapas feitas no Kommo serão copiadas automaticamente para o CRM.

O cadastro do webhook é uma etapa manual feita dentro do Kommo. Na tela da integração, use Testar integração e consulte a atividade recente para verificar se o North está recebendo eventos. Um teste de conexão bem-sucedido confirma as credenciais, mas não confirma sozinho que o webhook foi cadastrado.

Importação de leads existentes

O assistente de importação trabalha com os leads de uma pipeline selecionada no Kommo. O processo permite:

1. Escolher a pipeline de origem.
2. Relacionar os status do Kommo às etapas do funil no CRM.
3. Relacionar campos personalizados ou transformá-los em tags, quando disponível.
4. Revisar uma prévia dos leads novos e dos já existentes.
5. Desmarcar registros que não devem ser importados.
6. Acompanhar o processamento e consultar o resumo final.

A identificação de registros existentes considera principalmente o telefone. Leads previamente excluídos podem aparecer para restauração. Revise cuidadosamente a prévia antes de iniciar uma importação grande.

Dependendo da configuração encontrada, o assistente também pode oferecer a criação de um funil no CRM baseado na pipeline selecionada.

Sincronização de etapas para o Kommo

Os mapeamentos também aparecem em Configuração do funil → Ações, como ações do Kommo vinculadas a cada etapa. É a mesma configuração: alterar o destino nas ações do funil atualiza a integração, sem criar uma regra duplicada.

Na aba de sincronização, selecione a pipeline de destino e configure separadamente:

1. As etapas do funil principal do CRM.
2. Os eventos da agenda, como Reabriu agendamento.
3. O campo opcional que recebe a data da avaliação.

Depois de salvar e com a sincronização ativa, cada mudança usa somente a correspondência do seu próprio tipo. Um evento da agenda não herda automaticamente a coluna de uma etapa do funil.

Essa movimentação ocorre no sentido North Clinic CRM → Kommo. Etapas sem correspondência podem ficar sem sincronização. A tela também sinaliza status do Kommo que não receberam nenhum mapeamento.

Qualificação manual e Incoming Leads

Se a equipe qualifica os leads manualmente no Kommo, deixe a etapa inicial Novo Lead sem correspondência ou relacione-a somente a Incoming Leads. Mapear Novo Lead para uma coluna posterior, como Qualificação, faz o North mover o lead assim que ele entrar nessa etapa e pode pular a conferência manual dos dados.

Mapeie apenas as etapas que realmente devem movimentar o lead, como Agendado, Compareceu, Faltou, Cancelou ou Comprou. Depois de salvar, crie um lead de teste e confirme o resultado nas duas unidades quando a conta Kommo for compartilhada.

O que acontece na etapa Comprou

Comprou funciona como um marco automático da venda, mesmo que o lead não permaneça nessa coluna. Ao confirmar uma venda, o North converte o cadastro e o mantém em Clientes → Novo Cliente, executa ou agenda as ações configuradas em Comprou e, quando a integração estiver ativa, envia o lead ao destino do Kommo configurado nessa ação.

Nas ações do funil, a conversão e a movimentação para Novo Cliente aparecem como uma ação fixa do sistema. Ela não pode ser pausada ou excluída. Mensagens e outras ações configuradas em Comprou continuam vinculadas ao evento da venda, mesmo depois que o cadastro aparece no funil de Clientes.

Se as pipelines ou etapas forem alteradas no Kommo, atualize a lista e revise o mapeamento.

Reabertura de agendamento

Reabrir é quando um atendimento marcado como Finalizado ou Faltou volta para Agendado. Essa ação corrige o mesmo agendamento; ela não representa a criação de outro.

Por isso, Reabriu agendamento possui uma configuração própria:

• Não sincronizar: opção padrão. O status volta para Agendado no North, mas o lead não muda de coluna no Kommo.
• Escolher uma coluna: o lead é movido somente para a coluna selecionada para a reabertura.

A reabertura nunca usa como alternativa a coluna mapeada para a etapa Agendado. Isso evita que uma automação de “novo agendamento” seja executada novamente sem intenção.

Atenção: o North apenas movimenta o lead. Se a coluna escolhida para Reabriu agendamento possuir uma automação no Kommo, essa automação poderá enviar mensagens sempre que o agendamento for reaberto. Escolha uma coluna exclusiva ou deixe Não sincronizar quando esse reenvio não for desejado.

O evento de reabertura também não altera o campo de data do agendamento. Mudanças reais de dia ou horário continuam usando o fluxo próprio de atualização da data.

Como escolher quais serviços movimentam dados

A configuração do Kommo não possui um seletor de serviços ou procedimentos. A movimentação é definida pelas etapas do funil principal de vendas:

1. Escolha a pipeline de destino no Kommo.
2. Relacione cada etapa principal do CRM à coluna correspondente no Kommo.
3. Deixe sem correspondência as etapas que não devem movimentar o lead no Kommo.

Por isso, não é possível selecionar diretamente “somente avaliação” ou excluir procedimentos pelo nome do serviço. Se a avaliação e os procedimentos levam o lead a etapas diferentes no CRM, mapeie apenas a etapa que deve ser refletida. Se ambos usam a mesma etapa, a integração não consegue distingui-los pelo serviço; será necessário ajustar primeiro a regra do funil com o suporte.

Como funciona com mais de uma unidade

Cada unidade possui sua própria configuração, permissão, ativação e mapa de etapas.

É possível conectar duas ou mais unidades do North Clinic CRM à mesma conta Kommo. Nesse cenário:

• O North identifica que o subdomínio é compartilhado.
• Um lead novo recebido dessa conta é processado para todas as unidades conectadas e ativas.
• Cada unidade mantém o seu próprio registro do lead e o seu próprio mapa de etapas.
• Uma movimentação feita por uma unidade pode alterar o mesmo lead na pipeline compartilhada do Kommo.

Fuso horário em contas compartilhadas

Configure o fuso correto em Configurações → Dados da empresa de cada unidade. O horário da agenda é sempre o horário local da clínica.

Como a conta Kommo possui um único fuso global, o North consulta essa configuração ao enviar a data e a hora do agendamento e ajusta o timestamp para preservar o horário informado. Assim, um agendamento marcado para 09:00 em Tangará da Serra deve aparecer como 09:00 no Kommo, mesmo quando a mesma conta também é usada por uma unidade no horário de Brasília.

Não compense a diferença alterando manualmente o agendamento para 08:00 ou 10:00. Se o horário chegar deslocado, confira o fuso cadastrado nas duas unidades, o fuso global da conta Kommo e registre um teste em Entregas da integração para o suporte analisar.

Esse compartilhamento é indicado quando as unidades realmente trabalham a mesma base e o mesmo funil. Se cada unidade deve receber apenas os seus próprios leads, use contas ou pipelines separadas e valide o desenho com o suporte antes de ativar. Uma única unidade do North mantém uma conexão Kommo por vez.

O que continua manual depois de integrar

A conexão não configura toda a operação automaticamente. Ainda é necessário:

• Cadastrar e manter o webhook na conta Kommo.
• Ativar a sincronização no North Clinic CRM.
• Escolher a pipeline e revisar o mapeamento das etapas.
• Decidir se o evento Reabriu agendamento deve mover o lead para uma coluna própria ou ficar como Não sincronizar.
• Escolher, se desejado, o campo do Kommo que receberá a data do agendamento.
• Revisar e confirmar a importação inicial de leads.
• Revisar o mapeamento quando pipelines, colunas ou campos mudarem no Kommo.
• Configurar separadamente mensagens, automações e chat no sistema responsável por enviá-los.
• Repetir e validar a configuração por unidade quando houver mais de uma clínica.

Como saber se está funcionando

Na aba Conexão, use estes sinais em conjunto:

• Testar conexão: valida o acesso à conta e às credenciais.
• Status do webhook: informa se o North já recebeu eventos daquela conta.
• Testar integração: verifica módulo, entrada de leads, mapeamentos, campo de data e leads vinculados.
• Entregas da integração: mostra pendências, novas tentativas, sucessos e falhas. Usuários com permissão de gerenciamento podem reprocessar uma falha.
• Atividade recente: mostra leads recebidos e movimentações concluídas.

As movimentações de saída são enfileiradas e podem levar cerca de um minuto para aparecer no Kommo. Em indisponibilidade temporária ou limite de requisições, o sistema tenta novamente com espera progressiva.

Se o lead não entrou, confira se ele tem telefone, se o webhook está cadastrado, se o módulo e a sincronização estão ativos e se a conta não está bloqueada. Se o lead entrou, mas não mudou de coluna no Kommo, confira se ele está vinculado, se a etapa ou o evento possui correspondência e se a pipeline ou o campo configurado ainda existem. Na reabertura, Não sincronizar significa que nenhuma entrega ao Kommo será criada — esse é o comportamento esperado.

Ao falar com o suporte, informe a unidade, o subdomínio Kommo, o nome do lead, o horário aproximado do evento e se a falha foi na entrada do lead, na movimentação de etapa ou na entrega de uma mensagem. Não envie o token.