“发送到 Messenger”插件

此功能将于 2024 年 9 月 30 日开始停用。您可以继续使用 m.me 链接等功能，将用户重定向到 Messenger 中的用户、公共主页或对话。

如果 Facebook 应用处于开发模式，则只有拥有有效会话的应用管理员、开发者和测试者能够使用插件和 API 功能。待应用通过审核并转为公开模式后，公众才可使用这些插件与 API 功能。

“发送到 Messenger”插件用于触发针对 Webhooks 的身份验证事件。您可以传入数据，以便了解哪位用户和哪笔交易与身份验证事件相关联，并在后台绑定该用户。

用户首次点击此按钮时，系统会弹出确认窗口。

要求

JavaScript 版 Facebook SDK

如要使用“发送到 Messenger”插件，您必须在要显示该插件的网页中添加 Javascript 版 Facebook SDK。

如需获取添加 SDK 的说明，请参阅 Javascript 版 Facebook SDK 快速入门指南。

设置

<div class="fb-send-to-messenger" 
  messenger_app_id="<APP_ID>" 
  page_id="PAGE_ID" 
  data-ref="<PASS_THROUGH_PARAM>" 
  color="<blue | white>" 
  size="<standard | large | xlarge>">
</div>

如需获取完整的可用属性描述，请参阅“发送到 Messenger”插件参考文档。

事件订阅

订阅插件事件。

<script>

      FB.Event.subscribe('send_to_messenger', function(e) {
      // callback for events triggered by the plugin

      });

      </script>

事件字段

字段名称	类型	描述
`event`	枚举	事件名称。可行值：`rendered`、`clicked`、`not_you`、`opt_in`。
`ref`	字符串	包含插件上 `data-ref` 参数中设置的值。仅支持使用字母数字字符以及 -、_ 和 =。
`is_after_optin`	布尔值	表示事件是否发生在用户确认确认弹窗之后。
`pluginID`	未定义	未使用此字段。

Webhooks 事件

“发送到 Messenger”插件会触发 messaging_optins Webhooks 事件。

自定义登录行为

如果没有已登录的 Facebook 用户，则此插件出现时不会显示用户身份。点击该按钮将会提示用户进行登录。

如果将 allow_login 设置为 false，系统便不会向未登录的用户显示此插件。

请注意，该插件仅会在应用通过审核并公开上线后，才会在没有 Facebook 会话的情况下显示。

行动号召按钮文本选项

“发送到 Messenger”插件还支持 cta_text 属性。这可以方便您从预定义的字符串列表中为插件选择按钮文本。使用 cta_text 属性时，大部分登录的用户只需点击插件按钮本身即可订阅，而无需通过弹窗再次确认，并且系统会立即传递 messaging_optins 事件。

cta_text 属性支持下列值：

GET_THIS_IN_MESSENGER
RECEIVE_THIS_IN_MESSENGER
SEND_THIS_TO_ME
GET_CUSTOMER_ASSISTANCE
GET_CUSTOMER_SERVICE
GET_SUPPORT
LET_US_CHAT
SEND_ME_MESSAGES
ALERT_ME_IN_MESSENGER
SEND_ME_UPDATES
MESSAGE_ME
LET_ME_KNOW
KEEP_ME_UPDATED
TELL_ME_MORE
SUBSCRIBE_IN_MESSENGER
SUBSCRIBE_TO_UPDATES
GET_MESSAGES
SUBSCRIBE
GET_STARTED_IN_MESSENGER
LEARN_MORE_IN_MESSENGER
GET_STARTED