⚡

Pipedrive自动化技能Skill pipedrive-automation

该技能通过Rube MCP和Composio工具包自动化Pipedrive CRM操作，包括交易管理、联系人操作、组织管理、活动调度、笔记添加和管道查询。关键词：Pipedrive自动化, CRM自动化, Rube MCP, Composio, 工作流自动化, 交易管理, 联系人管理, 活动管理, 笔记管理, 管道管理, 低代码开发, API集成, 业务自动化。

低代码开发 0 次安装 0 次浏览 更新于 3/8/2026

名称: pipedrive-automation 描述: 通过Rube MCP（Composio）自动化Pipedrive CRM操作，包括交易、联系人、组织、活动、笔记和管道管理。始终首先搜索工具以获取当前模式。 要求: mcp: [rube] 类别: crm

通过Rube MCP实现Pipedrive自动化

通过Composio的Pipedrive工具包自动化Pipedrive CRM工作流程，包括交易管理、联系人和组织操作、活动调度、笔记以及管道/阶段查询。

工具包文档: composio.dev/toolkits/pipedrive

先决条件

  • Rube MCP必须已连接（RUBE_SEARCH_TOOLS可用）
  • 通过RUBE_MANAGE_CONNECTIONS与工具包pipedrive建立活跃的Pipedrive连接
  • 始终首先调用RUBE_SEARCH_TOOLS以获取当前工具模式

设置

获取Rube MCP: 在客户端配置中将https://rube.app/mcp添加为MCP服务器。无需API密钥——只需添加端点即可工作。

  1. 通过确认RUBE_SEARCH_TOOLS响应来验证Rube MCP可用
  2. 使用工具包pipedrive调用RUBE_MANAGE_CONNECTIONS
  3. 如果连接未处于活跃状态，请按照返回的授权链接完成Pipedrive OAuth
  4. 在运行任何工作流程前，确认连接状态显示为活跃

核心工作流程

1. 创建和管理交易

使用时机: 用户希望创建新交易、更新现有交易或查看销售管道中的交易详情。

工具序列:

  1. PIPEDRIVE_SEARCH_ORGANIZATIONS - 查找现有组织以链接到交易 [可选]
  2. PIPEDRIVE_ADD_AN_ORGANIZATION - 如果未找到组织则创建组织 [可选]
  3. PIPEDRIVE_SEARCH_PERSONS - 查找现有联系人以链接 [可选]
  4. PIPEDRIVE_ADD_A_PERSON - 如果未找到联系人则创建联系人 [可选]
  5. PIPEDRIVE_GET_ALL_PIPELINES - 解析管道ID [先决条件]
  6. PIPEDRIVE_GET_ALL_STAGES - 解析管道内的阶段ID [先决条件]
  7. PIPEDRIVE_ADD_A_DEAL - 使用标题、价值、org_id、person_id、stage_id创建交易 [必需]
  8. PIPEDRIVE_UPDATE_A_DEAL - 创建后修改交易属性 [可选]
  9. PIPEDRIVE_ADD_A_PRODUCT_TO_A_DEAL - 附加行项目/产品 [可选]

关键参数:

  • title: 交易标题（创建时必需）
  • value: 交易的货币价值
  • currency: 3字母ISO货币代码（例如"USD"）
  • pipeline_id / stage_id: 管道放置的数字ID
  • org_id / person_id: 链接到组织和联系人
  • status: “open”、“won"或"lost”
  • expected_close_date: 格式YYYY-MM-DD

常见陷阱:

  • title是PIPEDRIVE_ADD_A_DEAL的唯一必需字段；其他都是可选的
  • 自定义字段在响应中显示为长哈希键；使用dealFields端点映射它们
  • PIPEDRIVE_UPDATE_A_DEAL需要交易的数字id
  • 将status设置为"lost"还需要提供lost_reason

2. 管理联系人（个人和组织）

使用时机: 用户希望创建、更新、搜索或列出Pipedrive中的联系人和公司。

工具序列:

  1. PIPEDRIVE_SEARCH_PERSONS - 按姓名、电子邮件或电话搜索现有个人 [先决条件]
  2. PIPEDRIVE_ADD_A_PERSON - 如果未找到则创建新联系人 [必需]
  3. PIPEDRIVE_UPDATE_A_PERSON - 修改现有联系人详情 [可选]
  4. PIPEDRIVE_GET_DETAILS_OF_A_PERSON - 检索完整联系人记录 [可选]
  5. PIPEDRIVE_SEARCH_ORGANIZATIONS - 搜索现有组织 [先决条件]
  6. PIPEDRIVE_ADD_AN_ORGANIZATION - 如果未找到则创建新组织 [必需]
  7. PIPEDRIVE_UPDATE_AN_ORGANIZATION - 修改组织属性 [可选]
  8. PIPEDRIVE_GET_DETAILS_OF_AN_ORGANIZATION - 检索完整组织记录 [可选]

关键参数:

  • name: 个人和组织创建时都必需
  • email: 个人的对象数组，包含value、label、primary字段
  • phone: 个人的对象数组，包含value、label、primary字段
  • org_id: 将个人链接到组织
  • visible_to: 1 = 仅所有者，3 = 整个公司
  • term: 用于SEARCH_PERSONS / SEARCH_ORGANIZATIONS的搜索词（最少2个字符）

常见陷阱:

  • PIPEDRIVE_ADD_AN_ORGANIZATION可能会自动与现有组织合并；检查response.additional_data.didMerge
  • 电子邮件和电话字段是对象数组，而非纯字符串：[{"value": "test@example.com", "label": "work", "primary": true}]
  • PIPEDRIVE_SEARCH_PERSONS不支持通配符如*或@；使用PIPEDRIVE_GET_ALL_PERSONS列出所有
  • 通过PIPEDRIVE_DELETE_A_PERSON或PIPEDRIVE_DELETE_AN_ORGANIZATION删除是软删除，保留30天，然后永久删除

3. 调度和跟踪活动

使用时机: 用户希望创建与交易、联系人或组织链接的呼叫、会议、任务或其他活动。

工具序列:

  1. PIPEDRIVE_SEARCH_PERSONS或PIPEDRIVE_GET_DETAILS_OF_A_DEAL - 解析链接的实体ID [先决条件]
  2. PIPEDRIVE_ADD_AN_ACTIVITY - 使用主题、类型、到期日期创建活动 [必需]
  3. PIPEDRIVE_UPDATE_AN_ACTIVITY - 修改活动详情或标记为完成 [可选]
  4. PIPEDRIVE_GET_DETAILS_OF_AN_ACTIVITY - 检索活动记录 [可选]
  5. PIPEDRIVE_GET_ALL_ACTIVITIES_ASSIGNED_TO_A_PARTICULAR_USER - 列出用户的活动 [可选]

关键参数:

  • subject: 活动标题（必需）
  • type: 活动类型键字符串，例如"call"、“meeting”、“task”、“email”（必需）
  • due_date: 格式YYYY-MM-DD
  • due_time: 格式HH:MM
  • duration: 格式HH:MM（例如"00:30"表示30分钟）
  • deal_id / person_id / org_id: 链接到相关实体
  • done: 0 = 未完成，1 = 完成

常见陷阱:

  • subject和type都是PIPEDRIVE_ADD_AN_ACTIVITY所必需的
  • type必须匹配账户中现有的ActivityTypes key_string
  • done是整数（0或1），而非布尔值
  • 响应在additional_data中包含more_activities_scheduled_in_context

4. 添加和管理笔记

使用时机: 用户希望将笔记附加到交易、个人、组织、线索或项目。

工具序列:

  1. PIPEDRIVE_SEARCH_PERSONS或PIPEDRIVE_GET_DETAILS_OF_A_DEAL - 解析实体ID [先决条件]
  2. PIPEDRIVE_ADD_A_NOTE - 创建链接到实体的HTML内容笔记 [必需]
  3. PIPEDRIVE_UPDATE_A_NOTE - 修改笔记内容 [可选]
  4. PIPEDRIVE_GET_ALL_NOTES - 按实体筛选列出笔记 [可选]
  5. PIPEDRIVE_GET_ALL_COMMENTS_FOR_A_NOTE - 检索笔记的评论 [可选]

关键参数:

  • content: 笔记正文，HTML格式（必需）
  • deal_id / person_id / org_id / lead_id / project_id: 至少需要一个实体链接
  • pinned_to_deal_flag / pinned_to_person_flag: 列出时筛选固定笔记

常见陷阱:

  • content是必需的并支持HTML；纯文本可用但服务器端会清理
  • 必须提供至少一个deal_id、person_id、org_id、lead_id或project_id
  • PIPEDRIVE_GET_ALL_NOTES默认返回所有实体的笔记；使用实体ID参数筛选

5. 查询管道和阶段

使用时机: 用户希望查看销售管道、阶段或管道/阶段内的交易。

工具序列:

  1. PIPEDRIVE_GET_ALL_PIPELINES - 列出所有管道及其ID [必需]
  2. PIPEDRIVE_GET_ONE_PIPELINE - 获取特定管道的详情和交易摘要 [可选]
  3. PIPEDRIVE_GET_ALL_STAGES - 列出所有阶段，可选按管道筛选 [必需]
  4. PIPEDRIVE_GET_ONE_STAGE - 获取特定阶段的详情 [可选]
  5. PIPEDRIVE_GET_DEALS_IN_A_PIPELINE - 列出管道中所有阶段的交易 [可选]
  6. PIPEDRIVE_GET_DEALS_IN_A_STAGE - 列出特定阶段的交易 [可选]

关键参数:

  • id: 管道或阶段ID（单一项端点必需）
  • pipeline_id: 按管道筛选阶段
  • totals_convert_currency: 3字母货币代码或"default_currency"用于转换总计
  • get_summary: 设置为1以在管道响应中获取交易摘要

常见陷阱:

  • PIPEDRIVE_GET_ALL_PIPELINES无参数；返回所有管道
  • PIPEDRIVE_GET_ALL_STAGES返回所有管道的阶段，除非指定pipeline_id
  • 管道摘要中的交易计数仅在设置totals_convert_currency时使用per_stages_converted

常见模式

ID解析

在操作前始终将显示名称解析为数字ID：

  • 组织名称 -> org_id: 使用term参数的PIPEDRIVE_SEARCH_ORGANIZATIONS
  • 个人姓名 -> person_id: 使用term参数的PIPEDRIVE_SEARCH_PERSONS
  • 管道名称 -> pipeline_id: PIPEDRIVE_GET_ALL_PIPELINES然后按名称匹配
  • 阶段名称 -> stage_id: 使用pipeline_id的PIPEDRIVE_GET_ALL_STAGES然后按名称匹配

分页

大多数列表端点使用基于偏移的分页：

  • 使用start（偏移）和limit（页面大小）参数
  • 检查additional_data.pagination.more_items_in_collection以了解是否有更多页面
  • 使用additional_data.pagination.next_start作为下一页的start值
  • 某些端点的默认限制约为500；显式设置以获得可预测的分页

已知陷阱

ID格式

  • 所有实体ID（交易、个人、组织、活动、管道、阶段）都是数字整数
  • 线索ID是UUID字符串，非整数
  • 自定义字段键是长字母数字哈希（例如"a1b2c3d4e5f6…"）

速率限制

  • Pipedrive强制执行每公司API速率限制；批量操作应调整节奏
  • PIPEDRIVE_GET_ALL_PERSONS和PIPEDRIVE_GET_ALL_ORGANIZATIONS可能返回大型数据集；始终分页

参数特性

  • 个人的电子邮件和电话是对象数组，而非纯字符串
  • visible_to是数字：1 = 仅所有者，3 = 整个公司，5 = 特定组
  • 活动上的done是整数0/1，非布尔true/false
  • 组织创建可能静默自动合并重复项；检查响应中的didMerge
  • PIPEDRIVE_SEARCH_PERSONS要求最少2个字符且不支持通配符

响应结构

  • 自定义字段在响应中显示为哈希键；通过相应的Fields端点映射它们
  • 响应通常在包装执行中嵌套在response.data.data下
  • 搜索结果在response.data.items下，非顶层

快速参考

任务 工具Slug 关键参数
创建交易 PIPEDRIVE_ADD_A_DEAL title, value, org_id, stage_id
更新交易 PIPEDRIVE_UPDATE_A_DEAL id, status, value, stage_id
获取交易详情 PIPEDRIVE_GET_DETAILS_OF_A_DEAL id
搜索个人 PIPEDRIVE_SEARCH_PERSONS term, fields
添加个人 PIPEDRIVE_ADD_A_PERSON name, email, phone, org_id
更新个人 PIPEDRIVE_UPDATE_A_PERSON id, name, email
获取个人详情 PIPEDRIVE_GET_DETAILS_OF_A_PERSON id
列出所有个人 PIPEDRIVE_GET_ALL_PERSONS start, limit, filter_id
搜索组织 PIPEDRIVE_SEARCH_ORGANIZATIONS term, fields
添加组织 PIPEDRIVE_ADD_AN_ORGANIZATION name, visible_to
更新组织 PIPEDRIVE_UPDATE_AN_ORGANIZATION id, name, address
获取组织详情 PIPEDRIVE_GET_DETAILS_OF_AN_ORGANIZATION id
添加活动 PIPEDRIVE_ADD_AN_ACTIVITY subject, type, due_date, deal_id
更新活动 PIPEDRIVE_UPDATE_AN_ACTIVITY id, done, due_date
获取活动详情 PIPEDRIVE_GET_DETAILS_OF_AN_ACTIVITY id
列出用户活动 PIPEDRIVE_GET_ALL_ACTIVITIES_ASSIGNED_TO_A_PARTICULAR_USER user_id, start, limit
添加笔记 PIPEDRIVE_ADD_A_NOTE content, deal_id或person_id
列出笔记 PIPEDRIVE_GET_ALL_NOTES deal_id, person_id, start, limit
列出管道 PIPEDRIVE_GET_ALL_PIPELINES （无）
获取管道详情 PIPEDRIVE_GET_ONE_PIPELINE id
列出阶段 PIPEDRIVE_GET_ALL_STAGES pipeline_id
管道中的交易 PIPEDRIVE_GET_DEALS_IN_A_PIPELINE id, stage_id
阶段中的交易 PIPEDRIVE_GET_DEALS_IN_A_STAGE id, start, limit
添加产品到交易 PIPEDRIVE_ADD_A_PRODUCT_TO_A_DEAL id, product_id, item_price

由Composio提供支持