다른 시스템으로 이벤트를 전송하려면 어떻게 하나요?

위치: Settings → Advanced → Connect other apps

해당 페이지 열기: admin.<your-site>/settings/integrations/webhooks (<your-site> 부분을 사이트 주소로 변경하세요). 메뉴에 보이지 않으면 Settings 페이지에서 모든 설정 보기을 켜세요.

시작 전 확인사항

• 사이트 소유자만 웹훅을 추가할 수 있습니다.
• 수신 주소는 반드시 https://로 시작해야 하며 공개 인터넷에서 접근 가능해야 합니다.

진행 방법

1. 설정 → 고급 설정 → 다른 앱 연동 → 웹훅을 엽니다.
2. 웹훅 추가을 누릅니다.
3. 이름(예: Zapier)과 메시지를 받을 주소을 입력합니다.
4. 알림을 받을 이벤트 아래에서 전송할 이벤트를 선택합니다: 새 기사 게시됨, 게시된 기사 수정됨, 기사 게시 중단됨, 정정 보도 추가됨, 기사 삭제·철회됨, 새 댓글 등록됨, 구독 상태 변경됨.
5. 웹훅 추가을 누릅니다.
6. 서명 암호(signing secret)를 복사합니다. 한 번만 표시됩니다. 저장했습니다을 누릅니다.
7. 테스트 이벤트 전송을 테스트해 봅니다.

참고 사항

• 모든 메시지는 서명되어 발송됩니다. 사이트에서 보낸 것이 맞는지 "Keynate-Signature" 헤더를 확인하세요.
• 수신 시스템에서 메시지를 정상적으로 받으면 2xx 상태 코드로 응답해야 합니다.
• 전송 실패한 메시지는 최대 24시간 동안 재시도합니다. 3일 연속 실패한 웹훅은 자동으로 비활성화됩니다. 수신 서버 문제를 해결한 후 다시 시작을 누르세요.
• 언제든지 일시 중지, 다시 시작을 하거나 새 비밀 키을 생성할 수 있습니다. 기존 암호는 직접 지정한 유예 기간 동안 서명 검증에 계속 사용할 수 있습니다.
• 목록에서 각 웹훅의 상태를 확인할 수 있습니다: 정상 작동 중, 아직 사용 안 됨, 작동 안 함, 일시 중지됨, 꺼짐.
• 발송된 메시지를 열어 재시도 내역을 확인하고 다시 보내기을 누를 수 있습니다.

자주 발생하는 문제

• "주소는 반드시 https://."로 시작해야 합니다"
• "웹훅 이름을 입력하세요."
• "이벤트를 하나 이상 선택하세요."
• "생성 가능한 최대 웹훅 개수에 도달했습니다. 더 이상 사용하지 않는 웹훅을 먼저 삭제하세요."

자주 묻는 질문

관련 도움말

• 다른 앱 연결하기
• API 키