用途
Pipedrive Automation 用于通过 Rube MCP（Composio）自动化 Pipedrive CRM 的常见操作，包括交易管理、联系人与组织操作、活动安排、备注添加，以及销售管道与阶段的查询。它面向需要以工具调用方式驱动 Pipedrive 工作流的用户。
主要能力
- 创建和管理交易：创建、更新交易，附加产品/行项目，设置金额、币种、管道、阶段、关联组织与联系人、状态和预计成交日期。
- 管理联系人（个人与组织）：搜索、创建、更新、获取详情，以及列出个人和组织。
- 安排和跟踪活动：创建通话、会议、任务等，更新活动或标记完成，获取活动详情，列出指定用户的活动。
- 添加和管理备注：为交易、个人、组织、线索或项目添加 HTML 备注，更新备注，列出备注，获取备注评论。
- 查询管道和阶段：列出管道、获取单个管道详情、列出阶段、获取单个阶段详情、列出管道或阶段中的交易。
使用方式
前置条件：
- Rube MCP 必须已连接（RUBE_SEARCH_TOOLS 可用）。
- 通过 RUBE_MANAGE_CONNECTIONS 激活 Pipedrive 连接，工具包为 pipedrive。
- 始终先调用 RUBE_SEARCH_TOOLS 获取当前工具架构。
设置步骤：
- 在客户端配置中添加 https://rube.app/mcp 作为 MCP 服务器，无需 API 密钥。
- 确认 RUBE_SEARCH_TOOLS 有响应，以验证 Rube MCP 可用。
- 调用 RUBE_MANAGE_CONNECTIONS，工具包为 pipedrive。
- 若连接不是 ACTIVE，按返回的授权链接完成 Pipedrive OAuth。
- 确认连接状态为 ACTIVE 后再运行任何工作流。
核心工作流示例：
- 创建和管理交易：先解析管道 ID 和阶段 ID，再创建交易，可更新交易并附加产品。
- 管理联系人：搜索个人或组织，未找到则创建，可更新或获取详情。
- 安排活动：解析关联实体 ID，创建活动，可更新或标记完成。
- 添加备注：解析实体 ID，创建备注，可更新或列出备注。
- 查询管道和阶段：列出管道和阶段，可获取单个详情或列出其中的交易。
适用场景
- 需要以编程方式批量创建或更新 Pipedrive 交易、联系人和组织。
- 需要为交易、联系人或组织安排活动并跟踪完成状态。
- 需要为 CRM 记录附加备注或查询备注。
- 需要查询销售管道、阶段及其中的交易分布。
限制与注意事项
- 所有实体 ID（交易、个人、组织、活动、管道、阶段）为数字整数；线索 ID 为 UUID 字符串。
- 自定义字段以长哈希键出现，需通过对应 Fields 端点映射。
- 个人上的 email 和 phone 是对象数组，不是纯字符串。
- visible_to 为数字：1 仅所有者，3 整个公司，5 特定分组。
- 活动的 done 为整数 0/1，不是布尔值。
- 创建组织可能自动合并重复项，需检查响应中的 didMerge。
- PIPEDRIVE_SEARCH_PERSONS 至少需要 2 个字符，不支持通配符。
- 删除个人或组织为软删除，保留 30 天后永久删除。
- Pipedrive 有按公司的 API 速率限制，批量操作应控制节奏。
- 列表端点使用基于 offset 的分页，需检查 additional_data.pagination 判断是否还有更多页。
- 响应中自定义字段为哈希键；搜索结果位于 response.data.items。
- 设置交易状态为 lost 时需同时提供 lost_reason。
- 活动类型必须匹配账户中已有的 ActivityTypes key_string。
- 备注内容为 HTML，至少需提供一个实体关联（deal_id、person_id、org_id、lead_id 或 project_id）。
- PIPEDRIVE_GET_ALL_STAGES 默认返回所有管道的阶段，除非指定 pipeline_id。
- 管道摘要中的交易计数仅在设置 totals_convert_currency 时使用 per_stages_converted。