跳至主要内容

REFERENCE

開發者參考

認證、API、SDK、Flow Agent 處理節點與參數取值的完整參考。

通用功能 - quickReplies

quickReplies 在 message template 中顯示快速回覆按鈕。

  1. 基本用法​

    quickReplies 會在任何 message template 下方顯示水平滾動的按鈕，讓使用者快速選擇常見的回應選項。使用者點擊按鈕後，系統會自動發送對應的文字訊息。

  2. quickReplies 結構​

    JSON 格式​

    {
      "quickReplies": [
        {
          "text": "我要找川菜"
        },
        {
          "text": "我要找粵菜"
        },
        {
          "text": "我要找台菜"
        }
      ]
    }

    屬性說明​

    quickReplies（陣列）​

    快速回覆按鈕的陣列，每個元素代表一個按鈕選項。

    text（必填）​

    按鈕顯示的文字內容，同時也是使用者點擊後會發送的訊息內容。建議控制在 20 字元以內。

  3. 使用範例​

    基本快速回覆​

    {
      "type": "TEXT",
      "text": "請選擇您喜歡的菜系：",
      "quickReplies": [
        {
          "text": "📍川菜"
        },
        {
          "text": "📍粵菜"
        },
        {
          "text": "📍台菜"
        }
      ]
    }

    搭配其他模板​

    {
      "type": "BUTTON",
      "title": "產品推薦",
      "text": "以下是我們的熱門產品：",
      "buttons": [
        {
          "label": "查看詳情",
          "action": {
            "type": "uri",
            "uri": "https://example.com/product"
          }
        }
      ],
      "quickReplies": [
        {
          "text": "我想看其他產品"
        },
        {
          "text": "聯絡客服"
        },
        {
          "text": "回到主選單"
        }
      ]
    }

  4. 使用方式​

    要在 Push Message 中發送帶有 quickReplies 的訊息，請按照以下步驟操作：

    1. 在 Template 欄位的下拉選單中選擇 Expression。
    2. 在 Editor 編輯器中輸入以下 JavaScript 程式碼。
    (() => {
      return {
        type: 'TEXT',
        text: '請選擇您需要的服務：',
        quickReplies: [
          {
            text: '訂單查詢',
          },
          {
            text: '退換貨',
          },
          {
            text: '產品諮詢',
          },
          {
            text: '技術支援',
          },
        ],
      };
    })()

    設定完成後，快速回覆按鈕會顯示在訊息下方，使用者點擊後會自動發送對應的文字訊息。

準備好開始了嗎？

想知道 Asgard 怎麼用在你的團隊？跟我們聊聊。

聯絡我們