ChatHub/docs

搜索文档

为你推荐200 条结果

在已发布文章中搜索 · 按小节

移动打开esc关闭ChatHub docs
渠道与收件箱创建 Facebook 应用并将主页接入 ChatHub
配置指南管理员指南

创建 Facebook 应用并将主页接入 ChatHub

创建正确类型的 Meta 应用、连接 Facebook 主页、获取 App ID、应用密钥和管理员令牌，然后填入 ChatHub 以接收 Messenger 消息。

ChatHub Team·阅读约 14 分钟

本文解决什么问题#

要让 ChatHub 接收并回复某个 Facebook 主页的 Messenger 消息，您需要自己的 Meta 应用。ChatHub 不使用共享应用：每套系统各自申报自己的应用，因此无需等待 Meta 审核，一个主页出问题也不会牵连其他系统。

应用只需为整个系统配置一次，之后想加多少主页都可以。应用密钥属于应用，因此可以共用；每个主页各自的令牌由 ChatHub 向 Meta 获取，您无需手工收集。

您需要拥有目标 Facebook 主页的管理员权限，以及打开设置页面所需的 ChatHub 管理员权限。

1. 在 Meta for Developers 创建应用#

  1. 1

    打开 developers.facebook.com，使用管理该主页的 Facebook 账号登录。

  2. 2

    进入「我的应用」，点击「创建应用」。

  3. 3

    在「应用详情」步骤，用您的品牌名称命名应用。用户授权时会看到这个名称，请勿使用测试名称。

  4. 4

    核对联系邮箱：Meta 会把违规警告和政策通知发到这个地址。

创建流程第 1 步。名称字段填的是示例数据且尚未点击「下一步」；图中联系邮箱已被遮挡。界面语言为越南语。

2. 选择 Messenger 使用场景#

这一步决定了后面的一切。Meta 依据创建时申报的使用场景来授予权限，为其他用途创建的应用之后无法再加入 Messenger。

  1. 1

    在「使用场景」步骤，左栏按「商务消息」分组筛选。

  2. 2

    勾选「通过 Meta 的 Messenger 与客户互动」，然后点击「下一步」。

  3. 3

    如果「商务」步骤列表为空可以跳过，之后再关联商务组合也可以。

  4. 4

    在「概览」步骤确认后点击「创建应用」。创建前 Meta 会要求再次输入 Facebook 密码。

先在左侧选择「商务消息」分组，再勾选 Messenger 那一行的复选框。界面语言为越南语。
如果打开旧应用后在「添加使用场景」里找不到「商务消息」分组，说明该应用无法加入 Messenger。Meta 在对话框中已经写明：请创建新应用。不必再花时间寻找开启方法。

3. 获取 App ID 和应用密钥#

  1. 1

    在新应用中打开「应用设置」并选择「基本」。

  2. 2

    复制 App ID。这是公开值，不是机密。

  3. 3

    在「应用密钥」旁点击「显示」并复制。Meta 会再次要求输入密码。

App ID 在左侧，应用密钥在右侧并隐藏在「显示」按钮后。图中联系邮箱已被遮挡。界面语言为越南语。
应用密钥可以让人伪造发往您系统的消息。不要通过聊天发送、不要存入共享文档、不要提交到代码库。一旦泄露，请在同一界面重新生成。

4. 将 Facebook 主页连接到应用#

主页必须先连接到应用，ChatHub 才能看到它，该主页的 webhook 才会送达。

  1. 1

    在应用中打开「使用场景」，点击 Messenger 那一行的「自定义」。

  2. 2

    在左栏选择「Messenger API 设置」。

  3. 3

    滚动到「生成访问令牌」，点击「连接」；若列表中已有主页则点击「添加主页」。

  4. 4

    在弹出的窗口中登录 Facebook，选择要使用的主页并确认授权。

连接后每个主页占一行，显示主页 ID、用于 webhook 的「添加订阅」按钮和用于令牌的「生成」按钮。图片中的主页名称和 UID 已模糊处理。界面语言为越南语。

5. 获取管理员访问令牌#

ChatHub 只用这个令牌做一件事：向 Meta 查询您管理哪些主页，并获取每个主页各自的令牌。用这种方式取得的主页令牌不会过期，因此之后管理员令牌过期也不会导致任何在用渠道掉线。

  1. 1

    打开「工具」并选择「图谱 API 探索工具」；在 Meta 应用选择框中选中刚创建的应用。

  2. 2

    在「权限」中添加三项：pages_show_list、pages_messaging 和 pages_manage_metadata。

  3. 3

    点击 Generate Access Token，为主页确认授权，然后复制生成的令牌。

三个必需权限显示在「权限」下方。图中访问令牌框已被遮挡，因为它是真实值。界面语言为越南语。
如果权限列表里没有 pages 分组，请检查上方的应用选择框：几乎可以肯定当前选的是没有申报 Messenger 的旧应用。

6. 在 ChatHub 中填写应用信息#

  1. 1

    在 ChatHub 中打开「设置」并选择「渠道」分组。

  2. 2

    找到「Facebook 应用」卡片，填入 App ID、应用密钥和管理员令牌。

  3. 3

    点击「保存」。卡片角标会变为「已配置」。

  4. 4

    三个字段下方就是「向 Meta 注册 webhook」，其中已备好回调地址和验证令牌，各带一个「复制」按钮。这两个值由整个系统共用，因此不放在单个渠道里。

「设置 → 渠道」中的 Facebook 应用卡片。截图时只填了 App ID 且尚未保存，两个机密字段为空。界面语言为越南语，深色主题。
应用密钥和令牌在保存前会加密，且不会再显示出来。下次保存时留空表示保留原值。

7. 把主页添加为渠道并注册 webhook#

  1. 1

    在「设置 → 渠道」的「向 Meta 注册 webhook」中复制回调地址和验证令牌。

  2. 2

    进入应用的「Messenger API 设置」，把两个值分别粘贴到「回调地址」和「验证令牌」，然后点击「验证并保存」。这一步整个应用只需做一次。

  3. 3

    在刚保存的字段下方的「Webhook 字段」表格中，为 messages、messaging_postbacks 和 message_echoes 三个字段打开「订阅」开关。漏掉这一步，即使其他一切都是绿色的，Meta 也不会推送任何消息。

  4. 4

    回到 ChatHub，打开「渠道」页面，点击「添加账号」并选择 Facebook 类型。

  5. 5

    您管理的主页会直接列出；选择一个后点击「创建账号」。

  6. 6

    在新渠道上点击「连接」。添加第二个主页只需重复最后两步，无需再次注册 webhook。

Meta 的五项配置集中在同一区域；下方列出每个主页需要启用的 messages、messaging_postbacks 和 message_echoes 三个 webhook 字段。真实的验证令牌已被完全遮挡。界面语言为越南语，浅色主题。
两个字段位于第 1 节「配置 webhook」。截图时为空且未保存。界面语言为越南语。
需要在 Webhook 字段表格中打开的三个开关：message_echoes、messages 和 messaging_postbacks 变为蓝色的已订阅，其余字段保持未订阅。界面语言为越南语。
Meta 只能通过公网 HTTPS 调用 webhook。部署在内网域名或 localhost 的系统可以连接成功，却永远收不到消息；请先把地址指向公网可访问的域名。

查看其他渠道类型的添加指南 ↗

8. 填写隐私政策网址并将应用切换为上线模式#

完成上面七步后，ChatHub 与 Meta 已经正确连通，但新建的应用始终处于开发模式。在该模式下，Meta 只会为拥有应用角色的人发送 webhook：用管理员账号自测时消息正常到达，真实客户发给主页却不会产生任何事件——渠道仍显示已连接，收件箱却始终是空的。

  1. 1

    在 ChatHub 中进入设置 → 渠道，向下找到「向 Meta 注册 webhook」，点击隐私政策网址一行的复制。该页面由 ChatHub 自行提供，地址为系统的 /privacy，无需登录即可打开，Meta 的抓取程序能够读取。

  2. 2

    打开 Meta 应用的应用设置 → 基本，将刚复制的地址粘贴到隐私政策网址一栏，然后点击保存更改。该栏为空时，Meta 会禁用「发布」按钮。

  3. 3

    在应用左侧菜单中打开「发布」，检查各个使用场景，然后点击右下角的「发布」。发布成功后，该菜单项会显示「已发布」；之后不要点击「取消发布」。

  4. 4

    打开应用审核 → 权限和功能，确认 pages_messaging 处于高级访问权限。若仍为标准访问权限，请为拥有该应用的商务管理资产完成商家验证，或提交该权限的审核申请。

  5. 5

    请一位在应用中没有任何角色的账号向主页发消息。消息应在几秒内出现在 ChatHub 收件箱中。

请把隐私政策地址粘贴到此输入框。图中使用示例值 https://ten-mien-cua-ban.example/privacy，且尚未点击保存更改；联系邮箱和应用密钥均已完全遮挡。界面语言为越南语。
打开左侧菜单中的「发布」，检查各个使用场景，然后点击右下角的「发布」。「已发布」标记表示应用已经上线；请勿点击「取消发布」。截图为发布后的状态，界面语言为越南语。
如果贵公司已有自己的隐私政策页面，填写该地址同样可以；ChatHub 中的这一行只是让你不必另行搭建页面。
判断应用是否仍卡在开发模式的两个迹象：客户发来消息，但服务器日志中没有任何 webhook 调用记录；向陌生客户发送消息时 Meta 返回 551 错误。此时不必去改 Callback URL 或验证令牌——它们并没有问题。

需要事先了解的限制#

Messenger 只允许在客户最后一条消息后的 24 小时内自由回复。超时后 Facebook 会拒绝发出的消息，直到客户再次来信。ChatHub 会在输入框上方提示窗口即将结束和已经结束；内部备注仍可正常保存。

平台还有几项限制：Messenger 发出的消息不支持引用回复，不能发送任意贴纸，按钮必须依附于带文字的消息，因此不带说明文字的纯文件没有位置承载按钮。

处于开发模式的应用只对拥有该应用角色的人生效——收发双向都是：来自外部账号的消息不会产生任何 webhook，因此测试时请使用管理员账号，或在「应用角色」中添加测试用户。要服务真实客户，请按上面的第 8 步操作。
创建 Facebook 应用并将主页接入 ChatHub回到顶部
© 2026 ChatHub DocsPowered by CMSNT LTDChatHub 使用文档。