網絡附加程式參考資料

Messenger 平台提供了一組方便易用的網絡附加程式，以便您與網站訪客展開對話。所有附加程式都是使用 Facebook JavaScript SDK 執行。

內容

顧客洽談附加程式
「傳送訊息給我們」附加程式
「傳送至 Messenger」附加程式
選框附加程式

顧客洽談附加程式（測試版）

Messenger 平台的顧客洽談附加程式讓您可以直接在網站中加入 Messenger Bot。這樣，您的顧客便可隨時與您的企業互動，同時獲得與 Messenger 上相同的個人化多媒體體驗。

若要進一步了解使用詳情，請參閱顧客洽談附加程式。

加入格式

<div class="fb-customerchat"
 page_id="<PAGE_ID>">
</div>

屬性

屬性	類型	說明
`class`	字串	值必須為 `fb-customerchat`。
`page_id`	字串	專頁編號
`ref`	字串	*此為選用項目。*傳遞到 `messaging_postbacks` 和 `messaging_referrals` 事件中的 Webhook 的自訂字串。
`theme_color`	字串	*此為選用項目。*用作附加程式主題的顏色，包括顧客洽談附加程式圖示的背景顏色，以及由用戶傳送的所有訊息之背景顏色。支援任何以數字符號開頭的十六進制顏色代碼（如 #0084FF），白色除外。我們極力建議您選擇與白色呈極大對比的顏色。
`logged_in_greeting`	字串	*此為選用項目。*在用戶已登入 Facebook 的狀態下顯示的打招呼。最多 80 個字元。
`logged_out_greeting`	字串	*此為選用項目。*在用戶未登入 Facebook 的狀態下顯示的打招呼文字。最多 80 個字元。
`greeting_dialog_display`	字串	*此為選用項目。*設定打招呼對話框的顯示方式。我們支援的值如下： `show`：打招呼對話框一律會在附加程式載入時顯示。 `fade`：附加程式的打招呼對話框會在顯示後淡出，然後一直保持隱藏狀態。 `hide`：除非用戶點擊附加程式，否則附加程式的打招呼對話框會一直處於隱藏狀態。桌面版預設為 `show`，流動版預設為 `hide`。
`greeting_dialog_delay`	字串	*此為選用項目。*設定附加程式載入後、打招呼對話框顯示前的延遲秒數。這可讓您自訂您想打招呼對話框出現的時機。
`minimized`	布林值	停用通知這個屬性現已停用。請改用 `greeting_dialog_display` 以自訂您的附加程式。`greeting_dialog_delay` 屬性將優先於 `minimized` 屬性。 *此為選用項目。* `true`：設定為 true 時，效果與設定 greeting_dialog_delay = "fade" 相同。 `false`：設定為 false 時，效果與設定 greeting_dialog_delay = "show" 相同。

「傳送訊息給我們」附加程式

直接將用戶帶入 Messenger 對話當中。

若要進一步了解使用詳情，請參閱「傳送訊息給我們」附加程式。

加入格式

<div class="fb-messengermessageus" 
  messenger_app_id="<APP_ID>" 
  page_id="<PAGE_ID>"
  color="<blue | white>"
  size="<standard | large | xlarge>">
</div>

屬性

屬性	HTML5 屬性	類型	說明
`class`		字串	值必須為 `fb-messengermessageus`。
`page_id`		字串	專頁編號
`messenger_app_id`		數字	您的 Facebook 應用程式編號。
`color`	`data-color`	字串	按鈕顏色：`blue` 或 `white`。預設為 `blue`。
`size`	`data-size`	字串	按鈕大小：`standard`、`large` 或 `xlarge`。預設為 `large`。
`ref`		字串	*此為選用項目。*傳遞到 `messaging_postbacks` 和 `messaging_referrals` 事件中的 Webhook 的自訂字串。

「傳送至 Messenger」附加程式

在背景從您的 Messenger Bot 傳送訊息給用戶，並將他們納為用戶。

若要進一步了解使用詳情，請參閱「傳送至 Messenger」附加程式。

加入格式

<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>

屬性

屬性	類型	說明
`class`	字串	值必須為 `fb-send-to-messenger`。
`page_id`	字串	專頁編號
`messenger_app_id`	數字	您的 Facebook 應用程式編號。
`color`	字串	*此為選用項目。*按鈕顏色：`blue` 或 `white`。預設為 `blue`。
`size`	字串	*此為選用項目。*按鈕大小：`standard`、`large` 或 `xlarge`。預設為 `large`。
`ref`	字串	*此為選用項目。*自訂狀態參數。最多可輸入 250 個字元。有效字元為 `a-z A-Z 0-9 +/=-._` 基於安全目的，您應該將參數編碼及加密。
`enforce_login`	布林值	*此為選用項目。*若為 `true`，已登入的用戶在點擊按鈕後必須再次登入。預設為 `false`。

使用 ref 參數以連同驗證一併傳遞狀態。如果您選擇在多處展示附加程式，您可以考慮根據附加程式顯示的位置來修改狀態。

選框附加程式

選框附加程式可在結帳或註冊等所用的表格中，為用戶訂閱您的 Messenger Bot。

若要進一步了解使用詳情，請參閱選框附加程式。

加入格式

<div class="fb-messenger-checkbox"  
  origin=<PAGE_DOMAIN>
  page_id=<PAGE_ID>
  messenger_app_id=<APP_ID>
  user_ref="<UNIQUE_REF_PARAM>"
  allow_login="<true>"
  size="<small | medium | large | standard | xlarge>"
  skin="<light|dark>"
  center_align="<true|false>">
</div>

屬性

屬性	類型	說明
`class`	字串	值必須為 `fb-messenger-checkbox`
`page_id`	數字	與您 Bot 相關的 Facebook 專頁編號。
`messenger_app_id`	數字	您的 Facebook 應用程式編號。
`user_ref`	字串	對照特定用戶的不重複參數。最多可輸入 250 個字元。有效字元為 `a-z A-Z 0-9 +/=-._`
`allow_login`	布林值	*此為選用項目。*在沒有現有連線階段時讓用戶登入。預設為 `true`。
`size`	字串	*此為選用項目。*附加程式大小：`small`、`medium`、`large`、`standard` 或 `xlarge`。預設為 `large`。
`skin`	字串	*此為選用項目。*設定附加程式內容的顏色主題。支援的選項如下： `light`：附加程式會以深色文字顯示。 `dark`：附加程式會以白色文字、透明 Messenger 圖示和白色閃電圖示顯示。預設為 `light`。
`center_align`	布林值	*此為選用項目。*設定附加程式內容應否置中對齊。預設為 `false`。

網絡附加程式參考資料

內容

顧客洽談附加程式（測試版）

加入格式

屬性

停用通知

「傳送訊息給我們」附加程式

加入格式

屬性

「傳送至 Messenger」附加程式

加入格式

屬性

選框附加程式

加入格式

屬性