설정
NHN 알림톡 연결 상태와 발송 결과 웹훅 등록 방법을 확인하세요.
NHN 알림톡 연결
환경변수는 .env.local 에서 관리합니다.
NHN 환경변수
● NHN_APP_KEY / NHN_SECRET_KEY 미설정
발신 프로필
—
발송 결과 웹훅
NHN이 발송 결과(수신 완료/실패)를 실시간으로 우리 서버에 알려줍니다. 등록하면 발송 내역이 자동으로 갱신됩니다.
웹훅 URL
—
시크릿 상태
● NHN_WEBHOOK_SECRET 미설정 — 모든 요청 수락 (개발 환경에서만 권장)
등록 방법
NHN Cloud 콘솔 → KakaoTalk Bizmessage → 알림톡 → 웹훅 설정 메뉴로 이동
웹훅 추가 버튼 클릭 후 이벤트 종류는 발송 결과 업데이트(MESSAGE_RESULT_UPDATE) 선택
URL: 위의 웹훅 URL을 복사해서 붙여넣기 (배포된 외부 접근 가능 URL이어야 함 — localhost 불가)
시크릿: 임의의 긴 랜덤 문자열을 입력하고, 같은 값을 우리 서버의 .env.local 에 NHN_WEBHOOK_SECRET=... 으로 저장 후 재시작
NHN이 보내는 요청의 X-Toast-Webhook-Signature 헤더가 시크릿과 일치하면 발송 내역이 자동 갱신됩니다.
로컬 개발 팁
로컬에서 웹훅을 테스트하려면 ngrok http 3000 같은 터널링 도구로 외부 접근 가능한 URL을 만들고, 그 URL 뒤에 /api/webhooks/nhn-alimtalk을 붙여 NHN 콘솔에 등록하세요. 웹훅 없이도 발송 내역 페이지에서 ‘수신 상태 새로고침’ 버튼으로 즉시 확인할 수 있습니다.
로컬에서 웹훅을 테스트하려면 ngrok http 3000 같은 터널링 도구로 외부 접근 가능한 URL을 만들고, 그 URL 뒤에 /api/webhooks/nhn-alimtalk을 붙여 NHN 콘솔에 등록하세요. 웹훅 없이도 발송 내역 페이지에서 ‘수신 상태 새로고침’ 버튼으로 즉시 확인할 수 있습니다.