웹훅을 사용하면 워크스페이스에서 어떤 일이 일어나는 순간 Scribe가 자체 시스템에 즉시 알릴 수 있어요. 전환이 기록되거나, 서명이 게시되거나, 팀원이 합류하거나 나가거나, 캠페인이 시작되는 시점에 알림이 전달됩니다. 도구가 Scribe에 업데이트를 물어보는 것이 아니라, Scribe가 즉시 푸시하는 방식이에요.
이를 통해 팀은 서명 기반 전환을 CRM에 동기화하고, 사서함에 서명 설치가 실패하면 IT에 알림을 보내며, 팀원 변경 사항을 내부 시스템에 반영할 수 있어요.
웹훅은 Scribe API의 일부이며 API 액세스가 포함된 요금제가 필요해요. 워크스페이스 소유자와 관리자만 관리할 수 있어요.
웹훅 관리
설정 → 웹훅(기술 섹션)을 여세요. 이 페이지에는 워크스페이스에 구성된 모든 엔드포인트와 각 엔드포인트가 구독 중인 이벤트, 현재 상태가 표시돼요.
웹훅 관리를 클릭하면 워크스페이스의 웹훅 포털이 열리며, 다음 작업을 할 수 있어요:
- 엔드포인트 추가. 시스템이 노출하는 HTTPS URL이나 자동화 도구의 URL을 등록하세요.
- 이벤트 선택. 엔드포인트를 특정 이벤트 유형에 구독하거나, 전체 이벤트에 구독하세요.
- 전송 확인. 모든 전송 시도, 응답, 실패한 요청의 재시도를 확인할 수 있어요.
- 시크릿 관리. 각 엔드포인트에는 서명용 시크릿이 있어서, 시스템이 알림이 실제로 Scribe에서 온 것인지 확인할 수 있어요.
전송에 실패하면 약 하루 동안 점점 긴 간격으로 자동 재시도되므로, 짧은 장애가 발생해도 데이터가 유실되지 않아요.
개발자용
수신 측을 구축 중이신가요? 웹훅 개발자 문서에서 서명 검증, 전송 방식, 페이로드 예시가 포함된 전체 이벤트 카탈로그를 확인할 수 있어요. 웹훅 활용 사례에서는 팀에서 가장 자주 구축하는 워크플로를 코드와 함께 살펴볼 수 있어요. 
