Pipedrive

工作区可以使用 Warmbly 自带的 CRM、HubSpot或 Pipedrive。在 Pipedrive 模式中，Pipedrive 是权威数据源。你在 Warmbly 中看到的商机、销售管道、任务和备注，分别对应 Pipedrive 的商机、管道、活动和备注，镜像到 Warmbly 以确保列表、搜索和看板响应迅速；在 Warmbly 中执行的每次修改都会先写入 Pipedrive。客户触达记录为每位人员的活动；创建商机或将人员标记为客户时，Pipedrive 可以停止营销活动。

基础 Pipedrive 连接无需启用 Pipedrive 模式即可使用，包括从自动化流程创建或更新人员，以及推送到 CRM。本页介绍完整模式。

• 商机、销售管道、活动和备注都属于 Pipedrive。 在 Warmbly 中创建、移动或编辑商机时，会先写入 Pipedrive，再保存到这里。Warmbly 任务对应 Pipedrive 活动。如果 Pipedrive 拒绝变更，例如缺少权限或记录已删除，界面会显示 Pipedrive 给出的原因，且不保存任何修改。
• 客户触达记录到人员上。 发送和回复记录为已完成的 Email（邮件） 活动，带有主题和正文；退信会标记已记录的邮件；退订会添加备注；已预约会议则成为 Meeting（会议） 活动。
• Pipedrive 人员上的 Warmbly 字段保存每个人的触达状态，供团队据此筛选、生成报表和运行 Pipedrive 自动化流程。
• Pipedrive 可以停止触达。 在 Pipedrive 中创建商机、添加指定标签，例如 Customer（客户），或退订，都会暂停该人员的营销活动。
• 联系人面板展示 Pipedrive 信息。 在联系人抽屉和收件箱中，可查看 Pipedrive 负责人、标签、组织及所选字段，并可直接修改负责人和标签。

1. 打开集成 > Pipedrive并选择连接。登录 Pipedrive，选择公司并批准权限。
2. 设置向导打开后，选择 切换到 Pipedrive 。Warmbly 会读取标签，并据此填充规则：感兴趣的回复将人员标记为 Hot lead（高意向潜客） ，带有 Customer（客户） 标签的人绝不会收到营销活动邮件。其他问题也都有可用的默认值，因此可以在剩余步骤点击 确认无误 继续，稍后再调整。
3. 完成向导。Warmbly 会向 Pipedrive 添加自己的字段，注册 Pipedrive 变更通知，并开始首次拉取：先拉取用户和销售管道，再拉取商机及近期活动。运行过程中，控制台逐渐填入数据，通常只需一两分钟。

设置完成后，同一页面提供配置选项和同步健康度面板。修改设置需要 manage_settings 权限。

如果切换时工作区正在使用 HubSpot，向导会先说明。切换后，Pipedrive 取代 HubSpot 成为 CRM；HubSpot 镜像记录仍留在 Warmbly 中，HubSpot 也不会删除任何数据，并继续保持连接供自动化流程使用。

Pipedrive 中的变更通过其变更通知到达 Warmbly，通常只需数秒。Warmbly 也会每十五分钟检查一次变更，以防通知遗漏；无法使用通知时，则每五分钟检查一次。在 Warmbly 中打开联系人，会立即刷新其 Pipedrive 人员记录；商机、活动和备注则每隔数小时刷新。

Pipedrive 为每家公司分配每日 API 额度，由该公司使用的所有应用共享。Warmbly 只读取发生变更的内容，并错开检查时间，因此正常工作区只会使用其中一小部分。

商机与销售管道

销售管道页面只列出 Pipedrive 管道。创建、重命名或删除管道或阶段会以 crm_managed_externally 被拒绝：请在 Pipedrive 中修改，片刻后就会显示在 Warmbly 中。在向导中可以将镜像范围限制为部分管道；其他管道中的商机不会显示。

Pipedrive 与 Warmbly 一样，将赢单和输单表示为商机状态：标记为赢单或输单时保留原阶段，在阶段之间移动也不会改变状态。阶段携带 Pipedrive 的商机成交概率。如果商机的 Pipedrive 负责人不是工作区成员，仍会显示该用户的姓名。

Pipedrive 作为 CRM 期间，仅存在于 Warmbly 的管道中的商机会从商机表格和看板中隐藏。它们并未删除：将其复制到 Pipedrive或切回原模式后即可再次看到。

自动化流程通过创建商机或移动商机阶段操作生成的商机也会写入 Pipedrive，但通过同步队列处理，而非立即执行。

活动

任务页面显示 Pipedrive 用户负责、且该用户已匹配到工作区成员的 Pipedrive 活动。首次拉取包含最近 90 天发生过变化的活动。打开人员记录时，会拉取其自身活动，无论由谁负责。已完成的邮件活动是邮件记录，不是待办事项，因此不会显示为任务；Warmbly 自己记录的邮件活动也包括在内。

创建、编辑或删除任务类型会以 crm_managed_externally 被拒绝，因为这些类型由 Pipedrive 活动类型决定。Warmbly 自动创建的任务也会成为 Pipedrive 活动，例如由回复产生的跟进任务，以及自动化流程中的创建任务。

Warmbly 联系人通过电子邮件地址与 Pipedrive 人员关联。以下情况会建立关联：Warmbly 向联系人发信、你打开联系人、Pipedrive 中某个人员发生变更且 Warmbly 已有其地址，以及从 Pipedrive 筛选器导入之后。

Warmbly 向 Pipedrive 尚未收录的人发信时，会创建人员记录，默认开启；负责人是与发件邮箱所属成员匹配的 Pipedrive 用户。开启创建组织后（同样默认开启），新人员会关联到以其公司名称命名的组织；公司为空时，使用电子邮件域名。若 Pipedrive 中没有该组织，则创建。gmail.com 等免费邮箱域名绝不会变成组织。如果关闭创建人员，Pipedrive 中不存在的人就不会在那里记录活动。

每个映射字段都有同步方向：

默认将名字、姓氏、公司和电话映射到人员的名字、姓氏、组织和电话，均为最近修改优先。Pipedrive 将姓名保存在一个字段中并自行拆分，因此名字和姓氏会一起写入。Warmbly 自定义字段使用 custom:<key>，可映射到你任意的文本、数字、电话或日期字段。Pipedrive 中的空值不会清空 Warmbly 字段，电子邮件地址也绝不会被 Pipedrive 覆盖。

还可以选择最多 40 个 Pipedrive 字段，显示在联系人面板中。

每项活动会关联到人员、其组织和未关闭的商机。负责人优先使用与发件邮箱所属成员匹配的 Pipedrive 用户，否则使用该人员的负责人。活动会在数秒内记录，且完全不依赖你的 Webhook及其每分钟限额，因此大批量发送也能完整记录。

打开和点击记录默认关闭，因为邮件隐私代理和安全扫描器会自动打开与点击。开启后，它们也只更新这两个字段，每个人每天最多更新一次，且绝不会因此在 Pipedrive 中创建人员。

切换时，Warmbly 会向 Pipedrive 人员添加以下自定义字段，并持续更新。此功能默认开启；关闭后会停止全部字段写入，包括打开和点击。如果团队已有同名字段，则复用该字段。

Pipedrive 用户按电子邮件地址匹配工作区成员。地址不一致时，可以在 Pipedrive 页面手动选择成员；手动匹配会被保留，不会被邮箱匹配覆盖。匹配关系决定：

• 任务页面显示谁的活动
• 邮箱记录的邮件活动及创建的人员由谁负责
• 在 Warmbly 中将商机或活动分配给成员时，对应哪位 Pipedrive 用户

回复被判定为感兴趣时，Warmbly 可以：

• 为人员添加标签：默认使用 Hot lead（高意向潜客），前提是公司存在该标签。该标签会替换人员当前的标签
• 将其加入 Leads Inbox（潜在客户收件箱）：为该人员及其组织创建潜在客户，由收到回复的邮箱所属成员负责；默认关闭
• 在指定管道和阶段中创建商机，默认关闭

如果该人员已有未关闭的商机，则创建潜在客户和创建商机都会跳过。跟进任务沿用现有的回复跟进设置，并与其他任务一样成为 Pipedrive 活动。

当 Pipedrive 表明人员已进入下一阶段时，退出规则会暂停该人员参与的所有营销活动，避免其已经成为商机或客户后仍收到跟进邮件。被暂停的潜在客户会持续保持暂停，直到有人恢复；暂停状态会显示原因，例如“已在 Pipedrive 中创建商机”。

导入保护措施

导入保护规则决定从 Pipedrive 筛选器导入时排除哪些人：

人员和商机页面上的 Warmbly 面板显示该人员的 Warmbly 状态、所参与的各营销活动及其步骤、状态和最近活动，以及潜在客户暂停的原因，并提供在 Warmbly 中打开联系人的链接。它的两项操作可以直接在 Pipedrive 内完成：

• 加入 Warmbly 营销活动打开活动选择器并添加人员。如果该人员尚不存在于 Warmbly，会根据 Pipedrive 人员记录创建，已在 Pipedrive 中退订的除外
• 在 Warmbly 中暂停暂停或恢复该人员参与的所有营销活动

在商机页面中，面板显示该商机关联的人员。面板以查看它的 Pipedrive 用户所匹配的 Warmbly 成员身份和角色运行，参见用户：

如果 Pipedrive 用户没有匹配成员，或对应成员仍处于受邀状态、被禁止登录、缺少权限，面板会说明原因，且不会修改任何内容。面板要求该 Pipedrive 公司恰好在一个 Warmbly 工作区中启用 Pipedrive 模式。在自托管实例中，面板属于你自己的 Pipedrive 应用；参见自托管。

在联系人中选择从 Pipedrive 导入，再选择一个已保存的人员筛选器。预览会统计将导入的人数，以及按原因划分的跳过人数：已退订、标签、已有未关闭商机、由工作区之外的人负责、没有电子邮件地址，以及地址重复。继续后，筛选结果会转为普通联系人导入，在常规导入审阅中选择营销活动、标签和重复处理方式并完成。

一次最多导入 25,000 人；更大的筛选结果会在该数量处截断，并在预览中说明。导入的联系人会在几分钟后与其 Pipedrive 人员记录关联，确保首次发送记录到正确的人。

原先使用 Warmbly CRM 的工作区切换后，其自有商机、任务和备注还不存在于 Pipedrive。从工作区此前使用的其他 CRM（如 HubSpot）镜像来的记录不计入其中。Pipedrive 页面会统计待复制记录，并一次性复制你选择的类型：

• 商机移入第一个 Pipedrive 管道。如果 Pipedrive 存在同名阶段，就保留阶段；否则进入第一个阶段。赢单和输单商机保留原状态
• 任务变为活动，备注仍为备注，并保留人员和商机关联

已存在于 Pipedrive 的记录不会重复复制，因此再次运行只会补齐遗漏项。切换后，如果编辑某个 Warmbly 商机、任务或备注，也会在当时将其创建到 Pipedrive。

Pipedrive 页面会显示等待处理的内容、最近运行中失败的内容、已镜像的记录数，以及各项拉取（用户、管道、商机、活动、人员）、变更通知和 Warmbly 字段的最近运行时间及错误。立即同步启动一次完整拉取；一分钟内再次启动会以 crm_sync_running 被拒绝。

在控制台中修改时，会同步等待 Pipedrive 写入。活动记录、自动化流程写入的记录、大规模批量修改和复制操作通过队列处理；失败时以逐渐增长的间隔重试，从一分钟、五分钟、半小时到数小时，之后才标记为失败。失败项会保留在列表中 30 天，并提供通俗的原因说明。重试再次发送，丢弃则移除该项。

Warmbly 的调用量始终明显低于 Pipedrive 对每家公司的突发限制，即每两秒 30 次请求和 4 次搜索，额度在所有 Warmbly 进程间共享；Pipedrive 要求降速时，会等待并重试。

再次选择 Warmbly 作为 CRM、切换到 HubSpot，或断开 Pipedrive，都会停止同步和活动记录。切换会移除 Warmbly 在 Pipedrive 中注册的变更通知；断开连接后，Warmbly 会对通知投递返回资源已不存在，随后 Pipedrive 会停用它们。任一侧都不会删除数据：已镜像的商机、管道、任务和备注留在 Warmbly，成为可编辑的普通记录；之前隐藏、仅属于 Warmbly 的管道会重新出现；Pipedrive 保留所有已写入的内容，包括 Warmbly 字段。以后重新切换到同一家 Pipedrive 公司时，会继续使用原有记录，不会创建重复项。

自托管实例使用自己的 Pipedrive 应用。在 Pipedrive Developer Hub 创建应用，然后：

1. 将回调 URL 设为 BACKEND_PUBLIC_URL 加 /integrations/oauth/callback；如果设置了 INTEGRATIONS_OAUTH_REDIRECT_URL，则使用该值。
2. 为应用授予以下权限范围：商机（完全访问）、联系人（完全访问）、活动（完全访问）、用户（读取）、搜索（读取）、潜在客户（完全访问）、联系人字段（完全访问）和 Webhook（完全访问）。Pipedrive 模式需要前四项；缺少其余权限时，会跳过潜在客户创建、Warmbly 字段或即时更新等相关功能。
3. 在后端和消费者服务中设置 PIPEDRIVE_OAUTH_CLIENT_ID 与 PIPEDRIVE_OAUTH_CLIENT_SECRET，并设置 APP_URL，让 Open in Warmbly 字段指向你的控制台。参见配置。
4. 可选：在 App extensions（应用扩展） 下添加 Warmbly 面板，包括一个 JSON 面板和两个 JSON 模态窗口，其架构文件位于仓库的 pipedrive-app/ 目录。步骤参见配置。

消费者服务负责拉取和同步队列。工作区切换时，Warmbly 会自行注册变更通知，每个连接一组，投递到 <backend>/api/v1/integrations/pipedrive/webhooks/<connection id>。要求 BACKEND_PUBLIC_URL 是 Pipedrive 可以访问的 https 地址；否则 Warmbly 会改为每五分钟检查一次 Pipedrive。Pipedrive 使用 Warmbly 根据客户端密钥为该连接派生的密码，验证每次投递。通知只会让 Warmbly 更早读取指定记录：它始终从 Pipedrive 自身读取数据，且只有 Pipedrive 明确回应记录已不存在时，才会移除镜像记录。

工作区导出包含 CRM 模式、设置选项、用户匹配关系、Warmbly 记录与 Pipedrive 记录的对应关系，以及各联系人的 Pipedrive 详情，因此目标实例会继续更新同一批 Pipedrive 记录，不会重复创建。同步队列和拉取检查点不会迁移；目标实例会开始自己的拉取，并注册自己的变更通知。除非目标使用同一个 Pipedrive 应用，且归档包含凭据，否则需在目标实例重新连接 Pipedrive。

支持哪些 Pipedrive 套餐？ 每个套餐都包含 Pipedrive 模式使用的商机、人员、活动、备注和筛选器。只有启用 Pipedrive Campaigns 的公司才记录退订状态，因此未启用时，退订退出规则和导入保护规则不会产生作用。

为什么邮件记录为活动？ Pipedrive 只允许应用通过其自身的邮箱同步机制添加邮件。已完成的 Email 活动是最接近的记录形式：它带有主题和正文，出现在人员时间线上，并计入 Pipedrive 活动报表。

为什么默认关闭打开记录？ 邮件隐私代理和安全扫描器会自动打开与点击，因此打开只是较弱的信号。开启后，也只更新 Warmbly last opened 和 Warmbly last clicked 字段。

断开连接后，数据会怎样？ 所有已镜像的内容都作为普通记录保留在 Warmbly 中，Pipedrive 中也不会移除任何内容。参见切回原模式与断开连接。

可以在 Warmbly 中编辑销售管道吗？ Pipedrive 作为 CRM 期间不可以。请在 Pipedrive 中编辑，片刻后就会更新到 Warmbly。

每位成员都需要 Pipedrive 席位吗？ 不需要。没有匹配用户的成员仍可查看商机、活动和备注，只是不能被分配 Pipedrive 商机或活动；其邮箱产生的邮件活动会记录在该人员的负责人名下。