Webhook Notifier
EmDash CMS에서 콘텐츠가 바뀔 때 나가는 웹훅 알림을 보냅니다.
플러그인
Webhook Notifier
EmDash CMS에서 콘텐츠가 바뀔 때 나가는 웹훅 알림을 보냅니다.
제품 상세
- 카테고리
- 자동화
- 상태
- 사용 가능
- 버전
- 베타에 포함
Webhook Notifier는 콘텐츠가 변경될 때 하류 시스템으로 신호를 밀어 보냅니다. 검색 색인, 채팅 알림, CI 파이프라인, 맞춤 검토 도구 등입니다. 구현은 packages/plugins/webhook-notifier에 있습니다.
설치
- HTTPS를 사용하고 요청을 인증하는 수신 엔드포인트를 선택합니다(공유 비밀, HMAC 서명, mTLS 등 — 사용 중인 플러그인 버전이 지원하는 방식에 맞춤).
- 관리자에서 플러그인을 켜고 비프로덕션 프로젝트에 첫 엔드포인트 URL을 등록합니다.
- 테스트 이벤트를 발생시키고(예: 초안 저장) 수신 측이 예상 페이로드를 기록하는지 확인합니다.
구성
일반 설정:
- 이벤트 필터 — 어떤 컬렉션이나 전환이 웹훅을 쏘는지(create, update, publish, delete).
- 페이로드 형태 — JSON에 id, slug, 타임스탬프, 행위자가 포함되는 경우가 많음. 버전 문서의 스키마와 대조.
- 재시도 정책 — 수신기가 다운됐을 때 지수 백오프와 데드 레터.
예(개념): 인덱서가 다음과 같은 JSON POST를 기대할 수 있습니다.
{
"event": "publish",
"collection": "posts",
"slug": "launch-notes",
"url": "https://example.com/blog/launch-notes",
"occurredAt": "2026-04-04T12:00:00.000Z"
}
키와 URL은 실제 릴리스가 보내는 내용으로 바꾸고, 프로덕션에 의존하기 전 라이브 로그로 검증하세요.
사용 시나리오
- 검색 — Algolia, Typesense 또는 내부 인덱서에 변경된 URL을 다시 가져오라고 알림.
- Slack 또는 Teams — 노출이 큰 페이지가 바뀔 때 편집자에게 가벼운 알림.
- 배포 훅 — 콘텐츠가 게시될 때 정적 재빌드나 엣지 캐시 무효화 트리거.
운영 팁
- 전달 실패를 기록하고 지속적인 오류율에 알림을 걸세요.
- 공유 비밀은 다른 연동 자격 증명과 같은 주기로 교체하세요.
- 무한 루프를 피하세요 — 멱등 키 없이 웹훅 핸들러가 EmDash에 다시 써서 자기 자신을 다시 쏘지 않도록 하세요.