컨텍스트 (Context)

CLOSER 챗봇이 고객과 대화하는 맥락을 보관하는 객체인 컨텍스트에 대하여 알아봅니다.

CLOSER 챗봇에서는 사용자의 마지막 입력이나 다른 노드의 수행 결과값들이 담겨있는 컨텍스트(Context)라는 객체를 제공합니다. 여기에는 다음과 같은 값들이 제공됩니다.

아직 Context 대한 문서는 100% 완성되지 않았습니다. 각 노드별 반환값에 대한 설명은 추후 추가될 예정입니다.

키 (key)

값 (value)

botId

CLOSER에서 제공하는 챗봇의 고유 식별자

endUserId

CLOSER에서 제공하는 고객의 고유 식별자 (⚠️ 대화 테스트에는 존재하지 않습니다.)

conversationId

CLOSER에서 제공하는 고객의 대화 세션의 고유 식별자

(⚠️ 대화 세션이 변경되면 함께 변경됩니다. e.g. 친구 삭제 후 다시 추가 시)

platform

고객의 유입 채널 (e.g. facebook, kakao, web, ...)

userKey

고객의 유입 채널에서 제공되는 고유 식별자

message

고객으로부터 입력받은 마지막 메시지 데이터

  • type: text / media / ...

  • text: 텍스트 메시지의 경우의 메시지 값

  • payload: 고객이 postback 버튼을 선택했을 경우의 포스트백 데이터 (존재 시)

params

챗봇에 설정된 파라미터 객체

error

답변 생성 과정에서 발생한 오류 (예: 메시지 없음, 연결된 플로우 없음 등)

[NODE_TYPE]

노드의 실행 결과가 담겨있는 객체

  • status: 노드의 실행 상태 (e.g. PENDING, COMPLETED, FAILED)

  • error: 노드의 실행 오류 (예: 템플릿 문법 오류나 잘못된 데이터 등의 오류 발생 시)

endUserId와 userKey 둘 다 고객을 특정하는 고유 식별자로 사용할 수 있습니다. 단, userKey는 메시징 채널에서 제공하는 값으로 메시징 채널을 여러개 연동 시 값이 중복될 수 있습니다.

실제 컨텍스트에 존재하는 값들을 더 자세히 확인해보시려면 개발자 도구 항목의 컨텍스트 분석 도구 항목을 확인해보세요.

컨텍스트에 존재하는 값들은 템플릿 문법을 이용하여 답변 생성에 사용할 수 있습니다. 더 자세한 내용은 템플릿 문법 사용법을 통해 알아보세요.