GET/bots/{botId}/persistentmenu

등록된 메시지 고정 메뉴(persistent menu)를 조회한다.

Authorization

oauth2

OAuth 2.0 인증.
자세한 인증 방식은 인가·인증을 참고한다.

Scope

bot.message
bot
bot.read

HTTP Request

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

Path Parameters

ParameterTypeDescription
botId integer 

봇 ID


required
example : 2000001
format : int64 

Header Parameters

HeadertypeDescription
Authorization string 

Bearer {token}


required 

Response

HTTP 200

OK

PropertyTypeDescription
content object (content) 

설정할 고정 메뉴


required 

content

PropertyTypeDescription
actions array (PersistentMenuActionStruct) 

고정 메뉴에 추가할 버튼 목록


required
maxItems : 4 

PersistentMenuActionStruct

PropertyTypeDescription
type string 

Action 종류


required
Allowed values : message, uri, copy 
label string 

항목에 표시되는 레이블.
리치 메뉴와 캐러셀의 'defaultAction' 항목을 제외하고 필숫값이다.
리치 메뉴는 값을 지정하지 않으면 데스크톱 환경에서 기본 메시지가 출력된다.

  • 이미지 캐러셀 최대 글자 수: 12자
  • 고정 메뉴 최대 글자 수: 1000자
  • 위 항목 이외 최대 문자 수: 20자
 
postback string 

message.postback 속성으로 반환되는 문자열


maxLength : 1000 
text string 

항목을 누르면 전송되는 텍스트. 캐러셀, 이미지 캐러셀, 리치 메뉴, 빠른 답장에서 필숫값으로 사용되며, 버튼 템플릿, 리스트 템플릿, 고정 메뉴에서는 label로 대체된다.


maxLength : 300 
uri string 

항목을 누르면 열리는 URI. 'http', 'https' 스키마를 지원한다.


maxLength : 1000 
copyText string 

항목을 누르면 클립보드에 복사되는 문자열


maxLength : 1000 
i18nLabels array (i18nLabels) 

다국어 레이블 목록


minItems : 0 
i18nTexts array (i18nTexts) 

항목을 누를 때 전송되는 텍스트 목록


minItems : 0 

i18nLabels

PropertyTypeDescription
language string 

다국어 언어 코드


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

항목에 표시되는 레이블

  • 이미지 캐러셀 최대 글자 수: 12자
  • 고정 메뉴 최대 글자 수: 1000자
  • 위 항목 이외 최대 문자 수: 20자

required 

i18nTexts

PropertyTypeDescription
language string 

다국어 언어 코드


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

항목을 누를 때 전송되는 텍스트. 캐러셀, 이미지 캐러셀, 리치 메뉴, 빠른 답장에서 필숫값으로 사용되며, 버튼 템플릿, 리스트 템플릿, 고정 메뉴에서는 label로 대체된다.


required
maxLength : 300 

Response Example

example

1{2  "content": {3    "actions": [4      {5        "type": "message",6        "label": "Example label",7        "text": "Example text",8        "postback": "Example postback",9        "i18nLabels": [10          {11            "language": "en_US",12            "label": "Example label"13          }14        ],15        "i18nTexts": [16          {17            "language": "en_US",18            "text": "Example text"19          }20        ]21      },22      {23        "type": "uri",24        "label": "Example Homepage",25        "uri": "https://example.com",26        "i18nLabels": [27          {28            "language": "en_US",29            "label": "Example label"30          }31        ]32      }33    ]34  }35}