응답과 요청

CLOSER에서 사용되는 챗봇의 응답과 요청에 대한 개념을 알아봅니다.

CLOSER에서는 여러 메시징 채널에서 사용되는 챗봇의 응답과 요청에 대한 구성요소들을 효율적으로 표현할 수 있도록 공통 응답 메시지와 요청 유형을 정의하여 제공합니다.

이번 페이지에서 다루는 응답 유형과 요청 유형은 대부분의 메시징 채널에서 적절하게 변환될 것이며, 수신되는 메시지 또한 CLOSER에서 사용하고 있는 응답과 요청 형식에 알맞게 변환될 것입니다.

응답 유형

응답 유형은 메신저에서 챗봇이 반환할 수 있는 말풍선의 형태를 나타냅니다. 형태와 지원 범위는 메신저에 따라 다릅니다만, 크게 다음과 같은 구조를 가집니다.

문자 메시지
템플릿 메시지
- 카드형 (= 캐러셀형)
- 목록형
미디어 메시지
- 사진
- 동영상
- 음성메시지
- 위치
- 링크 (공유된 포스트)

CLOSER에서는 일반적인 문자 메시지를 텍스트 메시지라고 부르며, 첨부파일에 해당하는 메시지를 미디어 메시지로, 그 외의 템플릿에서는 현재 카드형 메시지 를만 지원합니다.

텍스트 메시지 (Text Message)

type: text
텍스트로 이루어진 일반적인 말풍선 메시지입니다. 모든 메시징 채널에서 지원합니다.
CLOSER에서는 텍스트 메시지에 버튼을 첨부할 수 있지만, 지원 여부는 메시징 채널에 따라 다릅니다.

미디어 메시지 (Media Message)

type: media
사진이나 동영상 등의 미디어를 포함한 메시지입니다. 메시징 채널별로 지원 범위가 다릅니다.
만약 사진과 함께 메시지나 링크/버튼 등을 함께 첨부하고자 하실 경우에는 카드형 메시지 항목을 참고해 주세요.

카드형 메시지 (Card Message)

type: cards
사진이나 동영상과 함께 텍스트나 버튼 등 말풍선 안에 풍부한(rich) 컨텐츠를 보유한 메시지입니다.
한 메시지에 하나 이상의 카드를 사용할 수 있습니다.
두 개 이상의 카드가 사용된 경우 가로로 슬라이드가 가능한 캐러셀(carousel) 형태로 변환됩니다. 캐러셀이 지원되지 않을 경우 여러 장의 카드를 연달아여 전송합니다.

위치 메시지 (Location Message) 👩🏻‍🔬

type: location
위도와 경도를 첨부하여 지도상에 위치를 표시하는 메시지입니다. 경우에 따라 위치에 이름을 지정할수도 있습니다.
메시징 채널에 따라 지원 여부와 범위가 다릅니다.

요청 유형

일반 요청 (Generic Request)

특정 설정 없이 사용자의 메시지 입력을 대기하는 일반적인 요청 방식입니다. 사용자는 텍스트를 비롯하여 이미지, 동영상 혹은나 위치 등 메신저에서 지원하는 다양한 입력 방식을 이용해 챗봇에게 메시지를 전송할 수 있습니다.

포스트백 버튼 (Postback Button)

텍스트형 메시지나 카드형 메시지에는 하나 이상의 버튼을 첨부할 수 있으며, 이 버튼은 크게 두 가지 기능으로 나뉩니다.

링크(Link) 버튼: 클릭 시 특정 링크(URL)로 이동
포스트백(Postback) 버튼: 클릭 시 버튼에 설정된 메시지 혹은 데이터를 전송 (위 예시에서는 "한 개 담기" 버튼이 포스트백 버튼에 해당합니다.)

포스트백 버튼에는 사용자 정의 데이터를 첨부할 수 있는데, 이 데이터를 포스트백 페이로드(Postback Payload) 라고 부릅니다. 버튼에 설정된 데이터는 동일한 텍스트를 가진 버튼들 사이에서 어떠한 버튼을 눌렀는지 구분할 수 있게끔 도와주며, 나아가 대화의 맥락을 벗어난 경우에도 설정된 데이터를 이용하여 사용자가 의도한 동작을 수행할 수 있도록 도와줍니다.

포스트백 페이로드 기능의 지원 여부는 메시징 채널에 따라 다릅니다.