「傳送到 Messenger」外掛程式

當您的 Facebook 應用程式處於開發模式，僅應用程式的管理員、開發人員及測試員，在有效的連線階段時，才可使用外掛程式和 API 功能。應用程式獲得核准並公開之後，一般大眾便可使用。

「傳送到 Messenger」外掛程式是用於向您的 Webhook 觸發驗證事件。您可以傳入資料，瞭解與驗證事件相關的用戶和交易，並且在後端連結這位用戶。

用戶首次點擊此按鈕時，將會顯示確認彈出視窗。

需求

Facebook JavaScript SDK

若要使用「傳送到 Messenger」外掛程式，您必須將 Facebook JavaScript SDK 包括在要顯示該外掛程式的頁面內。

如需有關將該 SDK 包括在內的指示，請參閱 Facebook JavaScript 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`	未定義	未使用此欄位。

Webhook 事件

「傳送到 Messenger」外掛程式會觸發 messaging_optins Webhook 事件。

自訂登入行為

若沒有已登入的 Facebook 用戶，會在不顯示用戶身分的情況下轉譯外掛程式。點擊按鈕會提示用戶登入。

若將 allow_login 設為 False，則不會針對未登入的用戶轉譯外掛程式。

請注意，應用程式必須申請獲准且為公開應用程式，才會在非 Facebook 連線階段轉譯外掛程式。

CTA 文字選項

「傳送到 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