버그 리포트가 놓치고 있는 WhatsApp에 존재하는 맥락

'쿠폰 사용 시 결제 실패'라는 제목의 이슈는 유용한 버그 리포트가 아닙니다. 개발자는 무언가 고장 났다는 것은 알지만, 어떤 쿠폰인지, 어떤 계정 상태인지, 어떤 브라우저를 사용했는지, 또는 실패 직전에 무엇이 발생했는지는 모릅니다.

놓치고 있는 세부 정보들은 종종 존재합니다. 그것들은 WhatsApp에, 지원팀과 고객 사이의 대화 속에 있습니다. 이슈 트래커에는 결론만 접수되었을 뿐, 그 결과로 이어진 단계들을 담은 대화 기록이 남아있습니다.

이러한 간극은 예측 가능한 순환 고리를 만듭니다. 지원팀이 문제를 요약합니다. 개발팀은 재현 단계를 요청합니다. 지원팀은 고객에게 다시 연락합니다. 고객은 이미 말했던 것을 반복합니다. 모두가 기다립니다.

이슈 트래커는 시간의 흐름을 포착하지 못한다

버그 트래커는 확정된 상태(affected area, 우선순위, 소유자, 최종 수정)를 저장하는 데는 능숙합니다. 하지만 보고서가 생성되는 복잡한 순서를 보존하는 것은 상대적으로 미흡합니다.

고객은 결제 방식을 변경한 후에만 문제가 발생한다고 언급할 수 있습니다. 다른 고객은 앱 업데이트 이후에 오류가 시작되었다고 말할 수 있습니다. 또 다른 고객은 버그의 실제 경계를 보여주는 임시 해결책(workaround)을 설명할 수도 있습니다. 채팅 속 한 문장이 몇 시간 동안의 추측을 없앨 수 있습니다.

이것은 단순히 지원팀만의 문제가 아닙니다. 회귀(regressions)를 검토하는 개발자, 테스트 케이스를 작성하는 QA 담당자, 그리고 이전 수정 사항이 왜 유지되지 않았는지 이해하려는 모든 사람에게 영향을 미칩니다.

이슈가 실제로 필요로 하는 것을 결정하라

대화를 내보내기(export) 전에, 티켓에 포함되어야 할 필드들을 적어봅니다.

• 재현 단계 (Steps to reproduce)
• 예상 동작 및 실제 동작 (Expected and actual behavior)
• 환경 또는 장치 세부 정보 (Environment or device details)
• 영향받는 사용자 또는 범위 (Affected users or scope)
• 임시 해결책 및 미해결 질문 (Workarounds and open questions)

목표는 모든 메시지를 전송하는 것이 아닙니다. 보고서를 실행 가능하게 만드는 세부 정보들을 복구하는 것입니다.

내보낼 범위를 리포트 주변의 기간으로 좁히세요. 만약 문제가 출시 이후나 특정 고객 행동 후에 시작되었다면, 그 시점부터 시작하세요. 광범위한 내보내는 것은 개인정보 위험을 증가시키고 관련 메시지를 찾기 어렵게 만듭니다.

Chrome에서 WhatsApp Web을 사용하는 팀의 경우, WhatsApp Chat Export - WA Download를 사용하여 개별 채팅과 그룹 대화를 내보낼 수 있습니다. 이 도구는 날짜 범위 선택 기능과 다운로드 전 미리보기를 제공합니다. 사용 가능한 형식에는 PDF, TXT, HTML, CSV, Excel, JSON이 포함됩니다. 목록에 따르면, 내보낸 콘텐츠는 브라우저에서 로컬로 처리되며 복잡한 API 설정이 필요하지 않습니다.

대화를 읽는 데 유용하다면 PDF나 TXT가 적합합니다. 응답을 정리하거나 여러 보고서를 비교해야 하는 경우 CSV, Excel 또는 JSON이 더 실용적입니다. 형식은 검토 프로세스를 따라야 하며, 그 반대가 되어서는 안 됩니다.

대화를 엔지니어링 아티팩트로 재작성하기

원시 채팅 내보내기(raw chat export)는 증거일 뿐, 이슈 설명이 아닙니다.

고객이 결제 버튼이 한 번은 작동하다가 배송 주소를 변경한 후 실패했다고 말하는 지원 대화를 상상해 보세요. 유용한 이슈 요약은 다음과 같을 수 있습니다:

배송 주소 변경 시 검토 단계에서 결제 버튼이 응답하지 않게 됩니다. 이 문제는 Android용 Chrome에서 보고되었습니다. 한 고객은 페이지를 새로고침하면 버튼이 복구되지만, 주문 시 선택한 배송 옵션을 잃는다는 것을 발견했습니다.

이 요약 정보는 개발자에게 어디를 살펴봐야 할지 알려줍니다. 또한 QA(품질 보증)에게 테스트 케이스를, 지원팀에게 더 명확한 답변을 제공합니다.

원래 내보낸 자료는 참고용으로만 유지하세요. 사적인 메시지를 공개 이슈에 붙여넣기보다는 관련 대화를 링크하거나 티켓과 함께 저장하세요. 내보내기 날짜와 해당 내용이 무엇인지 설명하는 짧은 메모를 추가하세요.

개인 데이터를 버그의 일부로 취급하기

지원 대화에는 이름, 전화번호, 주소, 결제 정보, 주문 번호 및 내부 메모가 포함될 수 있습니다. 이러한 자료를 트래커에 옮긴다고 해서 공유하기 적절해지는 것은 아닙니다.

재현에 필요한 것이 아닌 내용은 모두 제거하세요. 가능하다면 개인 식별 정보를 역할(role)로 대체하십시오. 스크린샷이나 첨부 파일이 개인 정보를 포함하는 경우, 분리하여 보관하십시오. 로컬 처리(Local processing)는 내보내기가 발생하는 위치만을 설명할 뿐, 누가 그 결과를 볼지 결정하지 않습니다.

또한 증거(evidence)와 허가(permission)를 구분할 가치가 있습니다. 고객이 지원팀과 메시지를 공유한다고 해서 그것을 공개 저장소에 복사하거나, 공급업체와 공유하거나, 장기간 보관되는 티켓에 첨부하는 것에 자동으로 동의하는 것은 아닙니다.

작고 반복 가능한 습관으로 만드세요

보고서가 조사되어야 할 때, 관련 대화를 캡처하고, 재현 세부 정보를 추출하여 이슈(issue)에 작성하십시오. 원본 내보내기 파일은 통제된 위치에 보관하십시오. 더 이상 필요하지 않을 때는 삭제하십시오.

버그 트래커(bug tracker)가 진실의 출처(source of truth)로 남아 있어야 합니다. WhatsApp는 그곳으로 가는 맥락을 제공해야 합니다. 이러한 구분이 엔지니어링 팀이 고객이 무엇을 의미했는지 하루 종일 묻는 대신 문제에 집중하도록 유지시켜 줍니다.