Kommo
13 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 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