網頁外掛程式參考資料

Messenger 開放平台提供您一系列便利的網頁外掛程式，讓您輕鬆與造訪您網頁的用戶展開對話。所有外掛程式均透過 Facebook Javascript SDK 實作。

顧客洽談外掛程式（測試版）

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

使用 data-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」外掛程式

加入格式

屬性

核取方塊外掛程式

加入格式

屬性