Salesforce CRM 集成

介绍


3CX 提供与Salesforce通过 3CX API for CRM 实现以下功能：

  • 来电主叫号码识别为联系人姓名 – 当有来电时，系统将自动在 Salesforce 中查找对应的联系人。
  • 基于姓名、号码或邮箱的 Salesforce 联系人查找：如果您在 3CX 网页客户端中搜索姓名，系统将在 Salesforce 中查找相关联系人。
  • 通话和聊天记录– 通话和聊天作为 CRM 通话记录记录在 Salesforce 联系人卡中。
  • 从 3CX 客户端创建新的 Salesforce 联系人：当有来自新号码的来电时，可直接在 3CX 中创建一个新的 Salesforce 联系人。
  • 点击拨号（Click to Call）：通过 3CX Click2Call 浏览器插件（支持 Google Chrome 和 Microsoft Edge），可直接从 Salesforce 发起呼叫。 通过 3CX 直接从 Salesforce 发起呼叫，使用 3CX Click2Call 浏览器扩展程序谷歌浏览器 和 微软 Edge。

要求：

  • 您的 Salesforce 账户必须启用 REST API。请查看此处了解哪些 Salesforce 版本支持 API。
  • Salesforce 帐户个人账户不支持启用。

步骤 1：配置Salesforce

  1. 登录您的 Salesforce 帐户https://login.salesforce.com/或者从此处创建开发者帐户https://developer.salesforce.com/signup。
  2. 点击“齿轮图标” > “Setup”
  3. 在侧边栏的“平台工具”部分下，选择“Apps > App Manager”
  4. 点击位于网页右上角的“New External Client App”按钮。
  5. 将出现“External Client App Manager”表单。

  1. 在基本信息面板，提供外部客户端应用程序名称、联系电子邮件和分发状态。


  1. 向下滚动到 API（Enable OAuth 设置）并启用“Enable OAuth”复选框。
  2. 对于Callback URL 字段，输入用于访问 3CX 管理控制台的 URL，并添加“/api/oauth2crm”在末尾，例如：“https://my-pbx.example.com/api/oauth2crm”。然后根据上图授予权限。权限如下：
  • Access the identity URL service (id, profile, email, address, phone)
  • Access unique user identifiers (openid)
  • Full Access (full)
  • Manage user data via APIs (api)
  • Manage user data via Web browsers (web)
  • Perform requests at any time (refresh_token, offline_access)
  1. 向下滚动到安全 部分， 确保“Require Secret for Web Server Flow”和 “Require Secret for Refresh Token Flow”选项被选中。
  2. 此外，请注意PKCE (Proof Key for Code Exchange)现在支持 3CX 版本 20，Update  6。您可以通过启用选项来使用 PKCE 身份验证流程“Require Proof Key for Code Exchange (PKCE) Extension for Supported Authorization Flows”。如果禁用该选项，PKCE 将被忽略，授权将成功完成。
  3. 按“创建”。
  4. 点击 ”Apps > External Client App Manager> Find your app” 并点击“Edit Policies”。

  1. 在“策略”下，转到 OAuth 策略部分并将允许的用户设置为“All users can self-authorize”
  2. 单击“Save”。

  1. 在“Settings”下，转到 OAuth设置部分，然后点击按钮“Consumer Key and Secret”。然后复制“Consumer Key”和 ”Consumer Secret“——我们稍后需要在 3CX CRM 集成部分中添加这些内容。

步骤2：配置3CX


  1. 在 3CX 管理控制台中，转到“集成”>“CRM”。
  2. 选择 ”SalesforceV2”从下拉列表中选择。
  3. 填写上一步获取的消费者密钥和消费者密码信息，然后按“保存”按钮，然后点击“授权”按钮开始授权流程。授予 3CX 访问权限后，刷新令牌将显示在授权按钮下方。

步骤 3：配置通话和聊天日志


  1. 要将外部呼叫和聊天报告给 Salesforce，为 3CX 分机配置的电子邮件地址必须与 Salesforce 用户的电子邮件地址匹配。这样，3CX 就可以将接收呼叫或聊天的 3CX 分机映射到 Salesforce 用户。
  2. 选中“启用呼叫日志”选项以将外部呼叫报告给 CRM，并配置以下“呼叫日志”参数：
  • “Call Subject” - the call’s subject.
  • “Answered Inbound Call” - description for answered inbound calls.
  • “Missed Call” - description for missed calls.
  • “Answered Outbound Call” - description for answered outbound calls.
  • “Unanswered Outbound Call” - description for unanswered outbound calls.
  1. 请注意，您可以在“呼叫日志”参数中使用变量，表示为
    [variable_name]
    ，例如，外部号码指定为
    [Number]
    。查看可用的变量点击    此处。


  1. 如果您想将聊天报告给 CRM，请选中启用聊天日志复选框并配置以下参数：
  • Chat Subject: The subject of the chat session.
  1. 请注意，您可以在“聊天日志”参数中使用变量，表示为
    [variable_name]
    ，例如，外部号码指定为
    [Number]
    。查看可用的变量点击    此处。

步骤 4：配置 e164 联系人和来电显示


  1. 为了与 Salesforce 匹配，来电显示的最后 7 位数字必须与 CRM 条目中电话字段的最后 7 位数字匹配，或者从 SIP 中继收到的完整号码必须与 CRM 中的电话号码完全匹配。
  2. Salesforce 可以存储 E164 格式的号码，因此如果您的 SIP 中继也提供 E164 格式的呼叫者号码，则最好使用精确匹配。您也可以使用来电显示重新格式化在将呼叫者的号码转接到 CRM 之前对其进行调整。
  3. ⚠ 重要提示：在 3CX 管理控制台中，前往“系统” > “电话簿” > “选项”。将匹配策略设置为“尽可能完全匹配”（Salesforce 和 SIP 中继需要 E164 格式），或“匹配至少 X 个字符”，并将值设置为 7。
  4. ⚠ 重要提示：在 Salesforce 中，确保所有联系人的号码都以 E164 格式存储，包括加号 (+) 前缀。此加号 (+) 前缀可防止 Salesforce如果您位于美国或加拿大，则自动重新格式化号码，导致联系人查找失败。

步骤 5：配置联系人创建


  1. 如果您想在接到未知号码（3CX 和 CRM 中均未找到）的电话时在 CRM 中创建新联系人，请检查勾选“允许使用 3CX Web 客户端直接在 CRM 中创建联系人”复选框并配置下面的参数。
  2. 联系人创建参数包括：
  • Create Lead or Contact - The entity to be created (Lead/Contact).
  • New Lead Company - The name of the Company when a Lead is created.
  1. 请注意，您可以在参数中使用变量。变量在 [] 之间指定，例如，外部号码指定为 [Number]。可用的变量点击此处。
  2. 当呼叫者的号码无法与联系人匹配时，3CX 客户端将允许用户通过在对话框中填写详细信息来创建联系人。

📄注意：在 Salesforce 中创建联系人时，网页客户端中指定的公司名称将被忽略。这是由于 Salesforce API 的限制。此限制仅适用于联系人，公司名称在创建潜在客户时设置。

另请参阅

上次更新

本文件最后更新于 2025 年 7 月 16 日

https://www.3cx.cn/docs/salesforce-crm-integration/