코드만 보이는 화면에서 이용자는 멈춥니다
문의나 예약 양식을 제출했는데 알파벳과 숫자로 된 코드만 화면에 나타나면 이용자는 다음에 무엇을 해야 할지 알 수 없습니다. 다시 시도해야 하는지, 입력한 내용을 고쳐야 하는지, 아니면 잠시 기다려야 하는지가 문구에서 드러나지 않기 때문입니다. 오류 문구는 문제의 범위와 지금 할 수 있는 행동을 함께 설명해야 합니다.
내부 코드는 담당자가 원인을 진단할 때 쓸모가 있지만, 이용자에게 하나뿐인 안내가 되어서는 안 됩니다. 코드는 지원을 요청할 때 전달할 수 있는 보조 정보 정도로 두고, 문구가 길어지더라도 첫 문장에서 상황을, 다음 문장에서 해야 할 일을 말하는 순서를 지킵니다. 화면의 중심에는 사람이 읽고 판단할 수 있는 문장을 둡니다.
입력 오류와 서비스 문제를 먼저 구분합니다
문구를 고치기 전에 오류를 두 갈래로 나누어 봅니다. 하나는 필수 항목이 비었거나 형식이 맞지 않는 것처럼 이용자가 바로잡을 수 있는 입력 오류이고, 다른 하나는 서버나 외부 인증 문제처럼 이용자가 해결할 수 없는 서비스 문제입니다.
입력 오류라면 어떤 항목이 문제인지 표시하고, 이미 입력한 다른 값은 그대로 유지해야 합니다. 모든 칸을 처음부터 다시 쓰게 하면 이용자는 제출을 포기하기 쉽습니다. 형식 오류의 경우 올바른 입력 예시를 함께 보여 주면 같은 실수를 반복하는 일이 줄어듭니다. 서비스 문제라면 이용자가 잘못한 것처럼 표현하지 않고, 잠시 뒤 다시 시도하거나 공식 지원 경로를 확인하도록 안내합니다. 실제로 확인되지 않은 복구 시간을 약속하는 문장은 넣지 않습니다.
결제나 예약에서는 완료 여부가 가장 중요합니다
결제와 예약처럼 중요한 행동에서는 처리가 끝났는지가 가장 큰 관심사입니다. 오류 화면이 떠도 요청이 이미 접수되었을 수 있으므로, 반드시 다시 제출하라고만 안내하면 중복 신청이 생길 수 있습니다.
따라서 현재 상태를 확인할 수 있는 경로를 함께 제공하는 것이 좋습니다. 운영자가 추가로 확인해야 한다면 필요한 정보를 최소한의 범위로만 요청하고, 개인 정보를 공개된 댓글이나 게시판에 남기도록 유도하지 않습니다. 접수 번호가 있다면 개인 정보가 아닌 범위에서 화면에 보여 줄 수 있습니다. 확인 경로가 마련되어 있지 않다면 오류 문구를 고치기 전에 상태 확인 화면부터 만드는 것이 순서입니다.
메시지의 위치와 접근성을 점검합니다
같은 문구라도 어디에 보이느냐에 따라 효과가 다릅니다. 화면 맨 위에 오류가 났다는 말만 있고 실제 문제가 되는 입력란은 아래에 숨어 있으면 이용자가 직접 찾아야 합니다. 문제가 있는 항목 가까이에 이유와 해결 방법을 적고, 필요하면 화면 상단에 요약을 한 번 더 보여 줍니다.
키보드로 이동할 때 초점이 오류가 난 항목으로 옮겨 가는지, 화면 읽기 프로그램이 오류 내용을 읽어 주는지도 확인합니다. 빨간색 같은 색상만으로 상태를 구분하면 색을 구별하기 어려운 이용자는 오류를 알아차리지 못할 수 있으므로 문장이나 아이콘 설명을 함께 둡니다.
이용자용 문구와 내부 로그를 분리합니다
이용자에게 보이는 문구와 내부 기록은 목적이 다르므로 분리해서 관리합니다. 내부 코드와 발생 시각은 지원 담당자가 추적할 수 있게 기록하되, 시스템 구조를 짐작하게 하는 민감한 정보는 공개 화면에 노출하지 않습니다.
이용자에게 오류 상황을 설명하려고 화면 전체나 민감한 입력값을 캡처해 보내라고 요구하는 방식도 피하는 편이 안전합니다. 필요한 정보가 무엇인지 미리 정해 두고, 그 범위 안에서만 요청합니다.
모바일과 컴퓨터에서 실제로 시험합니다
문구를 작성했다면 실제 동작과 일치하는지 모바일과 컴퓨터에서 각각 시험합니다. 시험할 때는 입력 오류, 네트워크 끊김, 중복 제출 같은 상황을 각각 만들어 보고 화면이 어떻게 달라지는지 기록합니다. 문구에서는 다시 시도하라고 했는데 입력값이 사라지거나, 이미 접수되었다고 했는데 확인 경로가 없다면 문구가 오히려 혼란을 키웁니다.
같은 오류가 반복된다면 문구를 더 친절하게 바꾸는 데서 그치지 말고 원인을 고쳐야 합니다. 실무에서는 오류 문구 목록을 만들어 각 문구가 이용자에게 어떤 행동을 안내하는지, 그 행동이 실제로 가능한지를 정기적으로 확인하면 좋습니다.