알림톡 발송·운영

발송 결과 조회

발송 한 건의 상태와 실패 사유를 확인해요.

발송 응답으로 받은 receipt_id 로 그 건의 결과를 조회해요.

GEThttps://message.bootapi.com/alimtalk/messages/{receipt_id}Basic Auth

요청 파라미터

파라미터 타입 필수 설명
receipt_id String 필수 발송 접수 id (경로 파라미터)

코드 예제

curl -X GET "https://message.bootapi.com/alimtalk/messages/68b0f2a1c3d4e5f6a7b8c9d0" \
  -H "Authorization: Basic {base64(client_key:secret_key)}"bash

응답

{
  "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 로 걸러 찾아요.