配置 Facebook
介绍
Facebook集成使您的客服人员能够直接从3CX回复您的Facebook页面消息,而无需登录Facebook Messenger。消息可以传送到呼叫队列、响铃组或单个分机。坐席可以获得消息的所有权或将其转移给另一个坐席或组。
需要一个 已验证 的Facebook 企业帐户。
第 1 步:创建 Facebook 应用程序
- 导航至 https://developers.facebook.com 并点击右上角的“Log In” 。
- 导航至“My Apps”。
- 点击 “Create App”。
- 为您的应用程序指定一个显示名称,输入联系电子邮件,然后单击“Next”。
- 选择选项“Other“ 然后点击 “Next”。
- 选择 “Business”。
- 创建App前,请确保App名称和App联系邮箱正确,并使用下拉列表选择您的业务组合。点击“Create app”。
- 选择 “Messenger”进而 “Set up”。
- 下一个页面将让您将产品添加到您的应用程序中。向下滚动到“Messenger”并点击“Messenger API Settings”。
- 在 Messenger API 设置下,向下滚动到“生成访问令牌”部分并单击“ “Connect”。
- 点击“Continue as (username)” ,然后使用复选框选择您想要集成的页面。
- 点击“Next”并完成接下来的确认消息。
- 您现在将看到您的 Facebook 页面列在‘Access Tokens’部分中。
- 点击“Generate token”。在弹出框中,勾选 ‘I Understand’框并将令牌复制到文本中,单击 “Done”。
- 最后,将Page ID(显示在页面名称下方)复制到文本。
第 2 步: 在3CX中配置
- 登录您的3CX网页客户端导航至“管理员” > “语音和聊天”并点击“添加Facebook”。
- 将默认名称编辑为您喜欢的名称。
- 如果您是一个“系统所有者”或“系统管理员”,您可以使集成在整个系统范围内或仅在某个部门中生效。
- 粘贴您在第1步中获取的‘页面 ID’和‘访问令牌’。
- 将 3CX Webhook 复制到文本并单击“Save”。
- 转到“用户”并创建一个临时测试用户,该用户将用于下面第4步中的应用程序审核过程。
- 确保消息路由已配置给您的新临时测试用户。有关这方面的更多信息,请查看 呼叫处理手册。
第 3 步:配置您的 Webhook
- 导航回开发者门户的‘Meta’。
- 返回应用程序 > 选择并编辑您的应用程序 > Messenger API Settings > 配置 Webhooks > 单击配置。
- 将 3CX 生成的 Webhook 粘贴到‘Callback URL’部分。
- 要验证令牌,请输入随机的字母和数字字符串。不再需要此操作,因此无需保存字符串以供日后使用。点击“Verify and save”。
- 点击 “Add subscriptions”从 ‘Generate Access Tokens’ 部分并选择以下复选框:
- messages
- message_deliveries
- messaging_pre_checkouts
- messaging_customer_information
- message_reads
- message_echoes
- 最后,点击 “Save”。
您的应用程序现已配置为与 3CX 配合使用,您可以尝试向您的 Facebook 页面发送消息。在此阶段,您的应用程序处于‘Development’模式,这意味着您只能与有权管理您的页面的用户进行交互。要切换到‘Live’模式,您需要请求额外权限并执行应用程序审核 - 详情如下。
第 4 步:申请审核
- 在您的 Meta for Developers 门户中,转到“App Settings” > “Basic”。向下滚动到页面底部,然后单击“+ Add platform”。
- 选择“Website”并点击“Next”。
- 输入 3CX Web客户端的 URL(例如 https://exampledomain.com/)并单击“Save changes”。
- 导航至 “App Review” > “Permissions and Features”。
- 搜索 ‘pages_messaging’ 并点击 “Request advanced access”。
注意:在此阶段,您可能需要在开发模式下发送或接收测试信息后等待长达24小时才能使用按钮。
- 现在搜索 ‘Business Asset User Profile Access’,然后再次单击“Request advanced access”。单击现已更改为 “Edit App review request”的按钮。
注意:要继续操作,请提交业务验证。
- 点击蓝色箭头填写“Data handling questions”表单并提交。(此部分将在提交“业务验证”后显示)。
- 点击蓝色箭头填写“App Settings”表单,添加应用图标图片、隐私政策网址,并使用下拉框选择“消息传递”应用类别。点击“保存”。(此部分将在提交“数据处理问题”后显示)。
- 点击蓝色箭头填写“Reviewer instructions”部分,使用您在第 2 步结束时创建的临时测试用户凭据编辑以下文本,并将其粘贴到第一个必填字段中(其余字段可以留空)。
Step 1. Log in to the 3CX WebClient with the following credentials:
- PBX Web client URL: https://exampledomain:5001/webclient
- Extension: ________
- Password: ________
Step 2. Write and send a test message on the Facebook Page.
Step 3. Receive and reply to the message in your 3CX Web Client.
- 接下来,点击下一部分“此应用将如何使用 pages_messaging?”中的蓝色箭头。
- 将以下文本复制并粘贴到第一个“详细描述”框中。
This Facebook App is used to integrate 3CX Phone System (https://3cx.com) with Facebook Messenger chats. Each 3CX customer has their own 3CX instance and therefore will need to create their own App to integrate a Facebook Page. “pages_messaging” is required to receive and send messages started by a Facebook Page visitor.
- 在“测试并重现集成功能”下,使用下拉框选择您的 Facebook 主页。现在,使用您在步骤 2 结束时创建的临时测试用户的凭据编辑以下文本。
Step 1. Log in to the 3CX WebClient with the following credentials:
- PBX Web client URL: https://exampledomain:5001/webclient
- Extension: ________
- Password: ________
Step 2. Write and send a test message on the Facebook Page.
Step 3. Receive and reply to the message in your 3CX Web Client.
- 现在,您必须录制一段屏幕录像,展示一条消息发送到您的 Facebook 主页、Web 客户端接收并回复的过程。市面上有许多免费的屏幕录制工具,包括 Loom 和 Screenrec。
- 录制完成后,点击“Upload file”并选择您的截屏视频。
- 勾选确认框,然后点击“Save”。
- 现在,点击“此应用将如何使用业务资产用户配置文件访问权限?”部分中的蓝色箭头。
- 将以下文本复制并粘贴到详细描述框中。
This Facebook App is used to integrate 3CX Phone System (https://3cx.com) with Facebook Messenger chats. Each 3CX customer has their own 3CX instance and will create their own App to integrate their Facebook Page. 3CX needs “Business Asset User Profile Access” because it exposes the user's name and picture for identification of chat users by agents. 3CX is using the name and picture attributes.
- 上传您之前录制的相同截屏视频,勾选确认框并单击“Save”。
- 点击“Submit for Review”,输入您的 Facebook 密码进行验证,您将看到成功提交的确认信息。
- 最后,使用屏幕顶部的切换按钮,将“应用模式”从“开发”更改为“上线”。
申请获批后,您将收到来自 Facebook 用户的消息。请务必删除为应用验证流程创建的临时测试用户,并将消息路由更新到所需的目标地址。
另请参阅
最后更新
本文件最后更新于2025年6月24日


