발송 응답으로 받은 receipt_id 로 그 건의 결과를 조회해요.
요청 파라미터
| 파라미터 | 타입 | 필수 | 설명 |
|---|---|---|---|
receipt_id |
String | 필수 | 발송 접수 id (경로 파라미터) |
코드 예제
curl -X GET "https://message.bootapi.com/alimtalk/messages/68b0f2a1c3d4e5f6a7b8c9d0" \
-H "Authorization: Basic {base64(client_key:secret_key)}"bashrequire 'bootpay'
commerce = BootpayStore::RestClient.new(client_key: 'your-commerce-client-key', secret_key: 'your-commerce-secret-key')
response = commerce.alimtalk_message_detail(receipt_id: '68b0f2a1c3d4e5f6a7b8c9d0')
puts response.data[:status]ruby응답
{
"receipt_id": "68b0f2a1c3d4e5f6a7b8c9d0",
"ref_id": "order-20260827-0001",
"to": "01012345678",
"template_code": "G_RESTOCK_NOTICE_user",
"status": "success",
"error_code": null,
"error_message": null,
"reserved_at": null,
"executed_at": "2026-08-27T10:00:03+09:00",
"delivered_at": "2026-08-27T10:00:05+09:00"
}json목록과 같은 카드에서 created_at 만 빠진 형태예요. 단건·목록·웹훅이 같은 스키마를 쓰기 때문에 파서를 하나로 둘 수 있어요. 각 필드의 뜻은 발송내역 목록을, 시각 필드 형식은 응답의 시각 형식을 봐요.
상태 값 (status)
| 키 | 의미 |
|---|---|
requested |
접수됨. 전송 중이거나 예약 대기 중이에요 |
success |
전달됐어요 |
failed |
실패했어요. error_code·error_message 를 봐요 |
canceled |
예약 취소됐어요 |
에러 코드
| 코드 | error_code | 메시지 | 대처 방법 |
|---|---|---|---|
3025 |
MESSAGE_RECEIPT_NOT_FOUND |
발송 기록 없음 | receipt_id 가 맞는지, 이 프로젝트의 건인지 확인해요 |
ref_id 로도 찾을 수 있어요
receipt_id 를 저장해 두지 않았다면 발송내역 목록에서 ref_id 로 걸러 찾아요.
