トーク共通プロパティ

メッセージの送信時に利用可能なプロパティです。

クイック返信

クイック返信 (quick reply) ボタンが含まれているメッセージを受信すると、メンバーのトーク画面下部にクイック返信ボタンが表示されます。
メンバーはボタンの中から 1 つを選んで簡単に返信できます。

クイック返信は全てのメッセージタイプで利用可能です。ボタンは最大 13 個まで設定できます。

クイック返信で使用できる動作は次の通りです。

• postback
• message
• URI
• camera (iOS および Android　のみ可)
• camera roll (iOS および Android のみ可)
• location (iOS および Android のみ可)

各クイック返信ボタンにはアイコンを指定できます。

• ボタンのタイプが「camera」「cameraRoll」「location」でアイコンが未指定の場合、既定のアイコンが表示されます。
• ボタンのタイプが「postback」「message」「uri」でアイコンが未指定の場合、アイコンは表示されません。

参照

• クイック返信ボタンは v2.6 以降のアプリケーションのみ表示されます。

図1 クイック返信の構造

Request Content

common

resourceId, multi language

Request Example

quick reply structure

"quickReply": {
  "items": [
    {
      "imageUrl": "https://www.example.com/a.png",
      "action": {
        "type": "message",
        "label": "Send message",
        "text": "send message"
      }
    },
    {
      "action": {
        "type": "camera",
        "label": "Open camera"
      }
    }
  ]
}

text with quick reply

{
  "accountId": "admin@example.com",
  "content": {
    "type": "text",
    "text": "Please select your favorite food category!",
    "quickReply": {
      "items": [
        {
          "imageUrl": "https://www.example.com/a.png",
          "action": {
            "type": "message",
            "label": "Sushi",
            "text": "Sushi"
          }
        },
        {
          "imageUrl": "https://www.example.com/b.png",
          "action": {
            "type": "message",
            "label": "Italian",
            "text": "Italian"
          }
        },
        {
          "action": {
            "type": "camera",
            "label": "Open Camera"
          }
        }
      ]
    }
  }
}

flexible template with quick reply

{
  "accountId": "admin@example.com",
  "content": {
    "type": "flex",
    "altText": "This is a flexible template with quick reply",
    "contents": {
      "type": "bubble",
      "size": "mega",
      "hero": {
        "type": "box",
        "layout": "vertical",
        "contents": [
          {
            "type": "text",
            "text": "YOU ARE INVITED!",
            "size": "xl",
            "color": "#ffffff",
            "weight": "bold",
            "align": "center",
            "wrap": true
          }
        ],
        "backgroundColor": "#81DBA0",
        "paddingAll": "15px"
      }
    },
    "quickReply": {
      "items": [
        {
          "imageUrl": "https://www.example.com/a.png",
          "action": {
            "type": "message",
            "label": "Accept",
            "text": "Accept"
          }
        },
        {
          "imageUrl": "https://www.example.com/b.png",
          "action": {
            "type": "message",
            "label": "Decline",
            "text": "Decline"
          }
        }
      ]
    }
  }
}

メンバーへのメンション

Bot が参加するトークルームの特定のメンバーまたはすべてのメンバーにメンションしてメッセージを送信することができます。

参考

• メンション機能に関する詳細は、ガイドページのメンションをご参照ください。
• 最大50名までメンションできます。

メンバーへのメンションに対応しているメッセージ送信タイプと指定可能なパラメータは次のとおりです。

• Text：textパラメータ
• Link：contentTextパラメータ
• Button template：contentTextパラメータ
• Flexible template
  • Text: textパラメータ
  • Span: textパラメータ

特定のメンバーへのメンション

特定のメンバーにメンションする場合、次のようなフォーマットでメッセージを作成します。
メンションされたメンバーの accountId は、メンバーの名前に変更して送信されます。
Hello, <m accountId="{accountId}"> => Hello, @{userName}

{
  "accountId": "admin@example.com",
  "content": {
    "type": "text",
    "text": "Hello, <m accountId=\"admin@example.com\">"
  }
}

{
  "accountId": "admin@example.com",
  "content": {
    "type": "link",
    "contentText": "<m accountId=\"admin@example.com\">, please refer to the link.",
    "linkText": "link text",
    "link": "http://www.worksmobile.com"
  }
}

{
  "accountId": "admin@example.com",
  "content": {
    "type": "button_template",
    "contentText": "<m accountId=\"admin@example.com\">, please refer to the link.",
    "actions": [{
      "type": "uri",
      "label": "WorksMobile Homepage",
      "uri": "https://line.worksmobile.com"
    }, {
      "type": "message",
      "label": "FAQ",
      "postback": "ButtonTemplate_FAQ"
    }]
  }
}