테스트·시크릿

알림톡 웹훅 테스트 이벤트를 발송하고 서명 시크릿을 재발급합니다.

1테스트 이벤트 발송

설정한 URL 로 더미 이벤트를 1건 보냅니다. 실제 이벤트와 같은 경로​(큐·서명·재시도)를 거칩니다.

실제 HTTP 요청이 나갑니다

설정된 수신 URL 로 실제 요청이 갑니다. 구독 여부와 무관하고, 웹훅이 꺼져 있어도(enabled: false, 연속 실패로 자동 비활성된 경우 포함) 보냅니다.

POSThttps://message.bootapi.com/alimtalk/webhook/testBasic Auth

코드 예제

curl -X POST "https://message.bootapi.com/alimtalk/webhook/test" \
  -H "Authorization: Basic {base64(client_key:secret_key)}"bash

응답

{
  "delivery_id": "68b0f2a1c3d4e5f6a7b8c9e1",
  "url": "https://example.com/hooks/alimtalk",
  "queued": true
}json

delivery_id 로 전송 이력에서 결과를 확인할 수 있습니다. payload 는 발송 성공(301) 이벤트 모양의 더미 카드이고 tags 에 test 가 들어 있습니다. 실제 카드와 달리 created_at 이 없으므로, 파서가 이 필드를 필수로 보면 테스트에서만 실패할 수 있습니다.

2서명 시크릿 재발급

POSThttps://message.bootapi.com/alimtalk/webhook/secretBasic Auth

코드 예제

curl -X POST "https://message.bootapi.com/alimtalk/webhook/secret" \
  -H "Authorization: Basic {base64(client_key:secret_key)}"bash

응답

{
  "configured": true,
  "url": "https://example.com/hooks/alimtalk",
  "events": [301, 302, 303, 310, 311],
  "enabled": true,
  "secret": "whsec_1a2b3c4d5e6f7a8b9c0d1e2f3a4b5c6d7e8f9a0b1c2d3e4f5a6b7c8d9e0f1a2b",
  "last_sent_at": "2026-08-27 10:00:05 +0900",
  "last_status": 200,
  "consecutive_failures": 0,
  "auto_disabled_at": null,
  "retry_count": 10
}json

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

원문은 이 응답에서만 보입니다

재발급 응답에서만 secret 이 마스킹 없이 내려옵니다. 이후 설정 조회에서는 앞 12자만 보이므로 바로 안전한 곳에 저장합니다.

큐에 있는 건은 예전 시크릿으로 서명됩니다

재발급 시점에 이미 큐에 들어간 전송 건은 발송 당시 시크릿으로 서명됩니다. 교체 직후 잠시 두 시크릿을 모두 허용하도록 수신 서버를 구성하면 검증 실패를 피할 수 있습니다.

수신 URL 을 저장하지 않아도 발급받을 수 있습니다

발송마다 webhook_url 을 실어 보내는 경우 프로젝트 수신 URL 이 필요 없습니다. 그때도 이 API 로 서명 검증용 시크릿만 받아 둘 수 있고, 설정 조회는 configured: false 로 나옵니다. 반대로 위의 테스트 발송은 보낼 곳이 있어야 하므로 수신 URL 을 먼저 저장해야 합니다.

에러 코드

코드 error_code 메시지 대처 방법
3029 WEBHOOK_NOT_CONFIGURED 웹훅 미설정 테스트 발송​​에만 발생합니다. 웹훅 설정에서 URL 을 먼저 저장합니다. 시크릿 재발급은 설정 없이도 가능합니다

함께 보기