Ice Breaker

Ice Breakers 透過一系列常見問題，為用戶提供與企業展開對話的方式。您可以透過 Ice Breaker API 設定最多 4 個問題。

自 2021 年 10 月 19 日起，Ice Breaker 開始支援本地化服務，方便商家根據用戶的語言區域設定自訂問題。我們日後會推出新的 API 格式，並鼓勵開發人員利用全新格式設定和擷取 Ice Breaker 資訊。如要查看支援的語言區域清單，請點擊這裡。

設定 Ice Breaker

新格式（推薦）

curl -X POST -H "Content-Type: application/json" -d '{
     "platform": "instagram",
     "ice_breakers":[
       {
          "call_to_actions":[
             {
                "question":"

舊格式（請勿在設定新的 Ice Breaker 時使用）

curl -X POST -H "Content-Type: application/json" -d '{
  "platform": "instagram",
  "ice_breakers":[
     {
        "question": "

取得 Ice Breaker

視 Ice Breaker 的設定方式而定，GET 要求會傳回不同格式。如果符合條件，系統就會出現下列行為：

• 如果 Ice Breaker 是使用舊格式進行設定，GET 要求會傳回舊格式的回應。
• 如果 Ice Breaker 是使用新格式進行設定，GET 要求會傳回新格式的回應。

由於我們日後會停用舊格式，因此建議開發人員移轉至新格式。

curl -X GET "https://graph.facebook.com/v11.0/me/messenger_profile?fields=ice_breakers&platform=instagram&access_token=<PAGE_ACCESS_TOKEN>

新格式的回應

{
   "data": [
        {
          "call_to_actions" : [
               {
                "question": "

舊格式的回應

{
   "data": [
        {
          "ice_breakers": [
            {
                "question": "

刪除 Ice Breaker

curl -X DELETE -H "Content-Type: application/json" -d '{
  "fields": [
    "ice_breakers",
  ]
}' "https://graph.facebook.com/v11.0/me/messenger_profile?platform=instagram&access_token=%lt;PAGE_ACCESS_TOKEN>"

Webhook 事件

為了接收來自 Icebreakers 的回傳 Webhook，應用程式必須已在應用程式設定的 Instagram 主題中訂閱 messaging_postbacks 8.0 以上版本 Webhook。

Webhook 將會收到類似下方範例的 JSON 承載。

{
  "object": "instagram",
  "entry": [
    {
      "id": "<IGID>",
      "time": 1502905976963,
      "messaging": [
        {
          "sender": {
            "id": "<IGSID>"
          },
          "recipient": {
            "id": "<IGID>"
          },
          "timestamp": 1502905976377,
          "postback": {
            "title": "<SELECTED_ICEBREAKER_QUESTION>",
            "payload": "<USER_DEFINED_PAYLOAD>",
          }
        }
      ]
    }
  ]
}