피드로 돌아가기
Dev.toBackend
원문 읽기
SMS API success 응답과 실제 메시지 도착 간의 갭을 bx_message_id 기반 추적으로 해소함
SMS API returned success but the message never arrived: track SMS delivery in Python
AI 요약
Context
SMS API가 success 응답을 반환하더라도 이는 요청이 큐에 등록되었음을 의미할 뿐 실제 도착을 보장하지 않음. 대부분의 SMS 서비스가 submission 시점까지만 추적하여 메시지 배송 이후 상태가 블라인드 되는 문제가 있음.
Technical Solution
- bx_message_id 추출: SMS 전송 응답에서 messages[0].bx_message_id 값을 파싱하여 추적 식별자로 활용함
- DLR 조회 API: GET /api/v1/dlr/{bx_message_id} 엔드포인트로 실시간 배송 상태를 확인함
- 메시지 상태 모니터링: QUEUED, DELIVERED, FAILED 등 lifecycle 전체를 관찰 가능함
- BridgeXAPI 연동: Python requests 라이브러리로 인증 헤더(X-API-KEY)와 함께 API 호출함
Impact
수치 기반 성과는 제공되지 않음.
Key Takeaway
API success 응답과 메시지 도착은 다른 개념임. SMS 서비스에서는 bx_message_id 기반 delivery observability 구축이 필수적임.
실천 포인트
Python 기반 SMS 연동 시 전송 성공 응답 수신 후 bx_message_id를 별도 저장하고, 주기적 DLR 조회를 통해 QUEUED/DELIVERED/FAILED 상태를 추적하는 파이프라인을 구현해야 함