介绍
3CX IP PBX通过简单明了的服务器端配置与 Hubspot 集成。集成为 3CX IP PBX和 Hubspot 的用户带来了以下功能：
- 联系人同步：外部呼入的号码会触发 CRM 联系人查找，如果 CRM 中存在此联系人会添加到 3CX IP PBX联系人当中，该联系人的信息也会自动显示在来电显示中。
- 来电弹屏：使用 3CX Web 客户端时，收到呼叫时会自动显示客户记录。
- 呼叫记录：每一通呼叫也会同时记录在 CRM 当中。
- 当收到来自未知号码的电话时，会自动创建一个新联系人。
- 点击拨号 – 点击 Hubspot 上的号码直接从 3CX IP PBX侧直接呼出，需使用 3CX Click2Call 浏览器插件。
本向导将介绍如何对接 Hubspot 与 3CX。
由于 Hubspot API 的限制，联系人查找只能在联系人字段查找，不能在公司字段查找。只添加主要联系人号码，而不添加手机和传真号码。
Hubspot 配置
通用设置
- Hubspot 需要 OAuth2 验证让 3CX 通过验证接入您的数据，所以你需要一个 HubSpot 开发者账号 创建一个 app。
- 登录 Hubspot 开发者账号，选择 “Create app” 选项。
- 将 App name 设为 “3CX Server-side”，“Application visibility” 设为 “Private” 然后点击创建。
- 复制 “Client ID” 和 “Client secret”，在后面我们会用到。
3CX CRM 服务端配置
联系人匹配策略
要与 Hubspot 进行号码匹配，来电者的号码必须与 CRM 侧的完全一致，前缀也需一致。如果使用数字的子集进行查询，Hubspot 不会返回任何数据。
在 3CX 管理控制台，“高级” > “联系人” > “选项”，将将来电匹配到通讯录条目设为精确匹配。点击 OK 保存。
通用设置
- 在 3CX 管理控制台选择 “设置” > “CRM 集成” > “服务端”。
- 下列列表里选择 “Hubspot”。
- 输入刚才使用 Hubspot 开发者账号创建的 “Client ID” 和 “Client Secret”。
- 点击 “Authorize”,然后在弹出的 “Request for Integration Permissions“，点击 “Grant access” 进行验证。
- 看一下 3CX 管理控制台 Hubspot CRM 的区域是否自动填写了 “Refresh Token”。
- 接下来配置 “Call Journaling” 和 “Contact Creation”，不需要的话可以点击保存完成配置。
Call Journaling
- 勾上 “Enable Call Journaling” 选项，3CX 会将外部呼叫报告给 CRM，然后我们配置下面的参数：
- “Call Subject” – 呼叫的主题。
- “Answered Inbound Call” – 对于接听来电的描述。
- “Missed Call” – 对于未接来电的描述。
- “Answered Outbound Call” – 对于接听的外呼进行描述。
- “Unanswered Outbound Call” – 对于未接通的外呼描述。
- 你也可以在 “Call Journaling” 中加入参数，参数都用中括号括起：
[参数]，比如[Number]。可以使用的参数有以下几个：- CallType – 呼叫的类型，有 “Inbound” “Outbound” “Missed” 和 “Unanswered”。
- Number – 外部联系人的号码。呼出时候拨打的号码，呼入时候的来电号码。
- Agent – 接听呼叫的分机号。
- Duration – 呼叫时长，格式是 “hh:mm:ss”。
- DurationTimeSpan – 呼叫时长记录为 TimeSpan 对象，使用用户自定义的格式。
- DateTime – 呼叫开始的日期和时间，本地时区，格式为 3CX 服务器的本地时区。
- CasllStartTimeLocal – 呼叫开始的日期和时间，本地时区，使用用户自定义的格式记录为 Datetime 对象。
- CallStartTimeUTC – 呼叫开始的日期和时间，UTC 时区，使用用户自定义的格式记录为 Datetime 对象。
- CallEndTimeLocal – 呼叫结束的日期和时间，本地时区，使用用户自定义的格式记录为 Datetime 对象。
- CallEndTimeUTC – 呼叫结束的日期和时间，UTC 时区，使用用户自定义的格式记录为 Datetime 对象。
Contact Creation
当来电的是 CRM 中不存在的未知号码时，会在 CRM 中自动创建联系人。创建联系人的时候会使用下列参数：
- “New Contact First Name” – 自动创建联系人的名字。
- “New Contact First Name” – 自动创建联系人的姓氏。
这里你也可以使用变量：
- Number – 外部联系人的号码。呼出时候拨打的号码，呼入时候的来电号码。