전송 이력

알림톡 웹훅이 실제로 전송된 이력을 조회합니다. 성공·실패를 모두 남깁니다.

GEThttps://message.bootapi.com/alimtalk/webhook/deliveriesBasic Auth

요청 파라미터

파라미터 타입 필수 설명
page Integer 선택 페이지 번호 (기본 1)
limit Integer 선택 페이지 크기 (기본 20, 최대 100)

코드 예제

curl -X GET "https://message.bootapi.com/alimtalk/webhook/deliveries?limit=20" \
  -H "Authorization: Basic {base64(client_key:secret_key)}"bash

전송 상태 (status)

키 값 설명
done 1 전송 성공
ready 2 전송 대기
doing 3 전송 중
failed -1 전송 실패
알려진 문제 — status 가 항상 ready 로 옵니다

현재 전송이 성공하거나 실패해도 status 가 바뀌지 않고 "ready" 로 남습니다. 성공한 전송은 더 이상 재시도하지 않아 retry_count 가 그 자리에 머무르고, 실패하면 재시도마다 늘어납니다. 프로젝트의 가장 최근 전송 결과는 설정 조회의 last_status(HTTP 상태)·consecutive_failures 로 확인합니다.

응답

최신순으로 내려옵니다.

{
  "list": [
    {
      "delivery_id": "68b0f2a1c3d4e5f6a7b8c9e1",
      "event": "alimtalk.send.succeeded",
      "event_code": 301,
      "url": "https://example.com/hooks/alimtalk",
      "status": "ready",
      "retry_count": 1,
      "max_retry": 10,
      "tags": ["68b0f2a1c3d4e5f6a7b8c9d0", "order-20260827-0001", "G_RESTOCK_NOTICE_user"],
      "created_at": "2026-08-27 10:00:05 +0900"
    }
  ],
  "count": 1,
  "page": 1,
  "per": 20
}json
필드 설명
delivery_id 전송 건 식별자
event · event_code 이벤트 별칭과 코드
url 전송한 수신 URL
status 전송 상태
retry_count · max_retry 시도 횟수와 상한. retry_count 는 성공한 시도도 세서, 첫 시도에 성공하면 1 입니다. max_retry 는 그 건이 만들어질 때 설정의 retry_count 값이고, retry_count 가 여기에 이르면 더 보내지 않습니다
tags 추적용 태그. 발송 건이면 receipt_id·ref_id·template_code, 테스트면 test

created_at 의 형식은 응답의 시각 형식을 참고합니다.

태그로 특정 발송을 추적합니다

tags 에 receipt_id 와 ref_id 가 들어 있어, 어떤 발송으로 나간 웹훅인지 역으로 찾을 수 있습니다.

재시도 상태 확인

retry_count 가 1 을 넘어 계속 올라가면 수신 서버가 2xx 를 돌려주지 않고 있다는 뜻입니다. 연속 실패가 10회(기본값)에 이르면 웹훅이 자동 비활성화되므로 설정 조회의 consecutive_failures·auto_disabled_at 도 함께 확인합니다.

함께 보기