스킬 오류 내역 확인하기
스킬로 그린 말풍선이 특정 오류로 인하여 사용자에게 발송되지 않을 수 있습니다.
이러한 경우 카카오톡 알림으로 오류 발생 사실을 수신하고, 챗봇 관리자센터의 스킬 오류 내역을 통해 상세 오류 내용을 확인할 수 있습니다.
카카오톡 알림은 오류가 발생한 봇, 블록, 오류 타입 정보를 주기적으로 발송합니다. 챗봇 관리자센터의 오류 내역은 오류의 상세 원인과 발생 시각을 보여줍니다.
확인할 수 있는 오류의 종류는 크게 스킬 서버 연결 오류와 말풍선 가이드 위반 두 가지입니다.
스킬 서버 연결 오류는 타임아웃 발생, 서버 연결 실패, 네트워크 접근 실패 등 사용자의 스킬 서버에서 발생하는 오류입니다.
말풍선 가이드 위반은 사용자가 작성한 JSON 포맷이 스킬 가이드 형식과 어긋나서 발생하는 오류입니다.
일부 스킬 오류는 확인되지 않을 수 있습니다. 스킬 응답이 발송되지 않았으나 오류 내용을 확인할 수 없는 경우, 고객센터로 문의해 주시기 바랍니다.
Information.
운영 채널에서 발생한 스킬 오류만 확인 가능합니다. (봇 테스트 및 개발 채널에서 발생한 오류는 확인 불가능)
Event API로 발송한 응답의 오류는 확인이 불가능합니다. 이벤트 발송 성공여부 조회 API를 이용하여 확인해 주세요.
스킬 v1 포맷을 사용 중 말풍선 가이드를 위반한 경우, 구체적인 오류를 제공하지 않습니다. 관련 공지를 확인해 주시기 바랍니다.
카카오톡 채널로 알림 받기
알림 수신 설정
운영 채널의 스킬 응답에 오류가 발생할 때마다, 카카오톡 채널(‘챗봇 관리자센터')을 통해 오류 발생 사실을 수신할 수 있습니다. 알림 수신은 해당 챗봇의 관리자라면 누구나 가능합니다. 챗봇 관리자센터 우측 상단의 ‘계정 > 알림 설정’을 클릭합니다.
챗봇 목록에서 원하는 챗봇을 선택하여 알림 수신 설정을 바꿉니다. 알림 수단 ‘카카오톡 채널'을 ON해야만 ‘스킬 말풍선 오류 내역'을 ON할 수 있습니다.
Information.
신규 봇의 마스터인 경우, 스킬 말풍선 오류 내역은 기본 ON 상태로 설정됩니다.
위임봇은 스킬 오류 내역을 수신할 수 없습니다. 위임봇에서 발생한 오류 내역은 대행봇이 일괄 수신합니다.
수신 주기 설정
스킬 오류가 발생했을 때 알림을 얼마나 자주 수신할 것인지를 설정합니다.
10분으로 설정한 경우, 매 시간 00분/ 10분/ 20분/ 30분/ 40분/ 50분마다 카카오톡 메시지가 전송됩니다. 1시간으로 설정한 경우, 매 시간 00분마다 카카오톡 메시지가 전송됩니다.
Information.
수신 주기는 챗봇의 마스터만 설정 가능합니다. 작업자는 별도 설정이 불가능합니다.
알림 내용
알림에서 확인할 수 있는 정보는 크게 세 가지입니다.
봇 정보
지난 10분 또는 1시간 동안 스킬 오류가 한 번이라도 발생한 봇을 알려줍니다. 한 말풍선에는 하나의 봇 정보만 담기게 됩니다. 따라서 n개의 봇에 대해 알림 수신을 ON했다면, 한 번에 최대 n개의 말풍선을 수신할 수 있습니다. 위 사진은 두 개의 봇에 대한 알림을 수신한 예시입니다.
블록 정보
지난 10분 또는 1시간 동안 스킬 오류가 발생한 블록을 오류 타입 별로 알려줍니다. 블록 정보는 오류 타입 별로 각각 5개까지만 노출됩니다.
오류 타입 정보
지난 10분 또는 1시간 동안 발생한 스킬 오류 타입을 알려줍니다. 오류 타입은 크게 ‘스킬 서버 연결 오류'와 ‘말풍선 가이드 위반'으로 나뉩니다. 스킬 서버 연결 오류는 타임아웃 발생, 서버 연결 실패, 네트워크 접근 실패 등 사용자의 스킬 서버에서 발생하는 오류입니다. 말풍선 가이드 위반은 사용자가 작성한 JSON 포맷이 스킬 가이드 형식과 어긋나서 발생하는 오류입니다. 이외에도 말풍선 제한 사이즈를 초과하는 경우, ‘말풍선 사이즈 초과' 오류가 발생할 수 있습니다. 챗봇 관리자센터의 스킬 오류 내역에서 더욱 상세한 원인을 확인할 수 있습니다.
챗봇 관리자센터에서 오류 내역 확인하기
오류 내역 개요
챗봇 관리자센터에서는 운영 채널의 스킬 오류 내역을 실시간에 가깝게 확인할 수 있습니다. 또한 카카오톡 알림보다 더욱 상세한 오류 원인을 제공합니다. 챗봇의 관리자라면 누구나 열람이 가능합니다.
Information.
스킬 오류 내역은 최대 100개까지만 노출됩니다.
지식베이스로 스킬 응답을 사용하는 경우, 블록명이 ‘지식+’으로 노출됩니다.
블록명과 스킬명은 오류 발생 시점을 기준으로 기록되기에, 현재 정보와 차이가 있을 수 있습니다.
오류 내역 상세
블록명 & 연결 스킬명
스킬 응답 오류가 발생한 블록과 스킬의 이름입니다. 블록명이나 스킬명이 긴 경우, 최대 2줄까지만 노출됩니다. 오류 발생 시점을 기준으로 기록되므로, 현재의 이름 정보와 차이가 있을 수 있습니다. 클릭하면 해당하는 블록 또는 스킬의 페이지로 이동할 수 있습니다.
오류 타입
스킬 응답에서 발생한 오류 타입으로, 크게 스킬 서버 연결 오류와 말풍선 가이드 위반이 있습니다. 카카오톡 알림으로 전달되는 오류 타입과 동일합니다.
세부 오류 메시지
스킬 응답 오류의 구체적인 원인입니다.
마지막 발생 시각
스킬 응답 오류가 마지막으로 발생한 시각입니다. 동일한 블록 & 동일한 스킬 & 동일한 원인으로 발생한 오류인 경우, 마지막 발생 시각만 업데이트됩니다.
Last updated