콘텐츠로 이동
ReigniterDocs
웹사이트로 돌아가기

웹훅

웹훅은 다른 도구에 Reigniter 계정에서 무언가가 발생했다는 신호를 보냅니다. 이벤트가 발생하면, Reigniter 사용자가 선택한 주소로 서명된 JSON 메시지를 보냅니다. 그 주소는 자동화의 웹훅 트리거, 다른 워크플로우 도구, 또는 본인의 서버일 수 있습니다.

이벤트 구독 목록이 있는 Webhooks 페이지
구독을 추가하면 모든 이벤트가 서명된 주소로 전송됩니다 JSON.
행사 앱 내 라벨 발송 시간
video.completed 영상 완성 비디오 렌더링이 끝납니다. 메시지에는 7일간 작동하는 다운로드 링크가 포함되어 있습니다.
video.failed 영상 실패 비디오 렌더링이 실패합니다.
training.completed 학습자가 모듈을 완료했습니다 이름 있는 학습자가 모듈을 마치고 점수와 합격 여부를 확인합니다.
training.overdue 학습자 연체 학습자가 마감일까지 완료하지 못한 경우.

전체 목록은 Webhooks에 있습니다. Within Automations에서는 웹훅이 필요하지 않습니다: Reigniter 트리거(비디오 완료, 학습자 통과, 나머지)가 스스로 등록됩니다.

  1. Open Connectors > 웹훅.

  2. 추가를 선택하세요.

  3. 행사를 선택하세요.

  4. 수신해야 할 주소를 붙여넣으세요. 반드시 공용 웹 주소여야 합니다. 사설 네트워크의 주소는 거부됩니다.

  5. 추가를 선택하세요.

  6. 서명 비밀을 복사해서 안전한 곳에 보관하세요. 한 번만 보여줘요. 그다음 완료를 선택하세요.

웹훅의 테스트 버튼을 선택해 서명된 테스트 메시지를 보내세요. 주소에 도착하는지 확인하세요.

모든 메시지는 서명 비밀로 서명됩니다. 수신 도구는 메시지를 신뢰하기 전에 서명을 확인해야 하며, 다른 사람이 가짜 이벤트를 보낼 수 없습니다. 서명 확인 방법은 API 웹훅 가이드에 다루어져 있습니다.

각 메시지에는 배달 ID가 포함되어 있는데, 배달 재시도 시 동일하게 유지됩니다. 중복 메시지는 무시하는 데 사용하세요.

목록 내 각 웹훅에는 다음 버튼이 있습니다:

  • 일시정지하세요. 일시정지로 표시되고, 재개하기 전까지는 아무것도 받지 못합니다.
  • 삭제하세요.
  • Reigniter 실패한 배달을 몇 번 다시 시도합니다.
  • 웹훅은 연속으로 몇 건의 배달이 실패했는지, 예를 들어 3개가 실패했음을 보여줍니다. 성공적인 배달 시에는 카운트가 초기화됩니다.
  • 여러 번 실패하면 웹훅이 자동으로 일시정지됩니다. 주소를 수정한 후 다시 시작하세요.
  • 실패한 웹훅은 렌더링에 영향을 주지 않습니다.

웹훅은 Reigniter밖에서 이벤트를 전송합니다. 다른 도구로 동영상을 만들려면 API 키를 사용하세요. 자동화 만들기(Build an automation) 또는 API 퀵스타트(Quickstart)를 참조하세요.