ComposioHQ/Automação-Kommo

Automação Kommo

Gerencie seu pipeline de vendas do CRM Kommo — liste e filtre leads, navegue por estágios de pipeline, 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 MCP do Composio à 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 Pipelines e Estágios

Liste todos os pipelines de leads e aprofunde-se em estágios específicos 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 pipelines do Kommo e os estágios do meu pipeline de vendas principal"

Parâmetros principais para Listar Pipelines: Nenhum obrigatório.

Parâmetros principais para Listar Estágios:

• pipeline_id (obrigatório) — O ID do pipeline para listar os estágios
• with_description — Incluir descrições dos estágios na resposta (booleano)

---

2. Listar e Filtrar Leads

Recupere leads com filtros poderosos por pipeline, status, intervalos de datas, usuários responsáveis, preço e mais.

Ferramenta: KOMMO_LIST_LEADS

Exemplo de prompt:

"Mostre todos os leads no pipeline 12345 criados nesta semana, ordenados do mais novo primeiro"

Parâmetros principais:

• query — Pesquisa de texto livre em todos os campos preenchidos
• filter_pipeline_ids — Filtrar por IDs de pipeline (array de inteiros)
• filter_status — Filtrar por status dentro de um pipeline: {"pipeline_id": 123, "status_id": 456}
• filter_responsible_user_ids — Filtrar por IDs de usuários atribuídos
• filter_names — Filtrar por nomes de leads
• filter_price — Filtrar por valor do negócio
• filter_created_at — Intervalo de datas: {"from": <timestamp_unix>, "to": <timestamp_unix>}
• 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 pipeline Kommo com campos personalizados, tags e posicionamento no pipeline.

Ferramenta: KOMMO_CREATE_LEAD

Exemplo de prompt:

"Crie um novo lead chamado 'Negócio Acme Corp' no valor de R$ 50.000 no pipeline 12345"

Parâmetros principais:

• name (obrigatório) — Nome do lead/negócio
• price — Valor do negócio (inteiro)
• pipeline_id — Pipeline para adicionar o lead
• status_id — Estágio dentro do pipeline (padrão: primeiro estágio do pipeline principal)
• responsible_user_id — ID do usuário responsável
• 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 do lead, incluindo nome, preço, estágio do pipeline, usuário responsável, tags e campos personalizados.

Ferramenta: KOMMO_UPDATE_LEAD

Exemplo de prompt:

"Mova o lead 789 para o estágio 456 no pipeline 123 e atualize o preço para R$ 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 ligação de acompanhamento para o lead 789 com vencimento amanhã, atribuída ao usuário 42"

Parâmetros principais:

• Texto/descrição da tarefa
• Tipo de entidade e ID (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 timestamp Unix na estrutura {"from": <timestamp>, "to": <timestamp>}, não strings ISO8601.
• IDs de pipeline e estágio são obrigatórios: Para filtrar leads por status, você precisa tanto de pipeline_id quanto de status_id. Sempre chame KOMMO_LIST_LEADS_PIPELINES e KOMMO_LIST_PIPELINE_STAGES primeiro para descobrir IDs válidos.
• Máximo de 250 leads por página: O parâmetro limit tem limite de 250. Para conjuntos de dados grandes, implemente paginação usando o parâmetro page.
• Formato de valores de campos personalizados: Campos personalizados usam um formato de objeto aninhado específico. Use KOMMO_LIST_CUSTOM_FIELDS para descobrir IDs de campos e formatos de valor esperados antes de definir valores.
• Filtro de status requer ambos os IDs: O parâmetro filter_status requer tanto pipeline_id quanto status_id como um objeto combinado — você não pode filtrar apenas por status.
• Created_by 0 significa robô: Ao definir created_by ou updated_by como 0, a ação é atribuída a um robô/automação, não a um usuário humano.

---

Referência Rápida

Ação	Slug da Ferramenta	Parâmetros Obrigatórios
Listar pipelines	KOMMO_LIST_LEADS_PIPELINES	Nenhum
Listar estágios de pipeline	KOMMO_LIST_PIPELINE_STAGES	pipeline_id
Listar leads	KOMMO_LIST_LEADS	Nenhum (filtros opcionais)
Criar lead	KOMMO_CREATE_LEAD	name
Atualizar lead	KOMMO_UPDATE_LEAD	ID do lead
Criar tarefa	KOMMO_CREATE_TASK	Detalhes da tarefa
Listar campos personalizados	KOMMO_LIST_CUSTOM_FIELDS	Tipo de entidade

---

Desenvolvido por Composio