OneTrace.pro 帮助中心

CRM

CRM 同步会将联系人和交易导入 OneTrace.pro;对于有线索的 CRM,还会导入线索。支持 amoCRM(以及 Kommo)、Bitrix24、HubSpot、Pipedrive、Zoho CRM、Odoo、Salesforce 和 Microsoft Dynamics 365。联系人成为档案,交易阶段成为事件,赢单交易则成为收入报表中的购买。您可以基于这些数据创建分群并启动旅程:例如,在交易进入“合同”阶段时给客户发消息,或召回长时间未购买的客户。旅程还可以反向写入 CRM:创建交易、给经理分配任务、更改阶段;分群也可以作为列表或标签导出回 CRM。

在菜单中打开数据 → CRM。CRM 同步从“增长版”套餐起提供,参见套餐。

CRM 板块:amoCRM、Bitrix24、Salesforce 和 HubSpot 同步

支持哪些 CRM

所有 CRM 都使用您自己的密钥接入:令牌、API 密钥,或您在自己的 CRM 中创建的应用。OneTrace.pro 不会索要 CRM 密码。

CRM 接入方式 线索 公司 CRM 中的分群 即时变更
amoCRM、Kommo 长期令牌 — 是 联系人标记(tag) Webhook 自动接入
Bitrix24 传入 Webhook 是 是 联系人字段“分群” 手动配置传出 Webhook
HubSpot 私有应用令牌 — 是 静态列表 手动配置 Webhook
Pipedrive API 令牌 — 是 人员标签 Webhook 自动接入
Zoho CRM Self Client 是 是 联系人标记(tag) 通知自动订阅
Odoo 登录名和 API 密钥 是 是 合作伙伴标签 手动配置自动化规则
Salesforce Connected App 是 是 营销活动(Campaign) 手动配置 Outbound Message 或 Flow
Microsoft Dynamics 365 Entra ID 应用 是 是 营销列表 手动配置 Webhook 或 Power Automate

即使没有即时变更,同步也能正常工作:它每 15 分钟核对一次变更。

同步卡片上的 Webhook 地址包含密钥(?t=…):使用该地址,变更最多每分钟到达一次。之前填入 CRM 的不带密钥的地址仍然可用,但最多每 10 分钟一次,请将其替换为卡片上的地址。自动连接的 Webhook 会在您下次保存连接时获得新地址。

如何接入 amoCRM

  1. 在 amoCRM 中打开 amoMarket(旧账户为设置 → 集成),点击创建集成 → 外部集成,并授予访问账户全部数据的权限。
  2. 在密钥和权限选项卡中点击生成长期令牌并复制。若要让变更即时到达,令牌须由 amoCRM 管理员生成。
  3. 在 OneTrace.pro 中打开集成,在 CRM 分组中选择 amoCRM。
  4. 填写账户域名(amocrm.ru 或 kommo.com)、子域名(地址中点之前的部分,mycompany.amocrm.ru 对应 mycompany)和长期令牌。
  5. 点击测试,然后点击保存。

保存时,OneTrace.pro 会自动订阅 amoCRM 中交易、联系人和公司的变更,地址会显示在 Webhook 字段中。如果 amoCRM 很早以前就已接入,请重新保存连接,以便同时订阅公司的变更。如果令牌不是由管理员生成的,则无法订阅:同步仍可正常工作,手动配置所需的地址会显示在 CRM 板块的卡片上。

amoCRM 中没有单独的线索:来自表单和聊天的请求会成为交易。“待处理线索”(Incoming leads)中的请求在经理接受后,会以联系人和交易的形式传入。

如何接入 Bitrix24

  1. 在 Bitrix24 中打开开发者资源 → 其他 → 传入 Webhook。勾选 **CRM(crm)和用户(user_brief)**权限:后者用于在事件中显示负责人姓名。保存并复制地址,格式为 https://您的门户.bitrix24.cn/rest/1/代码/。
  2. 在 OneTrace.pro 中打开集成,在 CRM 分组中选择 Bitrix24,将地址粘贴到传入 Webhook 地址字段。使用自有域名的本地部署版门户也可以接入。
  3. 点击测试,然后点击保存。

没有传出 Webhook 时,变更会在每 15 分钟一次的核对中到达。如需即时到达:

  1. 从 CRM 板块的同步卡片上复制 Webhook 地址。
  2. 在 Bitrix24 中打开开发者资源 → 其他 → 传出 Webhook,粘贴地址,并选择交易、联系人、公司和线索的创建与更新事件:ONCRMDEALADD、ONCRMDEALUPDATE、ONCRMCONTACTADD、ONCRMCONTACTUPDATE、ONCRMCOMPANYADD、ONCRMCOMPANYUPDATE、ONCRMLEADADD、ONCRMLEADUPDATE。
  3. 从传出 Webhook 的设置中复制应用令牌,粘贴到连接的传出 Webhook 令牌字段:这样 OneTrace.pro 只接受带有该令牌的信号。

传入 Webhook 地址相当于您 CRM 的钥匙:它以加密方式存储,保存后不再显示。

Bitrix24 的线索在 CRM 经典模式下同步;简易模式下没有线索。要导出分群,创建传入 Webhook 的用户需要有修改 CRM 设置的权限:首次导出时,OneTrace.pro 会为联系人创建“分群”字段,参见 CRM 中的分群。

如何接入 HubSpot

  1. 在 HubSpot 中打开 Settings → Integrations → Private Apps,点击 Create a private app。
  2. 在 Scopes 选项卡中勾选权限:crm.objects.contacts.read 和 .write、crm.objects.companies.read、crm.objects.deals.read 和 .write、crm.objects.owners.read、crm.schemas.contacts.read、crm.lists.read 和 .write。创建应用,并在 Auth 选项卡中复制令牌。
  3. 在 OneTrace.pro 中打开集成,在 CRM 分组中选择 HubSpot,粘贴私有应用令牌,点击测试,然后点击保存。

如需让变更即时到达,请在私有应用的 Webhooks 选项卡中填写 CRM 板块同步卡片上的地址,并订阅联系人、公司和交易的创建及属性变更。

HubSpot 没有独立的线索:生命周期阶段是联系人的属性。如需在分群中使用它,请添加“Lifecycle Stage → 属性”规则,参见同步设置。

如何接入 Pipedrive

  1. 在 Pipedrive 中打开个人资料菜单 → Personal preferences → API,复制个人 API 令牌。令牌以其所属用户的权限工作:最好使用管理员的令牌,这样可以看到所有交易,Webhook 也会自动接入。
  2. 在 OneTrace.pro 中打开集成,在 CRM 分组中选择 Pipedrive,粘贴 API 令牌,点击测试,然后点击保存。

保存时,OneTrace.pro 会在 Pipedrive 中注册一个接收所有变更的 Webhook。如果注册失败,手动配置所需的地址会显示在 CRM 板块的卡片上:在 Pipedrive 中打开 Tools and apps → Webhooks,创建动作和对象均为 * 的 Webhook,并粘贴该地址。

Pipedrive 的线索关联到人员:其联系人本来就会同步,不会为线索单独创建档案。

如何接入 Zoho CRM

  1. 打开 Zoho API Console,点击 Add Client 并选择 Self Client。复制 Client ID 和 Client Secret。
  2. 在 Generate Code 选项卡中填写权限 ZohoCRM.modules.ALL,ZohoCRM.settings.ALL,ZohoCRM.users.READ,ZohoCRM.org.READ,ZohoCRM.notifications.ALL,有效期选 10 分钟,然后点击 Create。复制代码。
  3. 在 OneTrace.pro 中打开集成,在 CRM 分组中选择 Zoho CRM。填写 Zoho 数据中心(即您登录 Zoho 的地址,accounts.zoho.eu 对应 zoho.eu)、Client ID、Client Secret 和授权码。
  4. 立即点击保存:授权码只在几分钟内有效。如果已过期,请重新生成。

授权码只需使用一次:OneTrace.pro 会用它换取长期访问权限,并自动订阅 Zoho 关于联系人、线索、公司和交易变更的通知,每天续订。

如何接入 Odoo

支持 Odoo 16 及更高版本:Odoo Online、Odoo.sh 和自有服务器。

  1. 在 Odoo 中打开个人资料菜单 → My Profile → Account Security,点击 New API Key。密钥以该用户的权限工作:用户需要有 CRM 和联系人的访问权限。
  2. 在 OneTrace.pro 中打开集成,在 CRM 分组中选择 Odoo。填写 Odoo 地址(例如 https://mycompany.odoo.com)、数据库(Odoo Online 的数据库通常与子域名相同)、用户登录名和 API 密钥。
  3. 点击测试,然后点击保存。

Odoo 没有订阅变更的 API。如需让变更即时到达,请在 Odoo 17 及更高版本中启用开发者模式,并在 Settings → Technical → Automation Rules 中分别为联系人以及线索和交易创建规则:触发条件为创建和更新时,动作为 Send Webhook Notification,地址为 CRM 板块同步卡片上的地址。

只有 Odoo 中的赢单交易会记为购买。销售订单不会同步:如果 Odoo 同时运行着网店,其购买本来就会从网站传入 OneTrace.pro。

如何接入 Salesforce

  1. 在 Salesforce 中打开 Setup → App Manager,点击 New Connected App。启用 OAuth,添加 Manage user data via APIs (api) 权限,并勾选 Enable Client Credentials Flow。
  2. 打开应用 → Manage → Edit Policies,在 Client Credentials Flow 部分的 Run As 中指定以其身份进行同步的用户。该用户需要有联系人、客户(Account)、线索和交易的访问权限;如需导出分群,还需要营销活动(Campaign)的访问权限(Marketing User 许可)。
  3. 在 Manage Consumer Details 中复制 Consumer Key 和 Consumer Secret。
  4. 在 OneTrace.pro 中打开集成,在 CRM 分组中选择 Salesforce。填写 Salesforce 域名(My Domain 地址,格式为 https://mycompany.my.salesforce.com,见 Setup → My Domain)、Consumer Key 和 Consumer Secret。
  5. 点击测试,然后点击保存。

如需让变更即时到达,请在 Salesforce 中创建一个 Flow,在联系人、线索、客户和交易变更时通过 Outbound Message 动作或 HTTP 请求发送到 CRM 板块同步卡片上的地址。核对会消耗组织每日 API 限额中的请求;如果限额已用完,同步会等待一小时。

如何接入 Microsoft Dynamics 365

  1. 在 Microsoft Entra admin center 中打开 App registrations → New registration 并创建应用。在 Overview 页面复制 Directory (tenant) ID 和 Application (client) ID。
  2. 在 Certificates & secrets 中点击 New client secret,并复制 Value 字段中的值。
  3. 在 Power Platform admin center 中打开 Environments → 您的环境 → Settings → Users + permissions → Application users,点击 New app user。添加刚创建的应用,并为其分配可读写联系人、公司、线索、交易和营销列表的角色。
  4. 在 OneTrace.pro 中打开集成,在 CRM 分组中选择 Microsoft Dynamics 365。填写 Dynamics 365 环境地址(Environment URL,格式为 https://mycompany.crm4.dynamics.com)、租户 ID(Directory ID)、应用程序 ID(Application ID) 和客户端密码。
  5. 点击测试,然后点击保存。

如需让变更即时到达,请在 Power Automate 中创建一个流:触发器为 Dataverse 的 When a row is added, modified or deleted,适用于联系人、公司、线索和交易,动作为向 CRM 板块同步卡片上的地址发送 HTTP 请求。也可以在 Plugin Registration Tool 中将该地址注册为 Dataverse Webhook。

客户端密码有有效期:到期后,请创建新密码并保存到连接中。

同步哪些数据

**联系人。**每个 CRM 联系人都会成为一个档案,或按邮箱和电话匹配到已有档案。同步的内容包括名字和姓氏、第一个邮箱和第一个电话。联系人的其他字段可以同步到属性中,参见同步设置。

**公司。**对于所有支持的 CRM,联系人所属的公司会写入其档案的属性:company_name 为名称,company_industry 为行业,company_employees 为员工数,company_website 为网站。同步哪些字段取决于 CRM,并显示在同步卡片上:HubSpot、Zoho CRM、Salesforce 和 Dynamics 365 提供全部四项,Bitrix24 和 Odoo 提供名称、行业和网站(Bitrix24 以区间形式存储员工数),amoCRM 提供名称和网站,Pipedrive 仅提供名称。如果公司改名,其联系人的档案会在下次核对时更新。

**线索。**对于 Bitrix24、Zoho CRM、Odoo、Salesforce 和 Dynamics 365,每条线索都会成为一个档案,带有属性 crm_lead_status(线索状态)和公司名称。这样,在分群和旅程中也可以处理尚未成为客户的人。线索转化为联系人后,线索档案会按共同的邮箱或电话与联系人档案合并。

**交易。**交易会在交易联系人的档案中记录以下事件:

事件 何时记录
crm_deal_created 交易创建
crm_deal_stage_changed 未结交易进入其他阶段;属性中包含新阶段和原阶段
crm_deal_won 交易赢单
crm_deal_lost 交易输单

事件属性中包含交易名称、销售管道、阶段、金额和币种。此外,赢单交易还会记录为购买,即使用预测设置中的购买事件和交易金额。因此,它会计入收入、RFM 分群、预测和广告转化。

没有联系人的交易会被保存,但不会产生事件:没有可记录的档案。其数量显示在运行结果中。

首次加载

接入后,同步会立即从最早的记录开始加载全部联系人、公司、线索和交易。加载期间,卡片上显示“正在加载历史”;大型 CRM 需要几个小时才能加载完成。

历史事件会进入档案、报表和预测,但不会启动旅程,不会发放会员积分,也不会发放优惠码:客户不会因为一年前已关闭的交易收到邮件。CRM 不保存接入前的阶段变更,因此历史中只有交易的创建和最终结果。

首次加载完成后,事件会正常记录并启动旅程。

同步卡片

卡片上显示状态、哪些内容记录为购买、是否同步线索和公司、同步哪些字段,以及上次运行的时间和结果:读取了多少联系人、公司、线索和交易,记录了多少事件和购买,有多少交易没有联系人。如果 CRM 的变更需要手动接入,卡片上还会显示 Webhook 地址。

  • 立即运行:立即核对变更,无需等待计划时间。
  • 暂停:停止同步。CRM 的 Webhook 也不再触发同步。
  • 历史记录:运行列表,包含结果和错误。

如果 CRM 返回错误,同步会在卡片上显示该错误。临时错误(超出请求限制、CRM 不可用)会自动重试。如果令牌被撤销、密钥被删除或客户端密码已过期,同步会停止:请在集成中修复连接并保存,同步会从中断处继续。

同步设置

点击卡片上的编辑按钮会打开设置窗口:

  • 赢单交易记为购买:是否将赢单交易记录为购买。如果订单已经从网站传入、交易会造成重复,请关闭此项。
  • 线索转为档案:是否同步线索(仅限有线索的 CRM)。如果您在 OneTrace.pro 中不需要线索,请关闭此项:这样只有在线索成为联系人后才会出现档案。
  • 联系人公司写入属性:是否写入 company_* 属性(仅限有公司的 CRM)。
  • 联系人字段:最多 30 条“CRM 字段 → 档案属性”规则。例如,“职位”字段 → 属性 job_title。属性 email、phone、first_name、last_name 以及 OneTrace.pro 的系统属性已被占用;company_* 和 crm_lead_status 属性由同步本身填写,请勿在规则中使用。

Salesforce 同步设置:购买、线索、公司和联系人字段

CRM 中的分群

OneTrace.pro 的分群可以导出到任何一个支持的 CRM,例如让经理在 CRM 中看到哪些客户属于“VIP”或长时间未购买。无需单独接入:导出使用同一个 CRM 连接。

  1. 打开受众导出,点击新建导出。
  2. 选择分群,并在目标字段中选择 CRM 连接。
  3. 在 CRM 中的名称字段中填写列表或标签的名称。如果留空,则使用分群名称。
  4. 选择模式和计划,然后点击保存。

分群在 CRM 中会成为:

CRM 创建的内容
amoCRM 联系人标记(tag)
Bitrix24 联系人字段“分群”的取值(列表字段在首次导出时创建)
HubSpot 联系人静态列表
Pipedrive 人员“标签”字段的选项
Zoho CRM 联系人标记(tag,最多 25 个字符)
Odoo 合作伙伴标签
Salesforce 以联系人为成员的营销活动(Campaign)
Microsoft Dynamics 365 联系人静态营销列表(需要 Dynamics 365 Sales)

如果已有同名的列表或标签,OneTrace.pro 会直接使用;如果没有,则会创建。只有与该 CRM 联系人关联的档案才会发送到 CRM:网站访客和线索不会导出。离开分群的档案会从列表中移除,或被取消标签。

旅程节点

在旅程编辑器的动作分组中,有四个 CRM 节点:

节点 作用 输出
“CRM 交易” 在所选销售管道和阶段(留空则为第一个阶段)中创建交易,名称和金额取自模板,并指定负责人。如果档案在 CRM 中没有联系人,会按姓名、邮箱和电话创建联系人;不会重复创建相同邮箱的联系人 成功、失败
“CRM 任务” 给经理分配带内容和期限的任务,关联到档案的未结交易;如果没有,则关联到联系人 成功、失败
“CRM 交易阶段” 将档案在所选销售管道中的未结交易移到指定阶段 成功、失败
“CRM 联系人” 写入联系人字段,并在其动态中添加备注 成功、失败

连接、销售管道、阶段、负责人和字段均从列表中选择,这些列表由 OneTrace.pro 在同步时从 CRM 获取。在文本、名称和金额中可以使用模板变量,例如客户姓名或事件中的订单金额。

每个动作在参与者的每一步中只会在 CRM 中执行一次:如果 CRM 返回错误且该步骤重试,不会出现第二个交易或任务。如果档案在 CRM 中没有联系人(创建交易时还需要邮箱或电话)、所需销售管道中没有未结交易,或 CRM 拒绝了请求,节点会进入“失败”输出。原因可在参与者记录中查看。

旅程编辑器中的“CRM 交易”节点

在旅程测试中,CRM 节点不会创建任何内容。

谁可以设置

拥有修改档案权限的成员可以使用该板块,与数据源相同。管理集成的成员可以接入 CRM。能够创建受众导出的成员可以设置向 CRM 导出分群。

注意事项

  • 每个 CRM 连接对应一个同步。可以接入多个账户:例如销售部门的 amoCRM 和客服部门的 Bitrix24。
  • 连接绑定到 CRM 账户。在同一连接中不会接受其他账户、门户或环境的密钥:请为它们新建连接。
  • 在“集成”中删除连接会停止同步;档案和事件会保留。同时,OneTrace.pro 自动注册的 Webhook 和订阅(amoCRM、Pipedrive、Zoho CRM)也会被移除。
  • amoCRM 交易没有自己的币种:金额以项目货币记录。其他 CRM 会传递交易的币种;Odoo 传递公司币种,未启用多币种的 Salesforce 则使用项目货币。
  • Zoho CRM、Odoo、Salesforce 和 Dynamics 365 只有一个销售管道,即包含全部阶段的“交易”。在 Dynamics 365 中,阶段为销售阶段,“赢单”和“输单”是单独的阶段:使用这两个阶段的“CRM 交易阶段”节点会关闭交易。
  • CRM 中不存在的联系人字段不会出现在请求中:如果字段在 CRM 中被删除,规则只是不再填写该属性。