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