Webhooks

Webhooks를 통해 Shifton은 회사에서 이벤트가 발생할 때 외부 시스템에 실시간 알림을 전송할 수 있습니다.

단계별 안내

왼쪽 사이드바에서 통합를 클릭합니다.

개발자

페이지 → 웹훅 탭으로 이동합니다.

«새 웹훅»

를 클릭합니다.

설정을 입력합니다:

저장합니다. Shifton이 지정된 URL로 HTTP POST 요청을 전송합니다.

webhook를 클릭하여 URL을 편집하거나 이벤트를 업데이트하거나 활성 상태를 변경합니다.

Shifton에서 해당 이벤트를 트리거합니다 (예: 테스트 교대 생성).

서버 로그를 확인합니다 — 데이터가 도착해야 합니다.

Q: 교대근무on이 데이터를 어떤 형식으로 전송합니까?
JSON 본문이 포함된 HTTP POST입니다. 각 이벤트 유형별 데이터 구조는 API 문서를 참조하십시오.

Q: 하나의 이벤트에 여러 webhook를 만들 수 있습니까?
예, 다른 URL로 가능합니다.

Q: webhook 트리거 시 서버가 사용 불가능하면 어떻게 됩니까?
전송이 실패할 수 있습니다. 재시도 정책에 대한 자세한 내용은 API 문서를 참조하십시오.

Q: Webhook가 작동하지 않습니다 — 왜 그렇습니까?
활성 토글이 켜져 있고 URL이 공개적으로 접근 가능한지 확인하십시오.

Q: Webhook가 데이터를 수신하는지 어떻게 확인합니까?
Shifton에서 테스트 이벤트를 만들고 (예: 교대 추가) 서버 로그에서 수신 POST 요청을 확인합니다.

Q: Webhook 인증을 설정할 수 있습니까?
예. Webhook URL이나 헤더에 비밀 키 또는 토큰을 추가합니다. 자세한 내용은 API 문서를 참조하십시오.

Q: Webhook 요청 본문은 어떻게 생겼습니까?
이벤트 데이터가 포함된 JSON 객체입니다. 구조는 이벤트 유형에 따라 다릅니다 — 예시는 API 문서를 참조하십시오.

Q: 하나의 webhook에서 여러 이벤트를 추적할 수 있습니까?
예. Webhook 생성 시 여러 이벤트를 선택하면 하나의 URL이 선택된 모든 이벤트에 대한 알림을 수신합니다.

Q: Webhook의 «재시도 정책»이란 무엇입니까?
서버가 오류를 반환하면 (200이 아닌 경우) Shifton이 요청을 재시도할 수 있습니다. 세부 사항은 플랫폼 구성에 따라 다릅니다.

Q: Webhook 수에 제한이 있습니까?
문서에 수량 제한은 명시되어 있지 않지만 필요한 것만 만드는 것이 권장됩니다.

Q: Webhook URL에 HTTPS를 사용해야 합니까?
권장됩니다. HTTP 주소도 작동할 수 있지만 HTTPS가 안전한 데이터 전송을 보장합니다.

Q: 스케줄 변경 시마다 webhook 알림을 받을 수 있습니까?
예. Webhook 설정 시 «교대 근무 생성됨» 또는 «schedule updated» 유형의 이벤트를 추가합니다.

Q: Webhook를 만들 수 있는 접근 권한이 있는 사람은 누구입니까?
Owner 및만 가능합니다. 매니저와 직원은 Developer 섹션을 볼 수 없습니다.

Q: Webhook를 삭제하지 않고 비활성화할 수 있습니까?
예. Webhook 설정에서 활성 토글을 끄면 작동이 중단되지만 설정은 유지됩니다.

Q: Webhook 트리거가 교대근무on에 기록됩니까?
상세한 webhook 전송 로그는 인터페이스에서 제공되지 않습니다. 추적은 서버 측에서 합니다.

Q: 프로젝트 또는 스케줄별로 webhook를 필터링할 수 있습니까?
아니요. Webhook는 회사 전체에서 선택한 유형의 모든 이벤트에 대해 트리거됩니다. 필터링은 수신 서버 측에서 합니다.

Q: 회사 삭제 시 webhook는 어떻게 됩니까?
모든 webhook가 회사와 함께 삭제됩니다.