Kommo
Objetivo
O conector Kommo CRM permite a integração da plataforma Fluid com sua conta Kommo para consultar e gerenciar entidades do CRM, como leads, contatos, empresas e produtos (catálogos).
Principais cenários de uso:
- Sincronização de dados de clientes entre o ERP corporativo e o CRM.
- Consulta em tempo real de informações de vendas e negociações (leads).
- Extração de dados de catálogo de produtos vinculados a uma venda específica.
Para mais informações, acesse o portal de desenvolvedores do conector:
Configuração da conexão
Como configurar no painel da Fluid
- Acesse Conexões > Nova conexão > Kommo CRM.
- Preencha os campos de conexão com as credenciais geradas na sua integração privada do Kommo.
- Clique em Salvar e inicie o fluxo de autorização no modal (OAuth2) que será exibido.
- Utilize o botão Testar para validar o acesso.
Métodos de autenticação
OAuth 2.0
A integração utiliza o protocolo OAuth2. Ao salvar a conexão, a Fluid iniciará o fluxo de autorização direcionando para a base https://[dominio].kommo.com/api/v4. O gerenciamento e a renovação do access_token ocorrem automaticamente pela plataforma Fluid.
Observações de segurança
- A Redirect URI registrada no aplicativo dentro da Kommo deve ser exatamente a utilizada pela Fluid (ex: https://console.fluidapi.io).
- Trate o Client Secret como uma senha corporativa; nunca o exponha em logs ou painéis não autenticados.
Requisitos
- Possuir uma conta ativa e administrativamente acessível no Kommo CRM.
- Criar uma integração do tipo "Web integration" (ou similar) no painel da Kommo para gerar as chaves do aplicativo (Client ID e Secret Key).
Configurando um fluxo
Recurso Leads
Operação: Busca lista de leads
Retorna a lista de leads vinculados à sua conta
Campos de entrada
Não é necessário nenhum campo de entrada, apenas selecione o recurso e operação necessária.
Operação: Busca vinculos do lead/venda
Retorna dados do lead (venda), incluindo contato associado, empresa e os produtos vinculados à negociação.
Campos de entrada
Recurso Contatos
Operação: Consultar dados do contato por ID
Retorna informações detalhadas do cadastro de um contato no CRM.
Campos de entrada
Recurso Empresas
Operação: Consultar dados da empresa por ID
Obtém o cadastro detalhado de uma empresa (companhia) registrada no CRM.
Campos de entrada
Recurso Produtos
Operação: Consultar dados do produto
Consulta dados de um elemento/produto específico alocado dentro de um catálogo.
Campos de entrada
Na prática
Enriquecimento de webhook com dados da venda
Contexto: Quando a Fluid recebe um webhook indicando mudança de estágio do lead no Kommo, você pode utilizar a operação "Busca vinculos do lead/venda" para resgatar todos os produtos e a empresa envolvidos na negociação e despachá-los para o ERP.
Boas práticas e armadilhas comuns:
- O payload de retorno no Kommo costuma trazer entidades relacionadas apenas com o ID base. Utilize as operações de consulta individual de contato ou empresa em seguida se precisar dos dados completos daquela entidade.
- Evite inserir https:// ou o sufixo .kommo.com no campo "Domínio Kommo" da conexão. Isso irá inviabilizar o mapeamento de rota da operação.
Observações adicionais
- Limites e Paginação: Respeite as políticas oficiais de limite de requisições do Kommo CRM. Exceder este limite retornará falhas HTTP 429 nas suas execuções da Fluid.
- Header dinâmico: Todas as requisições geradas pelo conector injetam nativamente os headers corporativos partner-software-name e partner-software-version.
Conclusão
O conector Kommo CRM viabiliza a construção de processos inteligentes de vendas integrando perfeitamente a leitura de clientes e negócios ao seu ecossistema. Combinado a componentes lógicos e de notificação da Fluid, ele reduz a carga de trabalho operacional dos times comerciais e de faturamento.