Kommo
14 min
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 https //www kommo com/developers/ https //www kommo com/developers/ 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 campos da conexão campo tipo obrigatório descrição id do cliente string sim client id fornecido ao criar a integração no painel do kommo chave secreta do cliente string sim client secret fornecido ao criar a integração no painel do kommo domínio kommo string sim insira apenas o subdomínio ex se for suaempresa kommo com , digite apenas suaempresa 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 //sandbox 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 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 campo tipo obrigatório descrição id de identificação do lead string sim id de identificação do lead no sistema exemplo 01kqab3xtbmk9z2a31hf1dp6x4 operação consultar dados do contato por id retorna informações detalhadas do cadastro de um contato no crm campos de entrada campo tipo obrigatório descrição id de identificação do contato string sim id gerado ao criar contato, retornado no campo id da resposta da api de criação exemplo 123e4567 e89b 12d3 a456 426614174000 operação consultar dados da empresa por id obtém o cadastro detalhado de uma empresa (companhia) registrada no crm campos de entrada campo tipo obrigatório descrição id de identificação da empresa string sim id gerado ao criar empresa, retornado no campo id da resposta da api de criação exemplo 123e4567 e89b 12d3 a456 426614174000 operação consultar dados do produto consulta dados de um elemento/produto específico alocado dentro de um catálogo campos de entrada campo tipo obrigatório descrição id de identificação do catálogo string sim id correspondente ao catálogo no qual o produto está registrado id de identificação do produto string sim id correspondente ao produto/elemento que será consultado 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 \[gif ou imagem configuração do cenário na fluid buscando lead] 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