코드만 보이는 화면은 이용자를 멈추게 합니다
양식을 제출했더니 알 수 없는 영문 코드만 나타나면 이용자는 다시 시도해야 하는지, 입력을 고쳐야 하는지 판단할 수 없습니다. 오류 문구는 무엇이 문제인지와 지금 할 수 있는 행동을 함께 설명해야 합니다. 내부 코드는 담당자가 원인을 진단하는 데 쓸 수 있는 정보이지만, 이용자에게 보이는 안내가 코드 하나뿐이어서는 안 됩니다.
오류 문구를 새로 만들 때는 처음 보는 사람이 읽어도 이해되는지를 기준으로 삼는 것이 좋습니다. 사내에서 쓰는 용어나 시스템 이름은 이용자에게 낯설기 때문에, 화면에 나타난 현상과 해결 방법을 일상적인 단어로 풀어 쓰는 것이 우선입니다. 번역된 문구라면 어색한 직역이 남아 있지 않은지도 함께 읽어 봅니다.
입력 오류와 서비스 문제를 먼저 나눕니다
필수 항목이 비어 있다면 어느 항목인지 표시하고, 이미 입력한 다른 값은 지워지지 않게 유지해야 합니다. 반대로 서버나 외부 인증처럼 이용자가 어쩔 수 없는 문제라면 이용자가 잘못한 것처럼 표현하지 않습니다. 잠시 뒤에 다시 시도하거나 공식 문의 경로를 확인하도록 안내하는 문장이 적절합니다. 확인되지 않은 복구 시간을 약속하는 문구는 쓰지 않습니다.
예약과 결제에서는 처리 여부가 가장 중요합니다
예약이나 결제 같은 중요한 행동에서는 완료되었는지가 가장 큰 관심사입니다. 오류 화면이 떠도 요청 자체는 접수되었을 수 있으므로, 단순히 다시 제출하라고 안내하면 같은 신청이 중복으로 생길 수 있습니다. 현재 상태를 확인할 수 있는 경로를 제공하고, 운영자가 추가로 확인해야 한다면 필요한 정보를 최소한의 범위로 요청합니다. 개인정보를 공개된 댓글이나 게시판에 남기도록 유도하는 안내는 하지 않습니다.
문구의 어조도 중요합니다. ‘잘못 입력하셨습니다’처럼 책임을 이용자에게 돌리는 표현보다 ‘이메일 주소에는 @ 기호가 필요합니다’처럼 고쳐야 할 내용을 구체적으로 알려 주는 표현이 다음 행동을 고르기 쉽게 합니다. 긴 설명보다 한두 문장으로 문제와 해결 방법을 함께 적는 편이 읽기 편합니다.
접수 여부가 불분명한 상황에서는 확인 방법을 두 가지 이상 마련해 두면 좋습니다. 예를 들어 접수 확인 문자나 메일을 받았는지 살펴보는 방법과, 문의 창구에서 이름과 연락처로 조회하는 방법을 함께 안내하면 이용자가 같은 신청을 반복하지 않고 현재 상태를 확인할 수 있습니다.
메시지가 보이는 위치와 전달 방식을 점검합니다
화면 맨 위에 ‘오류가 발생했습니다’만 보이고 실제 문제가 있는 입력란은 아래쪽에 있다면 이용자가 직접 찾아야 합니다. 설명은 문제가 있는 항목 가까이에 두고, 키보드 이동이나 화면 읽기 프로그램에서도 오류가 전달되는지 확인합니다. 빨간색 같은 색상만으로 상태를 구분하면 색을 구별하기 어려운 사람은 알아차리기 힘들기 때문에 문장이나 기호를 함께 씁니다.
이용자용 문구와 내부 기록은 분리합니다
고객에게 보이는 문구와 내부 로그는 역할이 다릅니다. 지원 담당자가 추적할 수 있도록 오류 번호와 발생 시각은 내부에 남기되, 민감한 시스템 정보는 공개 화면에 노출하지 않습니다. 문의할 때 쓸 수 있는 접수 번호가 있다면 개인정보가 아닌 범위에서 보여 줄 수 있습니다. 또 오류 상황을 설명하기 위해 화면 전체나 민감한 입력값을 캡처해서 보내라고 요구하는 방식은 가능하면 피합니다.
문구를 작성할 때는 오류 유형 목록을 만들어 유형마다 이용자용 문장과 내부 기록 항목을 짝지어 두면 일관성을 지킬 수 있습니다. 새로운 오류가 생길 때마다 임시 문구를 만들기보다 목록에 추가하는 방식으로 관리하면 담당자가 바뀌어도 같은 기준으로 안내할 수 있습니다.
같은 오류가 반복되면 문구보다 원인을 고칩니다
같은 오류가 계속 발생한다면 문구를 더 친절하게 바꾸는 것만으로는 해결되지 않습니다. 원인을 찾아 고치는 것이 우선이며, 문구는 그동안 이용자가 혼란을 겪지 않게 돕는 보조 수단입니다. 출시 전에는 모바일과 컴퓨터에서 일부러 오류를 일으켜 보고, 화면에 나온 메시지가 실제 시스템의 동작과 일치하는지 확인하시기 바랍니다. 좋은 오류 문구는 코드를 해독하라고 요구하지 않고, 이용자가 자신의 작업 상태를 이해하고 안전한 다음 단계를 고르게 합니다.