为 3CX 配置 Facebook

介绍

Facebook 集成使您的客服人员无需登录 Facebook Messenger 即可直接从 3CX 回复您 Facebook 主页的消息。消息可以投递到呼叫队列、振铃组或单个分机。客服人员可以认领消息或将其转接给其他客服人员或组。

需要一个 已验证 的 Facebook 企业账户。

以下指南遵循 2026 年 Meta 应用创建流程的更新，并简化了权限选项。

步骤 1：开始配置您的 3CX PBX

  1. 前往“管理” > “语音与聊天”，选择“添加消息”，然后选择“添加 Facebook”。
  2. 将名称设置为您喜欢的名称。
  3. 如果您是 系统所有者 或 系统管理员，您可以使该集成在整个系统中可用，或仅对某个组可用。

  1. 将 3CX Webhook URL 复制到文本编辑器中并保存好。

步骤 2：创建 Facebook 应用程序

  1. 导航至https://developers.facebook.com,然后点击右上角的 登录。

  1. 导航至我的应用。
  2. 点击 创建应用。
  • 为您的应用程序输入显示名称，输入联系邮箱，然后点击下一步。
  • 选择选项业务消息。

  • 选择“来自 Meta 的 Messenger”选项，然后点击下一步。
  • 选择您希望此应用关联的业务账户组合；您也可以选择稍后添加。
  • 如果Meta列出了您在继续之前必须满足的其他发布要求，它们会在此处显示。
  • 点击下一步。

  • 在创建应用之前，请确保应用名称、应用联系邮箱和其他详细信息正确无误；点击创建应用。
  • 如有提示，请验证您的密码。

  • 下一个界面是应用仪表板：
  • 这将显示发布前需要完成的任务列表。
  • 您必须确保所有必需的任务都已完成。
  • 如果您退出了Facebook开发者门户，可以通过“用例”（铅笔图标）菜单项返回此界面。
  • 选择自定义选项：
  • 选择 Messenger API 设置。

  • 展开 配置webhooks：
  • 将在步骤1中保存的Webhook URL输入到 Callback URL字段中。
  • 将Webhook URL末尾最后一个“/”之后的长字符串（例如 aabbccddeeff000000001122334455）输入到验证令牌字段中。

  • 向下滚动，使用可用的最新API版本添加所需的Webhook字段：
  • messages
  • message_deliveries
  • messaging_customer_information
  • message_reads
  • message_echoes
  • 点击 验证并保存。

  • 展开 生成访问令牌：
  • 点击“添加页面”：
  • 完成身份验证流程，然后选择您要添加的 Business 页面。
  • 添加页面后，请记下 Facebook 页面 ID。
  • 选择“添加 Webhook 订阅”菜单选项，然后添加：

  • messages
  • message_deliveries
  • messaging_pre_checkouts
  • messaging_customer_information
  • message_reads
  • message_echoes
  • 点击生成以获取API令牌并保存。
  • 如果返回此页面，您可以悬停鼠标在“订阅”上以获取“编辑”选项。
  • 目前，请不要继续执行 完成应用审核。

步骤 3：继续在 3CX 中进行配置

  1. 前往管理 > 用户并创建一个临时测试用户，该用户将用于下面的步骤4中的应用程序审核流程。
  2. 粘贴您在步骤2中获取的页面ID和访问令牌。
  3. 确保消息路由已配置为您的新临时测试用户。

步骤 4：开发模式

您的应用程序现已配置为可与3CX配合使用，您可以尝试向您的Facebook主页发送一条消息。

在此阶段，您的应用处于开发模式，意味着您只能与以下用户交互：

  • 有权管理您主页的用户
  • 已添加为测试人员的用户

您可以通过 应用仪表板 → 角色 → 应用角色 → 添加人员 来添加更多测试用户。

在开发模式下，3CX中只会显示Facebook用户的数字ID。要显示Facebook用户的全名，需要切换到“实时”模式。

要切换到“实时”模式，您需要请求额外权限并执行应用程序审核——详情请参见“步骤5：应用程序审核”。

步骤5：应用程序审核

  • 从 Meta 应用控制面板，转到应用设置 > 基本。

  • 请填写所需信息：
  • 隐私政策网址
  • 用户数据删除网址（可以是与隐私政策相同的URL）
  • 类别（选择“消息”或“业务”）
  • 上传应用图标
  • 根据您所在的地区和业务领域，您可能需要在核心设置下方填写 GDPR 部分。
  • 在页面底部选择 + 添加平台。
  • 输入您的网站URL并点击下一步。

  • 输入您的 3CX PBX URL，例如：https://mypbx.3cx-example.com。
  • 点击 保存更改。
  • 从侧边菜单中，点击用例（铅笔图标）
  • 点击“自定义”并添加业务资产用户资料访问权限。
  • 点击 Messenger API设置。
  • 点击 自定义用例。
  • 从权限和功能中添加业务资产用户资料访问权限。

  • 点击请求权限 按钮：

  • 选择选项 pages_show_list 和 pages_manage_metadata；点击 请求权限 按钮。这将带您进入 提交应用审核 页面。
  • 打开您的 3CX PBX 并以测试用户身份（或模拟测试用户）登录；转到网页客户端中的聊天。
  • 使用拥有该应用测试权限的账户打开您已连接的Facebook主页。
  • 将两个窗口并排放置，开始屏幕录制；这对于Facebook审核和验证是必需的。
  • 进行一次简短的消息聊天，并保存视频。
  • 返回Facebook 提交应用审核 页面，然后点击下一步。

  • 完成所有步骤，填写所有详细信息，直到进入 审核人员说明。您必须拥有已验证账户才能继续。

  • 在 审核人员说明 页面上：
  • 确认您的网站网址。
  • 请按如下方式填写问题框：
  • (instructions-web-2) 提供访问应用程序的说明，以便我们完成审核。

此Facebook应用用于将3CX电话系统 (https://3cx.com) 与Facebook Messenger聊天集成。每个3CX客户都有自己的3CX实例，因此需要创建自己的应用来集成Facebook主页。需要pages_messaging权限来接收和发送由Facebook主页访客发起的消息。

步骤 1. 使用以下凭据登录 3CX 网页客户端：

  • PBX 网页客户端网址：https://example-pbx.3cx.com/

步骤 2. 在 Facebook 页面上编写并发送一条测试消息。

步骤 3. 在您的 3CX 网页客户端中接收并回复消息。

  • (accesscode-web-1) 如果访问本应用的全部功能需要付费或会员资格：
  • 分机号： ________
  • 密码： ________
  • (documents-web-1) 包含支持文档：
  • 上传您之前录制的视频。
  • 点击下一步。
  • 所有部分完成后，即可提交审核。

可以通过侧边菜单上的“发布”按钮发布应用。如果您在获得批准之前发布，您可能会收到一般消息，但无法获取发件人姓名或其他详细信息。

一旦您的应用程序获得批准，您将收到来自Facebook用户的消息并显示发件

另请参阅

最后更新

本文档最后更新于2026年9月8日

https://www.3cx.cn/docs/manual/facebook/