HubSpot 查找

您可以配置 HubSpot 集成，以使用主查找和辅助查找功能，根据联系人记录或公司资料识别来电者。如果主查找未返回任何结果，系统会尝试辅助查找。此外，您还可以配置代理适配器中显示哪些来自匹配的主查找对象或次查找对象的 CRM 客户账号显示字段。最后，您可以配置代理适配器中显示的 CRM 记录显示字段，无论匹配的是主要对象还是次要对象。记录显示字段适用于已打开的 CRM 记录（例如支持请求或交易）。

在配置主查找对象和配置辅助查找对象时，配置 CRM 账号显示字段。如需配置 CRM 记录显示字段，请参阅在代理适配器中配置 CRM 记录显示字段。

注意： HubSpot 查找功能取代了之前的 HubSpot 手机号码查找功能。 如果您使用 HubSpot 手机号码查询功能配置了 HubSpot 集成，则您的配置会一直保留，直到您对其进行修改为止。

准备工作

在开始之前，请将 HubSpot 与 Contact Center AI 平台 (CCAI Platform) 实例集成。 如需了解详情，请参阅 HubSpot。

配置主查询对象

您可以配置主要查找对象，即系统在会话开始时搜索的第一个对象。您还可以配置哪些 CRM 账号显示字段会显示在代理适配器中。以下步骤将向您介绍如何执行这两个操作。

如需配置主要查找对象和 CRM 客户账号显示字段，请按以下步骤操作：

1. 在 CCAI 平台门户中，依次点击设置 > 开发者设置。 如果您没有看到设置菜单，请点击 菜单。

2. 在 CRM 窗格中，前往账号查找部分。

3. 如需配置主要查找对象，请执行以下操作：

   1. 展开主要查找对象部分。

   2. 在对象类型列表中，选择要查找的对象类型。

   3. 在手机号码查找字段列表中，选择系统应使用哪些字段来匹配最终用户的手机号码。

   4. 在手机号码主字段列表中，选择系统在创建新的 CRM 账号时存储客户手机号码的字段。

   5. 对于手机号码格式，请选择请求手机号码格式。

   6. 可选：如需按自定义字段查找 SDK 会话的最终用户，请执行以下操作：

      1. 选中 Mobile / Web SDKs: lookup users by custom field for SDK sessions 复选框。

      2. 在 CRM 中的自定义查找字段列表中，选择自定义查找字段。

4. 如需在代理适配器中配置 CRM 账号显示字段，请执行以下操作：

   1. 在 CRM 账号显示字段部分的匹配的账号显示字段列表中，选择账号的主要标识符。

   2. 可选：如需显示第二个字段，请执行以下操作：

      1. 选中显示第二个字段复选框。

      2. 在第二个显示字段列表中，选择要显示的第二个字段类型。

      3. 对于第二个字段显示位置，请选择在代理适配器中显示字段的顺序。

5. 点击保存。

配置辅助查找对象

您可以配置辅助查找对象，以在主查找未返回任何结果时作为后备。您还可以配置哪些 CRM 账号显示字段会显示在代理适配器中。以下步骤将向您介绍如何执行这两个操作。

如需配置辅助查找对象和 CRM 账号显示字段，请按以下步骤操作：

1. 在 CCAI 平台门户中，依次点击设置 > 开发者设置。 如果您没有看到设置菜单，请点击 菜单。

2. 在 CRM 窗格中，前往账号查找部分。

3. 如需配置辅助查找对象，请执行以下操作：

   1. 选中次要查找对象复选框。

      注意： 对象类型列表会显示您在配置主查找对象中未选择的选项类型。

   2. 在手机号码查找字段列表中，选择系统应使用哪些字段来匹配最终用户的手机号码。

   3. 在手机号码主字段列表中，选择当 CCAI Platform 创建新的 CRM 账号时，客户的手机号码所存储的字段。

   4. 对于手机号码格式，请选择请求手机号码格式。

   5. 可选：如需按自定义字段查找 SDK 会话的最终用户，请执行以下操作：

      1. 选中 Mobile / Web SDKs: lookup users by custom field for SDK sessions 复选框。

      2. 在 CRM 中的自定义查找字段列表中，选择自定义查找字段。

4. 如需在代理适配器中配置 CRM 账号显示字段，请执行以下操作：

   1. 在 CRM 账号显示字段部分的匹配的账号显示字段列表中，选择账号的主要标识符。

   2. 可选：如需显示第二个字段，请执行以下操作：

      1. 选中显示第二个字段复选框。

      2. 在第二个显示字段列表中，选择要显示的第二个字段类型。

      3. 对于第二个字段显示位置，请选择在代理适配器中显示字段的顺序。

5. 点击保存。

在代理适配器中配置 CRM 记录显示字段

您可以配置代理适配器中显示的 CRM 记录显示字段，无论匹配的是主要对象还是次要对象。如需配置哪些 CRM 代理显示字段会显示在代理适配器中，请参阅配置主查找对象和配置辅助查找对象。

如需在代理适配器中配置 CRM 记录显示字段，请执行以下操作：

1. 在 CCAI 平台门户中，依次点击设置 > 开发者设置。 如果您没有看到设置菜单，请点击 菜单。

2. 在 CRM 窗格中，前往 CRM 记录显示字段部分。

3. 在匹配的记录显示字段列表中，选择记录的主要标识符。

4. 可选：如需显示第二个字段，请执行以下操作：

   1. 选中显示第二个字段复选框。

   2. 在第二个显示字段列表中，选择要显示的第二个字段类型。

5. 可选：如需显示第三个字段，请执行以下操作：

   1. 选中显示第三个字段复选框。

   2. 在第三个显示字段列表中，选择要显示的第三个字段类型。

6. 点击保存。

查找级联逻辑

以下内容介绍了 CCAI 平台用于对象查找的级联逻辑：

• 如果提供了 contact_id，CCAI 平台会先执行直接 GET 调用。否则，CCAI Platform 会使用 OR 逻辑搜索手机、电子邮件、SDK 和 SIP 标识符。

• 如果找到多个匹配记录，CCAI 平台会选择最近修改的记录。修改日期的确定方式如下：

  • 联系人使用 lastmodifieddate。

  • 公司使用 hs_lastmodifieddate。