English

# Using quick replies

# Introduction

Note

The quick reply feature is supported on both LINE for iOS and LINE for Android.

When a user receives a message that contains quick reply buttons from a LINE Official Account, those buttons appear at the bottom of the chat screen. The user can simply tap one of the buttons to reply to the LINE Official Account.

The quick reply feature can be used in a one-on-one chat with a LINE Official Account, a group, and a room. You can set up to 13 quick reply buttons to a message of any type.

Quick reply sample

# Elements

A quick reply button consists of the following elements. For more information about writing these elements, see Quick reply in the Messaging API reference documentation.

# Action

An action is triggered when the quick reply button is tapped.

The following actions are available only for the quick reply feature. You cannot use these actions with the other message types.

In addition to the actions above, the following actions that are common to the other message types are available:

Rich menu switch action unavailable

Rich menu switch action isn't available for use for quick messages.

For more information on what you can do with each action, see action.

# Icon

An icon of your choice is displayed at the beginning of the quick reply button.

  • If the button's action is a camera action, camera roll action, or location action, and no icon is set, the default icon is displayed.
  • If the button's action is a postback action, message action, or datetime picker action, you can omit an icon.

# Label

A label is displayed on the quick reply button.

# Setting quick reply buttons

As an example, suppose you are developing a restaurant search bot. Let's create a message for your bot to check the user's request. This bot searches restaurants according to the food category requested by the user or the user's current location.

Here is an example of JSON data.

{
  "type": "text", // ①
  "text": "Select your favorite food category or send me your location!",
  "quickReply": { // ②
    "items": [
      {
        "type": "action", // ③
        "imageUrl": "https://example.com/sushi.png",
        "action": {
          "type": "message",
          "label": "Sushi",
          "text": "Sushi"
        }
      },
      {
        "type": "action",
        "imageUrl": "https://example.com/tempura.png",
        "action": {
          "type": "message",
          "label": "Tempura",
          "text": "Tempura"
        }
      },
      {
        "type": "action", // ④
        "action": {
          "type": "location",
          "label": "Send location"
        }
      }
    ]
  }
}
  1. Create a text message that asks the user for their request.
  2. Set an items object in the quickReply property. Include an array of three quick reply buttons in the items object.
  3. Set an icon, label, and message action that describe a food category to each of the first and second quick reply buttons. Specify the label text in the label property of the action object. When the user taps either button, the food category is sent as a reply from the user.
  4. Set a label and location action that prompt the user to send their location to the third quick reply button. The default icon is displayed because the imageUrl property is not set.

The JSON data above will be drawn as below on the user device.

Quick reply sample 2

# When quick reply buttons disappear

Quick reply buttons disappear in the following cases. To allow the user to review their replies in the chat screen, implement quick reply buttons so that user replies remain as messages.

  • When the user taps one of quick reply buttons. However, if the button's action is a camera action, camera roll action, or location action, the buttons remain visible until the user sends expected data by completing the action.
  • When the LINE Official Account, the user, or another member sends a new message in the room. If the new message is deleted, the quick reply buttons appear again.