「傳送到 Messenger」外掛程式

自 2024 年 9 月 30 日起，此功能將無法再使用。你可以繼續使用 m.me 連結等功能，將用戶重新導向至 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