README

注意：此Craft插件已不再维护。

2024年5月9日，Facebook已停止其聊天插件的使用，您将无法再访问任何聊天插件的功能。

@see: https://developers.facebook.com/docs/messenger-platform/discovery/facebook-chat-plugin

我们建议使用Intercom Messenger代替。

让人们在您的网站上开始对话，并在Messenger中继续。允许您的客户在需要时，以与在Messenger中相同的个性化、丰富媒体体验与您的业务互动。

概述

此插件允许您通过在Craft网站上集成它来使用Messenger与您的客户互动。

要查看并回复这些消息，只需使用您用于Facebook消息的相同消息工具即可，在桌面上的facebook.com、Facebook页面管理器应用（可在iOS和Android上使用）或通过将您的页面帐户添加到Messenger中。

有关更多关于Facebook Messenger客户聊天的信息，请点击这里。

关键功能

• 无断开连接：使用此插件在您和您的客户之间在Messenger中创建一个长期线程。客户可以在您的网站上开始聊天，并在他们的移动设备上使用Messenger应用继续。
• 聊天记录将自动创建在客户的Messenger帐户中。
• Messenger熟悉、现代的界面可以建立信任，并鼓励您的客户与您互动。
• 您可以使用与在桌面和移动设备上管理您的Facebook页面消息相同的收件箱。
• 您可以为在您不在时服务客户设置可用时间、自动回复和常见问题解答。

要求

此插件需要Craft CMS 4.0.0或更高版本。

为了使用Messenger客户聊天插件，您需要有一个发布的Facebook页面。您可以通过以下链接找到您所有的Facebook页面。如果您没有Facebook页面，您可以在这里免费创建一个。

安装

从插件商店

转到项目控制面板中的插件商店，搜索“Messenger客户聊天”。然后单击“安装”按钮。

使用Composer

# Go to project directory
cd /path/to/my/craft-project

# Tell Composer to load the plugin
composer require jimstrike/craft-facebook-messenger-customer-chat

# Tell Craft to install the plugin
php craft plugin/install fbmcc

配置Messenger客户聊天插件

安装插件后，转到控制面板中的设置→客户聊天或控制面板→设置→Messenger客户聊天。在自定义和启用插件之前，请先阅读“入门”部分。

白名单您的域名

在启用和使用“Messenger客户聊天”之前，您必须在您的Facebook页面上有一个页面，并且需要在Facebook页面设置中白名单您的域名。

页面管理员执行以下操作

• 登录到Facebook（如果您尚未登录）。
• 前往 facebook.com/bookmarks/pages 列出您的页面。
• 前往您的页面。
• 在“管理页面”下点击左侧的 设置。
• 在“页面设置”下点击左侧的 高级消息。
• 在 白名单域名 部分下添加您的域名并点击保存。

查找您的Facebook页面ID

页面管理员执行以下操作

• 登录到Facebook（如果您尚未登录）。
• 前往 facebook.com/bookmarks/pages 列出您的页面。
• 前往您的页面。
• 在“管理页面”下点击左侧的 设置。
• 在“页面设置”下点击左侧的 消息。
• 滚动到 您的消息URL 部分。
• 您将找到类似这样的消息链接：m.me/543210123456789。URL中 m.me/ 后面的数字部分是您的Facebook页面ID。

如果 m.me/ 后面的URL部分不是数字，请尝试以下方法

• 前往您Facebook页面的首页。
• 在屏幕上的任何位置右键点击，然后选择“查看页面源代码”。
• 在页面源代码中搜索（Ctrl/Cmd + F）page_id。
• page_id= 后面的数字部分是您的Facebook页面ID。

允许人们以访客身份聊天

页面管理员执行以下操作

• 登录到Facebook（如果您尚未登录）。
• 前往 facebook.com/bookmarks/pages 列出您的页面。
• 前往您的页面。
• 在“管理页面”下点击左侧的 设置。
• 在“页面设置”下点击左侧的 消息。
• 滚动到 将消息添加到您的网站 部分，然后点击 开始。
• 将弹出一个模态窗口。
• 在 访客聊天 下切换 访客聊天 的开/关。
• 点击 下一步 直到完成并关闭模态窗口。

在您的网站上使用 "消息客户聊天"

前往 "消息客户聊天" 网站设置，提供您的Facebook页面ID和/或从 "Facebook页面 → 设置 → 消息 → 将消息添加到您的网站" 复制的代码片段，然后保存。预览它并调整其设置，直到您满意。启用它。

高级配置

为Craft开发者

覆盖设置

将插件的 src/config.php 复制到您的项目 config 文件夹中，作为 fbmcc.php，并在那里进行更改以覆盖默认设置。

在twig模板中打印SDK片段

{##
 # @param int|null siteId (defaults to current site ID)
 # @param string locale (defaults to plugin´s chat dialog locale setting)
 #
 # @return string (Facebook Messenger Customer Chat html snippet)
 #}
fbmcc_sdk_snippet(int siteId = null, string locale = '')
craft.fbmcc.sdkSnippet(int siteId = null, string locale = '')

注意：片段只有在插件在客户聊天 → 网站设置或 config/fbmcc.php 文件中禁用时才会打印。

检查是否在twig模板中启用

{##
 # @param int|null siteId (defaults to current site ID)
 #
 # @return bool
 #}
fbmcc_is_enabled(int siteId = null)
craft.fbmcc.isEnabled(int siteId = null)

注意：它只会检查 "营业时间"。不会检查 "启用" 或 "部分"，因为您控制着您的twig模板。

Twig示例

{{ fbmcc_sdk_snippet()|raw }}
{{ fbmcc_sdk_snippet(currentSite.id, 'en_GB')|raw }}

{# or #}

{{ craft.fbmcc.sdkSnippet()|raw }}
{{ craft.fbmcc.sdkSnippet(currentSite.id, 'en_GB')|raw }}

{# check if enabled first #}

{% if fbmcc_is_enabled() %}
    {{ fbmcc_sdk_snippet()|raw }}
{% endif %}

{# or #}

{% if craft.fbmcc.isEnabled(currentSite.id) %}
    {{ craft.fbmcc.sdkSnippet(currentSite.id, 'de_DE')|raw }}
{% endif %}

注意：以上示例中的片段只有在插件在客户聊天 → 网站设置或 config/fbmcc.php 文件中禁用时才会打印。否则，将在页面源代码中打印一个html注释，说明SDK片段已启动。

常见问题解答

在哪里可以找到更多关于消息客户聊天的信息？

您可以在 消息客户聊天页面 找到更多信息。

在设置我的网站上的消息客户聊天之前，我需要什么？

您需要有一个已发布的Facebook页面、其页面ID，并在电脑或设备上登录Facebook。

插件是如何工作的？

插件是一段在您的Craft网站上运行的JavaScript代码。将有一个小的消息聊天气泡在网站的右下角加载。您的客户可以随时点击它并给您发消息。它在移动设备和台式机上都可以工作。您可以在Facebook开发者文档的 消息客户聊天页面 上找到更多信息。

我可以在哪里看到所有我的消息？

在电脑上，您可以在页面收件箱中看到所有消息。前往Facebook上的您的页面，点击顶部的“收件箱”。在手机上，您可以下载Facebook Pages Manager应用并导航到收件箱。您还可以将页面账户链接到您的Messenger应用，在那里查看所有消息。

要启用聊天功能，我需要在页面上设置哪些权限？

您需要是该页面的管理员。

我能看到Facebook页面的消息分析吗？

在电脑上，前往您的Facebook页面，点击导航栏上的“洞察”。在左侧，点击“消息”以查看您的消息分析。

为什么一些用户在点击“立即聊天”后看到额外的确认窗口？

出于安全考虑，"继续作为"弹出窗口会偶尔显示。大多数已登录用户只需点击插件本身即可选择加入，无需重新确认。另外，随着更多用户通过插件给您发送消息，"继续作为"弹出窗口将显示得更少。

故障排除提示

如果您在插件正确渲染方面遇到困难，请尝试以下提示

• 如果您看到控制台错误，例如"拒绝在框架中显示 ，因为祖先违反以下内容安全策略指令："，请检查插件渲染的页面域是否已被列入白名单，并且您的Facebook页面ID是否正确输入。另外，请确保您没有将Referrer-Policy头设置为no-referrer。

• Firefox Facebook Container扩展阻止插件显示。如果您想显示插件，请移除此扩展。

• Firefox桌面私有浏览器（版本63及以上）和Firefox移动浏览器默认阻止内容跟踪，这将阻止插件渲染。关闭内容阻止（点击搜索栏中的灰色盾牌）以查看插件渲染。

• DuckDuckGo隐私基础扩展将阻止插件显示。如果您想显示插件，请移除扩展或关闭站点隐私保护。

Craft 3

要使用此插件与Craft 3配合使用，您需要从最新v1.*标签版本安装它。 查看所有标签。

# Go to project directory
cd /path/to/my/craft-project

# Tell Composer to load the plugin
composer require jimstrike/craft-facebook-messenger-customer-chat:1.1.3

# Tell Craft to install the plugin
php craft plugin/install fbmcc