웹훅 구성

이런 경우에 사용합니다

Teamspace에서 어떤 일이 발생했을 때 자체 시스템이 반응하도록 하고 싶은 경우, 예를 들어 사진 업로드를 기록하거나 후속 작업을 시작하려는 경우에 사용합니다. 웹훅을 사용하면 선택한 이벤트가 발생할 때마다 Timemark가 사용자의 엔드포인트로 POST 요청을 보냅니다.

필요한 사항

역할

팀 소유자

플랫폼

Web

요금제

Business

적용 대상

웹훅 생성 이후에 발생하는 이벤트에 대해서만 실행됩니다

웹훅 설정

1. Teamspace → 설정 → 통합 → 웹훅으로 이동합니다.
2. 엔드포인트 URL을 입력합니다. 공개적으로 접근 가능해야 하며 POST 요청에 응답해야 합니다.
3. 트리거를 확인합니다. 새 사진이 업로드되면 웹훅은 새 사진에서 실행됩니다.
4. 범위를 선택합니다: 모든 사진 또는 특정 폴더.
5. 저장합니다.

전송 테스트

1. 방금 저장한 웹훅에서 테스트 또는 핑 기능을 사용하여 샘플 페이로드를 전송합니다.
2. 엔드포인트 로그를 확인하여 페이로드가 도착했는지 확인합니다.
3. 엔드포인트가 2xx 응답을 반환했는지 확인합니다.

구성할 수 있는 필드

Field	What it does	Notes
엔드포인트 URL	Timemark가 POST 요청을 보내는 위치	공개적으로 접근 가능해야 하며 제한 시간 내에 2xx를 반환해야 합니다
트리거	전송을 실행하는 작업	새 사진(photo.uploaded)이 현재 유일한 트리거입니다. 웹훅 이벤트 유형 참조
범위	하나의 폴더 또는 전체 팀 사진으로 실행을 제한	폴더 범위는 해당 폴더의 사진에 대해서만 실행됩니다

자주 발생하는 실수

• 소급 실행되지 않습니다. 웹훅은 생성된 이후의 이벤트에 대해서만 실행됩니다. 기존 사진은 트리거되지 않습니다.
• 엔드포인트는 제한 시간 내에 2xx를 반환해야 합니다. 시간 초과 또는 오류는 전송 실패로 처리됩니다. Timemark는 실패한 전송을 재시도하며, 재시도 횟수를 모두 소진하면 중단합니다.
• 범위 불일치. 하나의 폴더로 범위가 지정된 웹훅은 다른 폴더의 사진에 대해 실행되지 않습니다. 모든 폴더가 필요하면 범위를 모든 사진으로 설정합니다.
• 방화벽 뒤에 있는 경우. VPN이나 방화벽 뒤에 있는 엔드포인트는 접근할 수 없습니다. 공개적으로 접근 가능한 URL을 사용합니다.

관련 문서

• 웹훅 이벤트 유형
• 웹훅 페이로드 참조

마지막 업데이트: 2026년 6월 28일