Meta 的 Messenger

使用 Meta Messenger 整合功能，即可建立 Meta Messenger 機器人，與使用者互動。

運作方式

整合功能的運作方式如下：

您建立使用 Meta Messenger Platform 的 Meta 應用程式。
設定 Dialogflow CX 整合和 Meta 應用程式，讓兩者互相通訊。
Dialogflow CX 整合功能會使用 Meta Messenger API 傳送訊息給使用者。
Dialogflow CX 整合功能會做為 Messenger 平台的 Meta Webhook，接收使用者訊息。

設定

測試整合前，請確認專案已啟用計費功能。

如要設定整合功能，請按照下列步驟操作：

請按照這篇文章的步驟建立 Meta 應用程式。
設定 Meta 應用程式，以便使用 Meta Messenger Platform。請按照 Meta Webhooks for Messenger Platform 說明文件中的步驟，完成下列操作：
- 將 Messenger 平台新增至 Meta 應用程式。
- 將應用程式訂閱至 Meta 粉絲專頁。請確認頁面訂閱項目已啟用 messages 和 messaging_postbacks。
- 複製這個步驟提供的存取權杖。這個權杖用於從 Dialogflow CX 控制台設定整合。
- 請勿設定 Webhook 或測試整合功能。
在 Dialogflow CX 控制台中設定整合：
1. 前往 Dialogflow CX 控制台。
2. 選取導覽選單中的「管理」分頁標籤。
3. 選取「整合」。
4. 按一下「Meta Messenger」圖塊上的「連結」按鈕。
5. 填寫設定對話方塊欄位：
  - 應用程式密鑰：輸入應用程式資訊主頁基本設定中的應用程式密鑰。
  - 驗證權杖：輸入所需的私人權杖。複製這個值。用於設定 Meta Messenger Webhook。
  - 粉絲專頁存取權杖：輸入您在 Meta 應用程式設定期間複製的存取權杖。
  - 啟用「開始使用」按鈕：勾選這個核取方塊，即可啟用「開始使用」按鈕。
  - Webhook 網址：複製這個值。用於設定 Meta Messenger Webhook。
  - Start：勾選這個核取方塊，即可啟動代理的整合服務。
完成 Meta 應用程式設定並進行測試。請按照 Meta Webhooks for Messenger Platform 說明文件中的步驟，完成下列操作：
- 為應用程式設定 Meta Webhook。使用先前複製的「Webhook 網址」和「驗證權杖」值。請務必在頁面訂閱中啟用 messages 和 messaging_postbacks。
- 測試應用程式。

活動

這項整合功能會叫用下列事件。您可以建立自訂事件處理常式，定義事件觸發時要執行的動作。

事件	說明
`FACEBOOK_WELCOME`	使用者點選 Meta Messenger 的「開始使用」按鈕時觸發。
`FACEBOOK_MEDIA`	當使用者傳送的訊息含有附件 (例如音訊、圖片或影片) 時，就會觸發這個事件。

「開始」按鈕

設定 Meta Messenger「開始使用」按鈕：

啟用這項整合服務時，請切換「啟用『開始使用』按鈕」。

這項整合服務可讓您呼叫 Messenger Profile API 來啟用按鈕。

curl -X POST \
-H "Content-Type: application/json" \
-d '{"get_started": {"payload": "FACEBOOK_WELCOME"}}' \
"https://graph.facebook.com/v10.0/me/messenger_profile?access_token=${PAGE_ACCESS_TOKEN}"

為 FACEBOOK_WELCOME 事件建立自訂事件處理常式。

測試方法如下：

刪除與 Meta 專頁的先前對話 (如適用)。
- 「開始使用」按鈕只會顯示在新對話中。
與 Meta 專頁發起新對話。
按一下「Get Started」按鈕，驗證自訂事件處理常式的回應。

您可以呼叫 Messenger Profile API 來管理「Get Started」按鈕。這有助於測試。

如要查看「開始使用」按鈕的狀態，請使用下列要求：

curl -X GET \
"https://graph.facebook.com/v10.0/me/messenger_profile?fields=get_started&access_token=${PAGE_ACCESS_TOKEN}"

您可以使用下列要求停用「Get Started」按鈕：

curl -X DELETE \
-H "Content-Type: application/json" \
-d '{"fields": ["get_started"]}' \
"https://graph.facebook.com/v10.0/me/messenger_profile?access_token=${PAGE_ACCESS_TOKEN}"

複合式回應訊息

您可以使用執行中的自訂酬載，支援豐富的回覆訊息。詳情請參閱 Send API 參數訊息物件說明文件，瞭解訊息格式。

舉例來說，下列自訂酬載會提供文字訊息：

{
  "text": "Hello, world"
}

下列自訂酬載會提供圖片訊息：

{
  "attachment": {
    "type": "image",
    "payload": {
      "url": "https://example.com/test.jpg"
    }
  }
}

管道專屬回覆

設定管道專屬回覆後，代理會自動使用 DF_CX_FB_MESSENGER 管道回覆 Meta Messenger 訊息。