사진은 저장됐는데 안내는 끝나지 않았어요
제작사진 안내가 발송되지 않았다는 문의를 받았어요. 주문 연결과 사진 저장은 정상이고 카카오 알림톡 접수 기록도 있었지만, 시스템은 결과를 확인해야 하는 상태로 남아 있었어요. 문자 대체발송과 시트의 완료 체크도 진행되지 않았고요.
발송사의 수신자별 상세 결과에는 ‘메시지를 전송할 수 없는 상태’라는 응답이 있었어요. 이 응답을 확정 실패로 읽지 못하면서, 실패했을 때만 실행하는 문자 전환 경로에 들어가지 못한 상황이었어요.
여기서는 두 원인을 나눠 확인했어요. 카카오가 해당 수신자에게 전송하지 못한 세부 이유는 그 응답만으로 확정할 수 없었어요. 반면 프로그램이 문자로 전환하지 못한 이유는 응답 분류 누락으로 재현할 수 있었어요.
접수 이후에 무엇을 알 수 있는지 나눴어요
외부 요청이 시간 초과로 끝났다고 해서 실제 접수도 실패했다고 볼 수는 없어요. 이미 받아 처리하고 있는데 응답만 놓쳤을 수 있어요. 이런 건까지 문자로 바꾸면 같은 고객에게 두 안내가 도착할 수 있죠.
| 확인된 상태 | 다음 행동 |
|---|---|
| 접수됐지만 최종 결과는 아직 없음 | 기존 시도의 결과 계속 조회 |
| 성공 결과 확인 | 완료 처리 후 시트 반영 |
| 수신자와 최종 응답을 확인한 확정 실패 | 정책 재검증 후 문자 전환 검토 |
| 시간 초과·잘못된 응답·알 수 없는 코드 | 결과 불명확으로 보류, 자동 재접수하지 않음 |
기존 접수 결과를 확인하는 작업과 새로운 발송 요청을 만드는 작업을 구분했어요. 결과 조회를 다시 하는 것이 곧 재발송은 아니에요.
실제 응답을 최소한의 재현 자료로 바꿨어요
문제가 된 발송사 응답에서 개인정보를 가상 번호로 바꾸고 결과 해석 함수를 실행했어요. 이 연동의 응답 코드 8, 상태 3, 응답 시각과 ‘메시지를 전송할 수 없는 상태’라는 사유가 함께 있었는데, 함수는 확정 실패 대신 uncertain을 반환했어요.
원인은 기존 판별이 비슷한 전송 불가 문구는 알고 있지만 실제로 반환된 정확한 표현을 포함하지 못한 데 있었어요. 이전에 ‘최근 카카오톡을 미사용자’라는 응답을 보완한 사례도 있어, 문구 일부가 비슷하다는 이유로 실패 범위를 넓히지 않도록 했어요.
수정은 수신자 일치, 응답 시각, 처리 중 상태가 아니라는 기존 검사를 통과하고 코드·상태·정확한 사유가 모두 맞는 조건으로 한정했어요. 여기의 숫자는 해당 발송사 응답 규격이에요. 카카오의 다른 API에서 같은 숫자가 같은 의미라고 가정하지 않았어요.
문자 전환도 기존 시도 안에서 처리했어요
새 주문을 등록하거나 기존 접수 기록을 삭제해 발송을 다시 시작하지 않았어요. 이미 남아 있는 카카오 접수 기록에 실패 결과를 보존하고, 기존 문자 전환 경로로 이어가도록 했어요.
전환 전에는 발송사 결과를 다시 확인하고 현재 주문·연락처·채널, 운영시간, 발송 ON/OFF와 제외 정책을 재검증해요. 최초 접수 때 정상이었다고 해도 그 사이 주문이나 운영 설정이 바뀔 수 있기 때문이에요.
발송사의 자체 문자 대체 기능은 꺼 두고 프로그램이 대체 접수를 한 번 관리해요. 여러 워커가 동시에 결과를 확인하거나 서버가 재시작돼도 같은 작업의 기록과 잠금을 사용해 추가 접수를 막아요. 대체 문자 결과까지 불명확하면 또 다른 접수를 만들지 않아요.
업무 흐름
- 01기존 카카오 최종 결과 재확인
- 02확정 실패·현재 정책 확인
- 03문자 대체 시도 한 번 기록
- 04문자 최종 결과 조회
- 05성공 후 시트 완료 반영
시트 체크는 마지막 성공 뒤에 바뀌어야 했어요
문자 발송을 요청했다는 사실만으로 시트를 완료 처리하지 않아요. 발송사의 최종 성공 결과를 확인한 다음 제작사진 완료 체크를 반영해요.
문자는 성공했는데 시트 쓰기가 실패하면, 문자 단계로 돌아가는 대신 시트 기록만 다시 처리해요. 현재 행이 다른 주문으로 바뀌었다면 억지로 체크하지 않고 확인 대상으로 남기고요. 고객 안내의 결과와 업무 화면의 표시를 따로 복구할 수 있어야 했어요.
바꿔야 하는 응답과 그대로 멈춰야 하는 응답
회귀 검증에서는 응답 해석 함수만 통과시키는 데서 끝내지 않았어요. 기존 결과 불명확 항목에 새 해석을 적용한 뒤, 병렬 결과 조회와 문자 전환을 거쳐 접수가 한 번인지, 최종 성공 뒤 시트 반영도 한 번인지 확인했어요.
| 재현 조건 | 확인한 결과 |
|---|---|
| 확인된 코드·상태·사유와 올바른 수신자 | 확정 실패로 분류해 기존 전환 경로 사용 |
| 응답 시각 없음·아직 처리 중 | 최종 실패로 확정하지 않음 |
| 다른 코드나 사유·다른 수신번호·중복된 수신자 결과 | 조건을 넓혀 임의 전환하지 않음 |
| 여러 실행이 같은 결과를 동시에 재확인 | 문자 대체 접수 한 번 |
| 문자 성공 후 결과를 다시 조회 | 추가 발송 없이 완료 상태 유지 |
| 문자 성공 뒤 시트 기록만 실패 | 발송 대신 시트 기록 복구 |
운영에서는 해당 응답으로 멈춘 한 건의 기존 기록을 대조하고, 수정 반영 뒤 사진문자의 최종 성공과 실제 시트 완료 체크를 확인했어요. 이는 한 건의 복구 기록이며, 카카오에서 전송할 수 없었던 상세 원인을 새로 알아냈다는 뜻은 아니에요.
결과가 불명확할 때 멈추는 규칙은 유지해야 했어요. 이번에 고친 것은 이미 확정할 수 있는 실패를 놓친 판별이었어요. 상태를 엄격하게 나누어야 멈춰야 할 건은 멈추고, 근거가 있는 건은 기존 이력 안에서 복구할 수 있었어요.