name: Kommo自动化 description: “通过Composio MCP集成，使用自然语言自动化Kommo CRM操作——管理潜在客户、销售管道、管道阶段、任务和自定义字段。” category: crm requires: mcp: - rube

Kommo自动化

管理您的Kommo CRM销售管道——列出和筛选潜在客户，导航管道阶段，创建和更新交易，分配任务，以及处理自定义字段——全部通过自然语言命令完成。

工具包文档： composio.dev/toolkits/kommo

设置

将Composio MCP服务器添加到您的客户端配置中：
```
https://rube.app/mcp
```
当提示时连接您的Kommo账户（OAuth认证）。
开始发出自然语言命令来管理您的CRM。

核心工作流

1. 导航管道和阶段

列出所有潜在客户管道，然后深入特定管道阶段以了解您的销售漏斗结构。

工具： KOMMO_LIST_LEADS_PIPELINES, KOMMO_LIST_PIPELINE_STAGES

示例提示：

“显示我所有的Kommo管道以及我的主要销售管道中的阶段”

列出管道的关键参数： 无需参数。

列出阶段的关键参数：

pipeline_id（必需）——要列出阶段的管道ID
with_description——在响应中包含阶段描述（布尔值）

2. 列出和筛选潜在客户

通过管道、状态、日期范围、负责用户、价格等强大筛选功能检索潜在客户。

工具： KOMMO_LIST_LEADS

示例提示：

“显示管道12345中本周创建的所有潜在客户，按最新优先排序”

关键参数：

query——在所有填充字段上进行自由文本搜索
filter_pipeline_ids——按管道ID筛选（整数数组）
filter_status——按管道内的状态筛选：{"pipeline_id": 123, "status_id": 456}
filter_responsible_user_ids——按分配的用户ID筛选
filter_names——按潜在客户名称筛选
filter_price——按交易价值筛选
filter_created_at——日期范围：{"from": <unix_timestamp>, "to": <unix_timestamp>}
filter_updated_at——最后更新的日期范围
filter_closed_at——关闭的日期范围
order_by_created_at——排序：“asc"或"desc”
order_by_updated_at——按更新日期排序
limit——每页最多250条
page——分页的页码
with_params——额外数据：“contacts”、“loss_reason”、“catalog_elements”、“source_id”

3. 创建新潜在客户

通过自定义字段、标签和管道位置将新交易添加到您的Kommo管道中。

工具： KOMMO_CREATE_LEAD

示例提示：

“在管道12345中创建一个名为’Acme Corp交易’、价值50,000美元的新潜在客户”

关键参数：

name（必需）——潜在客户/交易的名称
price——交易价值（整数）
pipeline_id——将潜在客户添加到的管道
status_id——管道内的阶段（默认为主要管道的第一个阶段）
responsible_user_id——分配的用户ID
custom_fields_values——自定义字段值对象数组
tags_to_add——标签数组（按名称或ID）
created_by——创建者的用户ID（0表示机器人）
loss_reason_id——损失原因（如适用）

4. 更新现有潜在客户

修改潜在客户属性，包括名称、价格、管道阶段、负责用户、标签和自定义字段。

工具： KOMMO_UPDATE_LEAD

示例提示：

“将潜在客户789移动到管道123中的阶段456，并将价格更新为75,000美元”

关键参数：

潜在客户ID（必需）
任意组合：name、price、pipeline_id、status_id、responsible_user_id、tags_to_add、tags_to_delete、custom_fields_values

5. 创建任务

分配与潜在客户、联系人或公司相关的跟进任务。

工具： KOMMO_CREATE_TASK

示例提示：

“为潜在客户789创建一项跟进通话任务，明天到期，分配给用户42”

关键参数：

任务文本/描述
实体类型和ID（潜在客户、联系人、公司）
负责用户ID
到期日期（Unix时间戳）
任务类型

6. 发现自定义字段

列出潜在客户、联系人或公司的所有自定义字段，以了解您的CRM架构。

工具： KOMMO_LIST_CUSTOM_FIELDS

示例提示：

“Kommo中潜在客户有哪些可用的自定义字段？”

关键参数：

实体类型（潜在客户、联系人、公司）

已知问题

日期筛选器使用Unix时间戳：所有日期范围筛选器（filter_created_at、filter_updated_at、filter_closed_at）都需要Unix时间戳格式，使用{"from": <timestamp>, "to": <timestamp>}结构，而不是ISO8601字符串。
管道和阶段ID是必需的：要按状态筛选潜在客户，您需要pipeline_id和status_id。始终先调用KOMMO_LIST_LEADS_PIPELINES和KOMMO_LIST_PIPELINE_STAGES以发现有效ID。
每页最多250条潜在客户：limit参数上限为250。对于大型数据集，使用page参数实现分页。
自定义字段值格式：自定义字段使用特定的嵌套对象格式。在设置值之前，使用KOMMO_LIST_CUSTOM_FIELDS发现字段ID和预期值格式。
状态筛选需要两个ID：filter_status参数需要pipeline_id和status_id作为组合对象——您不能仅按状态筛选。
创建者0表示机器人：当将created_by或updated_by设置为0时，操作归属于机器人/自动化，而不是人类用户。

快速参考

操作	工具Slug	必需参数
列出管道	`KOMMO_LIST_LEADS_PIPELINES`	无
列出管道阶段	`KOMMO_LIST_PIPELINE_STAGES`	`pipeline_id`
列出潜在客户	`KOMMO_LIST_LEADS`	无（可选筛选器）
创建潜在客户	`KOMMO_CREATE_LEAD`	`name`
更新潜在客户	`KOMMO_UPDATE_LEAD`	潜在客户ID
创建任务	`KOMMO_CREATE_TASK`	任务详情
列出自定义字段	`KOMMO_LIST_CUSTOM_FIELDS`	实体类型

由Composio提供支持