---
title: Kommo
slug: kommo
docTags: 
createdAt: 2026-05-08T18:07:46.793Z
---

## 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.

:::hint{type="info" indent="2"}
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

1. Acesse Conexões > Nova conexão > Kommo CRM.
2. Preencha os campos de conexão com as credenciais geradas na sua integração privada do Kommo.
3. Clique em Salvar e inicie o fluxo de autorização no modal (OAuth2) que será exibido.
4. Utilize o botão Testar para validar o acesso.

![](https://api.archbee.com/api/optimize/G1NTw6yAi4RDUYbsU8csp/1oxZvX-N0v1n8xVnRB2Xg_image.png)

### 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.

![](https://api.archbee.com/api/optimize/G1NTw6yAi4RDUYbsU8csp/uSaYlRNapRNQo-vvFwwKk_image.png)

**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.