애드온HOSPITAL MARKETING
메뉴
홈페이지·사용성

오류 메시지는 코드보다 이용자가 할 다음 행동을 먼저 알려야 합니다

오류 메시지가 코드만 보일 때 이용자가 막히는 이유와 입력 오류, 서비스 문제, 결제 상황별 안내 기준을 정리합니다.

애드온 편집팀

코드만 보이는 화면에서 이용자가 막히는 지점

양식을 제출했는데 알아보기 어려운 오류 코드만 나타나면 이용자는 입력을 고쳐야 하는지, 잠시 뒤 다시 시도해야 하는지 판단하기 어렵습니다. 내부 코드는 담당자가 원인을 추적할 때 쓸모가 있지만 이용자에게 단 하나의 안내가 되어서는 곤란합니다. 오류 메시지의 목적은 문제를 설명하는 데 그치지 않고, 지금 할 수 있는 안전한 다음 행동을 알려 주는 데 있습니다.

따라서 메시지를 점검할 때는 문구가 얼마나 정확한지보다 읽은 사람이 무엇을 하면 되는지 알 수 있는지를 먼저 확인합니다.

예를 들어 같은 문제를 겪은 이용자가 문의를 남길 때 코드를 옮겨 적다가 오타가 나는 경우도 흔합니다. 이용자가 읽고 따라 하기 쉬운 문장을 앞세우는 이유입니다.

입력 오류와 서비스 문제를 구분해서 안내하기

사용자가 필수 항목을 비웠거나 형식을 잘못 입력한 경우와 서비스 쪽에 문제가 생긴 경우는 안내가 달라야 합니다. 입력 오류라면 어떤 항목이 문제인지 표시하고, 이미 입력한 다른 값은 지워지지 않도록 유지해야 합니다. 처음부터 다시 작성하게 만드는 화면은 이용자의 포기를 부릅니다.

서버나 외부 인증의 문제라면 이용자가 잘못한 것처럼 표현하지 않습니다. 잠시 뒤 다시 시도하거나 공식 문의 경로를 이용하도록 안내하되, 확인되지 않은 복구 시간을 약속하지는 않습니다. 모르는 것은 모른다고 밝히는 편이 신뢰를 지킵니다.

또한 오류가 발생한 이유를 지나치게 길게 설명하기보다 한두 문장으로 상황과 행동을 먼저 전하고, 자세한 설명은 도움말 페이지로 연결하는 구성이 읽기 편합니다.

결제와 예약에서는 처리 여부가 먼저입니다

결제나 예약처럼 중요한 행동에서는 오류 화면이 떠도 요청이 이미 접수되었을 수 있습니다. 이때 곧바로 다시 제출하라고 안내하면 중복 신청이 생길 수 있습니다. 먼저 현재 상태를 확인할 수 있는 경로를 제공하고, 접수 여부가 불분명하다면 어떤 정보를 어디로 알리면 되는지 최소한의 범위로 안내합니다.

이 과정에서 개인정보를 공개 댓글이나 게시판에 남기도록 유도하지 않아야 합니다. 이용자가 화면 전체나 민감한 입력값을 캡처해서 보내야 하는 구조도 피하는 것이 안전합니다.

처리 상태를 확인하는 화면이 따로 있다면 오류 메시지에서 바로 그곳으로 이동할 수 있게 하는 것이 좋습니다. 이용자가 어디서 확인해야 하는지 찾아다니는 동안 같은 신청을 반복하게 되는 일을 줄일 수 있습니다.

메시지의 위치와 접근성

오류 문구가 화면 맨 위에만 있고 문제가 되는 입력란은 아래쪽에 숨어 있다면 이용자가 찾기 어렵습니다. 해당 항목 가까이에 이유를 표시하고, 키보드 초점이 그 위치로 이동하도록 만들면 도움이 됩니다. 화면 읽기 프로그램을 쓰는 사람에게도 오류가 전달되는지 확인해야 합니다.

붉은색만으로 오류를 구분하지 말고 문구나 기호로도 상태를 알려야 합니다. 색을 구별하기 어려운 이용자나 밝은 환경에서 화면을 보는 이용자도 같은 정보를 얻을 수 있습니다.

이용자 문구와 내부 기록을 나누기

이용자에게 보이는 문구와 내부 로그는 역할이 다릅니다. 접수번호나 발생 시각처럼 지원 담당자가 추적할 수 있는 최소한의 정보는 개인정보가 아닌 범위에서 표시할 수 있습니다. 반면 시스템 구조나 민감한 설정이 드러나는 내용은 공개 화면에 노출하지 않습니다.

문구를 고친 뒤에는 실제 시스템의 동작과 일치하는지 모바일과 컴퓨터에서 각각 시험해 봅니다. 문구는 재시도를 안내하는데 실제로는 이미 처리되는 경우처럼 말과 동작이 어긋나면 오히려 혼란이 커집니다.

오류 메시지를 점검하는 간단한 질문 목록

메시지를 검토할 때 몇 가지 질문을 던져 보면 문제를 빠르게 찾을 수 있습니다. 이 메시지를 읽은 사람이 무엇을 해야 하는지 알 수 있는가, 입력한 내용이 사라지지는 않는가, 같은 작업을 다시 해도 안전한가, 문의할 때 필요한 정보가 있는가를 확인합니다.

처음 서비스를 쓰는 사람에게 화면을 보여 주고 다음에 무엇을 할지 말해 달라고 요청해 보는 것도 유용합니다. 설명 없이 답하지 못한다면 문구나 안내 위치를 다시 다듬을 필요가 있습니다.

반복되는 오류는 문구가 아니라 원인을 고칩니다

같은 오류가 자주 나타난다면 메시지를 더 친절하게 바꾸는 것만으로는 부족합니다. 어떤 화면과 기기에서 반복되는지 기록하고 원인을 수정해야 합니다. 문의가 반복되는 내용은 안내 페이지에도 반영하여 이용자가 스스로 해결할 수 있게 합니다.

좋은 오류 메시지는 코드의 해독을 요구하지 않습니다. 이용자가 자신의 작업 상태를 이해하고 안전한 다음 단계를 선택하게 하는 것이 목표이며, 점검할 때에는 실제로 처음 쓰는 사람이 막히지 않는지를 기준으로 삼아 보시기 바랍니다.

추가 정보

같은 카테고리 글 보기 · 전체 글 보기

CONSULTATION

어떤 정보를, 어디에 전할지
함께 정리해보세요.

병원의 현재 운영 채널과 필요한 작업을 알려주세요.
원고·이미지·홈페이지 중 필요한 업무 범위부터 확인합니다.

이메일로 문의하기 카카오 오픈채팅