Webhook Notifier

EmDash CMS에서 콘텐츠가 바뀔 때 나가는 웹훅 알림을 보냅니다.

플러그인

Webhook Notifier

EmDash CMS에서 콘텐츠가 바뀔 때 나가는 웹훅 알림을 보냅니다.

  • 카테고리: 자동화
  • 상태: 사용 가능
  • 버전: 베타에 포함
  • 가격: 베타에 포함

제품 상세

카테고리
자동화
상태
사용 가능
버전
베타에 포함

Webhook Notifier는 콘텐츠가 변경될 때 하류 시스템으로 신호를 밀어 보냅니다. 검색 색인, 채팅 알림, CI 파이프라인, 맞춤 검토 도구 등입니다. 구현은 packages/plugins/webhook-notifier에 있습니다.

설치

  1. HTTPS를 사용하고 요청을 인증하는 수신 엔드포인트를 선택합니다(공유 비밀, HMAC 서명, mTLS 등 — 사용 중인 플러그인 버전이 지원하는 방식에 맞춤).
  2. 관리자에서 플러그인을 켜고 비프로덕션 프로젝트에 첫 엔드포인트 URL을 등록합니다.
  3. 테스트 이벤트를 발생시키고(예: 초안 저장) 수신 측이 예상 페이로드를 기록하는지 확인합니다.

구성

일반 설정:

  • 이벤트 필터 — 어떤 컬렉션이나 전환이 웹훅을 쏘는지(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에 다시 써서 자기 자신을 다시 쏘지 않도록 하세요.