디버그 룸

디버그 룸은 한 프로젝트에만 메시지를 보내 보는 채팅 화면이에요. 카카오톡이나 다른 사람 없이 봇의 반응을 바로 확인할 수 있어요.

여는 방법#

• 프로젝트 카드를 펼친 뒤 디버그
• 에디터 툴바의 디버그 룸

프로젝트가 컴파일된 상태여야 열 수 있어요. 프로젝트를 켜 두지 않아도 돼요.

메시지 보내기#

아래 입력창에 메시지를 쓰고 보내면, 이 프로젝트의 onMessage 함수가 불려요. 프로젝트의 API 방식에 메신저봇 레거시가 있으면 response 함수도 함께 불려요.

• 봇의 답장은 봇 이름(기본 BOT)의 말풍선으로 보여요. 500자가 넘는 답장은 긴 말풍선으로 보여요.
• 봇이 MediaSharer.send()나 event.room.sendMedia()로 보낸 파일도 채팅에 보여요. 이미지는 사진으로, 다른 파일은 이름과 크기로 보이고, 누르면 이미지·Markdown·텍스트는 앱 안에서 미리 보고 다른 파일은 다른 앱으로 열어요.
• <@이름>이라고 쓰면 @이름 멘션으로 바뀌어 전달돼요.
• 스크립트가 읽음 처리를 부르면 읽음 처리 호출됨 안내가 떠요.
• 스크립트에서 오류가 나면 프로젝트 이름과 함께 자세히 보기 버튼이 나와요.

대화 기록은 프로젝트마다 debugroom/chats.json에 저장돼요. 봇이 보낸 파일의 사본은 debugroom/chats/media/에 두고, 대화 기록을 지우면 함께 지워요.

디버그 룸 설정#

아래쪽 시트를 끌어 올리면 설정이 나와요. 이 설정은 모든 프로젝트의 디버그 룸에 함께 적용돼요.

실제 메시지와 다른 점#

디버그 룸에서 온 이벤트는 실제 카카오톡 메시지와 조금 달라요. 스크립트에서 구분하려면 event.room.isDebugRoom()을 확인하세요.