GET/bots/{botId}/richmenus

Gets a list of all rich menus that have been added.
If the number of rich menus is more than 50, use the cursor parameter in the previous results to continue to get the next list of rich menus.

Authorization

oauth2

OAuth 2.0 authentication.
For more information, see Authentication and Authorization.

Scope

bot.message
bot
bot.read

HTTP Request

GEThttps://www.worksapis.com/v1.0/bots/{botId}/richmenus

Path Parameters

ParameterTypeDescription
botId integer 

Bot ID


required
example : 2000001
format : int64 

Query Parameters

ParameterTypeDescription
cursor string 

Cursor value for pagination


example : JlIBsfJogXpzDGY8OscZziqZpYqCAu3RbZbaFzBb1od6lWQtSdPUd2FIdCuaGgu8DA== 
count integer 

Number of items in a list


default : 50
minimum : 1
maximum : 100
example : 60
format : int64 

Header Parameters

HeadertypeDescription
Authorization string 

Bearer {token}


required 

Response

HTTP 200

OK

PropertyTypeDescription
richmenus array (Richmenu) 

List of rich menus

 
responseMetaData object (responseMetaData) 

Response metadata

 

Richmenu

PropertyTypeDescription
richmenuId string 

Rich menu ID


readOnly : true 
richmenuName string 

Rich menu name. It is used to manage rich menus and is not shown to users.


required
maxLength : 300 
areas array (RichmenuArea) 

List of areas to set rich menu actions


required
minItems : 1
maxItems : 20 
size object (size) 

Size object of the rich menu


required 

RichmenuArea

PropertyTypeDescription
action object (action) 

Action that occurs when the area is pressed


required 
bounds object (bounds) 

Bound object of the rich menu button


required 

action

PropertyTypeDescription
type string 

Action type


required
Allowed values : postback, message, uri, copy 
label string 

Label displayed on an element.
It is required, except for "defaultAction" of a rich menu and carousel.
If it is not specified for a rich menu, the default message is displayed in the desktop environment.

  • Maximum length for an image carousel: 12 characters
  • Maximum length for a persistent menu: 1,000 characters
  • Maximum length for other types: 20 characters
 
data string 

Text string returned through the callback of the postback.data property.


maxLength : 300 
displayText string 

Chat message sent by a user. If it is not specified, no text is displayed.
Note that it is required for a quick reply.


maxLength : 300 
postback string 

Text string returned through the message.postback property


maxLength : 1000 
text string 

Text message sent when an element is pressed. It is required for a carousel, image carousel, rich menu and quick reply, and is replaced with the label value for a button template, list template, and persistent menu.


maxLength : 300 
uri string 

URI that opens when an element is pressed. The "http" and "https" schemas are supported.


maxLength : 1000 
copyText string 

Text string copied to the clipboard when an element is pressed.


maxLength : 1000 
i18nDisplayTexts array (i18nDisplayTexts) 

List of multilingual display texts


minItems : 0 
i18nLabels array (i18nLabels) 

List of multilingual labels


minItems : 0 
i18nTexts array (i18nTexts) 

List of text messages sent when an element is pressed.


minItems : 0 

i18nDisplayTexts

PropertyTypeDescription
language string 

Language code


required
Allowed values : ko_KR, ja_JP, en_US, zh_CN, zh_TW 
displayText string 

Chat message sent by a user.


required
maxLength : 300 

i18nLabels

PropertyTypeDescription
language string 

Language code


required
Allowed values : ko_KR, ja_JP, en_US, zh_CN, zh_TW 
label string 

Label displayed on an element

  • Maximum length for an image carousel: 12 characters
  • Maximum length for a persistent menu: 1,000 characters
  • Maximum length for other types: 20 characters

required 

i18nTexts

PropertyTypeDescription
language string 

Language code


required
Allowed values : ko_KR, ja_JP, en_US, zh_CN, zh_TW 
text string 

Text message sent when an element is pressed. It is required for a carousel, image carousel, rich menu and quick reply, and is replaced with the label value for a button template, list template, and persistent menu.


required
maxLength : 300 

bounds

PropertyTypeDescription
x integer 

Horizontal offset from the left of the area


required
minimum : 0
maximum : 2500
format : int64 
y integer 

Vertical offset from the top of the area


required
minimum : 0
maximum : 1686
format : int64 
width integer 

Width of the area


required
minimum : 0
maximum : 2500
format : int64 
height integer 

Height of the area


required
minimum : 0
maximum : 1686
format : int64 

size

PropertyTypeDescription
width integer 

Width of the rich menu


required
Allowed values : 2500
format : int64 
height integer 

Height of the rich menu


required
Allowed values : 843, 1686
format : int64 

responseMetaData

PropertyTypeDescription
nextCursor string 

Cursor value for pagination


required 

Response Example

example

1{2  "richmenus": [3    {4      "richmenuId": "40001",5      "richmenuName": "Example Richmenu",6      "areas": [7        {8          "action": {9            "type": "postback",10            "label": "Example label",11            "data": "Example data",12            "displayText": "Example displayText",13            "i18nDisplayTexts": [14              {15                "language": "en_US",16                "displayText": "Example display text"17              }18            ],19            "i18nLabels": [20              {21                "language": "en_US",22                "label": "Example label"23              }24            ]25          },26          "bounds": {27            "x": 0,28            "y": 0,29            "width": 2500,30            "height": 84331          }32        }33      ],34      "size": {35        "width": 2500,36        "height": 84337      }38    }39  ],40  "responseMetaData": {41    "nextCursor": "JlIBsfJogXpzDGY8OscZziqZpYqCAu3RbZbaFzBb1od6lWQtSdPUd2FIdCuaGgu8DA=="42  }43}