Communications Mining 用户指南
Communications Mining™ Salesforce 集成提供了一种方便且易于设置的方式，可以将 Salesforce 通信数据实时同步到 Communications Mining 中。该集成能够同步电子邮件和其他通信数据。
Salesforce 集成是在 Communications Mining™ 云上运行的托管管道，可以配置为从 Salesforce 对象中提取通信数据片段，而无需任何开发。
配置集成后，它将持续轮询 Salesforce 中已配置的对象和字段，进行清理，使用对象元数据丰富它们，并将其转换为 Communications Mining 注释对象。 任何具有适当访问权限的用户都可以在网页界面和 API 上使用 Communications Mining 注释。
Access to Salesforce data via the Salesforce Integration is managed through Salesforce Connected Apps and authenticated with OAuth2, giving you full control of when and how much you give Communications Mining access to your data.
为了向您的 Salesforce 实例提供 Communications Mining™ 访问权限，Salesforce 管理员需要创建一个已连接的应用程序。
您需要熟悉已连接的应用程序的概念，但要设置 Communications Mining Salesforce 集成，以下步骤就足够了。应使用用于对已连接的应用程序进行身份验证的同一帐户完成这些步骤。
集成用户
任何有权访问您提供给 Communications Mining 的数据的 Salesforce 用户都可用于对集成进行身份验证。通常，建议使用专门的集成用户执行此操作，这样 Salesforce 集成就不会与特定人员的帐户绑定。有关此主题的 Salesforce 建议的更多详细信息，请查看拥有专门的 Salesforce 集成用户的价值。
- 在您的Salesforce 设置中，在“应用程序”下，选择“应用程序管理器” ，然后选择“新建已连接的应用程序” 。
在 Salesforce 中创建新的已连接应用程序
- 按照Salesforce 的指导进行操作，并填写必填信息，例如应用程序名称、API 名称和联系人电子邮件。 以下是一个示例：
所需信息示例
- 选中复选框“启用 OAuth2 设置” ，这将打开一个新的选项部分。
-
确保应用程序不需要代码交换证明密钥 (PKCE)。
-
- Under Callback URL, insert the following line, replacing
<mydomain>with your tenant domain:https://<mydomain>.reinfer.io/external/salesforce/oauth2/callback. - 要正常运行 Salesforce 集成，需要以下作用域。 将它们添加到“选定的 OAuth2 作用域” 。
OAuth2 作用域 通过 API (api) 管理用户数据 随时代表您执行请求（refresh_token、offline_access） 已连接应用程序所需的 OAuth2 设置 - 您无需更改任何其他设置。选择页面底部的“保存” ，以创建“已连接的应用程序”。
- 记下刚创建的已连接应用程序的使用者密钥和使用者密码。 您需要将其发送给我们以设置集成。
使用者密钥和使用者密码
设置
Communications Mining™ 工程师将使用您提供的信息设置 Salesforce 集成。 请联系您的客户团队联系工程师。
创建连接的应用程序后，请为您的 Communications Mining 工程师提供以下详细信息。
| 名称 | 说明 |
|---|---|
| 使用者密钥 | 由字母和数字组成的一长串，位于已连接应用程序的页面上 |
| 使用者密码 | 由字母和数字组成的一长串，位于已连接应用程序的页面上 |
| 实例 URL | 您的 Salesforce 实例 URL，例如um6.salesforce.com 。有关如何查找此字段的更多详细信息，请查看Salesforce 文档。
|
Salesforce 对象
可以将 Salesforce 集成配置为轮询任何标准或自定义 Salesforce 对象。对于要同步到 Communications Mining 的每个对象，请提供对象的Salesforce API 名称及其字段。
权限
请确保用于对集成进行身份验证的用户对对象具有“读取”和“查看全部”权限，对您要同步到 Communications Mining 的字段具有“读取”访问权限。
OAuth 2 身份验证
该集成需要经过身份验证才能访问您的 Salesforce 数据。 此操作需使用授权的 Salesforce 帐户通过 OAuth2 完成。 您应使用用于设置已连接应用程序的同一帐户对集成进行身份验证。
- 导航到我们提供的身份验证 URL。 它将如下所示：
https://<mydomain>.reinfer.io/integrations/<project-name>/<integration-name>/oauth2/authenticatehttps://<mydomain>.reinfer.io/integrations/<project-name>/<integration-name>/oauth2/authenticatewhere<mydomain>is your tenant domain, and<project-name>/<integration-name>are the project and name of your Salesforce Integration. - 系统将自动将您重定向到 Salesforce 登录页面。 使用可提供集成访问权限的 Salesforce 帐户登录。 浏览器将重定向到确认页面。
Salesforce OAuth2 登录页面
- 在确认页面上，批准请求的权限。
Salesforce OAuth2 确认页面
- 完成后，系统应该会将您重定向回
https://<my_tenant>.reinfer.io，并显示一条通知，指示已成功配置集成。
