Automação Kommo

Gerencie seu funil de vendas do Kommo CRM -- liste e filtre leads, navegue pelas etapas do funil, crie e atualize negócios, atribua tarefas e trabalhe com campos personalizados -- tudo através de comandos em linguagem natural.

Documentação do Toolkit: composio.dev/toolkits/kommo

Configuração

1. Adicione o servidor Composio MCP à configuração do seu cliente:

   https://rube.app/mcp
   

2. Conecte sua conta Kommo quando solicitado (autenticação OAuth).
3. Comece a emitir comandos em linguagem natural para gerenciar seu CRM.

Fluxos de Trabalho Principais

1. Navegar por Funis e Etapas

Liste todos os funis de leads e, em seguida, detalhe etapas específicas do funil para entender a estrutura do seu funil de vendas.

Ferramentas: KOMMO_LIST_LEADS_PIPELINES, KOMMO_LIST_PIPELINE_STAGES

Exemplo de prompt:

"Mostre todos os meus funis Kommo e as etapas no meu funil de vendas principal"

Parâmetros principais para Listar Funis: Nenhum necessário.

Parâmetros principais para Listar Etapas:

• pipeline_id (obrigatório) -- O ID do funil para listar as etapas
• with_description -- Incluir descrições de etapas na resposta (booleano)

2. Listar e Filtrar Leads

Recupere leads com filtragem poderosa por funil, status, intervalos de datas, usuários responsáveis, preço e muito mais.

Ferramenta: KOMMO_LIST_LEADS

Exemplo de prompt:

"Mostre todos os leads no funil 12345 criados esta semana, ordenados pelos mais recentes primeiro"

Parâmetros principais:

• query -- Pesquisa em texto livre em todos os campos preenchidos
• filter_pipeline_ids -- Filtrar por IDs de funil (array de inteiros)
• filter_status -- Filtrar por status dentro de um funil: {"pipeline_id": 123, "status_id": 456}
• filter_responsible_user_ids -- Filtrar por IDs de usuário atribuídos
• filter_names -- Filtrar por nomes de leads
• filter_price -- Filtrar por valor do negócio
• filter_created_at -- Intervalo de datas: {"from": <unix_timestamp>, "to": <unix_timestamp>}
• filter_updated_at -- Intervalo de datas para última atualização
• filter_closed_at -- Intervalo de datas para fechamento
• order_by_created_at -- Ordenar: "asc" ou "desc"
• order_by_updated_at -- Ordenar por data de atualização
• limit -- Máximo de 250 por página
• page -- Número da página para paginação
• with_params -- Dados adicionais: "contacts", "loss_reason", "catalog_elements", "source_id"

3. Criar Novos Leads

Adicione novos negócios ao seu funil Kommo com campos personalizados, tags e posicionamento no funil.

Ferramenta: KOMMO_CREATE_LEAD

Exemplo de prompt:

"Crie um novo lead chamado 'Acme Corp Deal' no valor de $50.000 no funil 12345"

Parâmetros principais:

• name (obrigatório) -- Nome do lead/negócio
• price -- Valor do negócio (inteiro)
• pipeline_id -- Funil para adicionar o lead
• status_id -- Etapa dentro do funil (padrão para a primeira etapa do funil principal)
• responsible_user_id -- ID do usuário atribuído
• custom_fields_values -- Array de objetos de valor de campo personalizado
• tags_to_add -- Array de tags (por nome ou ID)
• created_by -- ID do usuário criador (0 para robô)
• loss_reason_id -- Motivo da perda (se aplicável)

4. Atualizar Leads Existentes

Modifique propriedades de leads, incluindo nome, preço, etapa do funil, usuário responsável, tags e campos personalizados.

Ferramenta: KOMMO_UPDATE_LEAD

Exemplo de prompt:

"Mova o lead 789 para a etapa 456 no funil 123 e atualize o preço para $75.000"

Parâmetros principais:

• ID do Lead (obrigatório)
• Qualquer combinação de: name, price, pipeline_id, status_id, responsible_user_id, tags_to_add, tags_to_delete, custom_fields_values

5. Criar Tarefas

Atribua tarefas de acompanhamento vinculadas a leads, contatos ou empresas.

Ferramenta: KOMMO_CREATE_TASK

Exemplo de prompt:

"Crie uma tarefa de chamada de acompanhamento para o lead 789 com vencimento amanhã, atribuída ao usuário 42"

Parâmetros principais:

• Texto/descrição da tarefa
• Tipo e ID da entidade (lead, contato, empresa)
• ID do usuário responsável
• Data de vencimento (timestamp Unix)
• Tipo de tarefa

6. Descobrir Campos Personalizados

Liste todos os campos personalizados para leads, contatos ou empresas para entender o esquema do seu CRM.

Ferramenta: KOMMO_LIST_CUSTOM_FIELDS

Exemplo de prompt:

"Quais campos personalizados estão disponíveis para leads no Kommo?"

Parâmetros principais:

• Tipo de entidade (leads, contatos, empresas)

Armadilhas Conhecidas

• Filtros de data usam timestamps Unix: Todos os filtros de intervalo de datas (filter_created_at, filter_updated_at, filter_closed_at) exigem o formato de timestamp Unix na estrutura {"from": <timestamp>, "to": <timestamp>}, não strings ISO8601.

…