# 웹훅이란 무엇인가요?

> 웹훅은 어떤 일이 일어났을 때 시스템이 보내는 HTTP 메시지입니다. 웹훅의 작동 방식, 보안 방법, 근태 관리와의 연결 방식을 알아보세요.

URL: https://timetracking.tech/ko/glossary/webhook
Language: ko
Last updated: 2026-10-24

**정의:** 웹훅(webhook)은 근무표 승인 같은 특정 이벤트가 일어나는 즉시 한 시스템이 다른 시스템의 URL로 보내는 자동 HTTP 요청입니다. 받는 시스템은 폴링 없이 바로 대응할 수 있습니다.

## 웹훅의 작동 방식

URL을 등록하고 관심 있는 이벤트를 고릅니다. 그 이벤트가 발생하면 보내는 시스템이 무슨 일이 일어났는지 설명하는 작은 JSON 메시지를 그 URL로 전송합니다. 받는 쪽이 다운되어 있으면 좋은 발신 시스템은 나중에 다시 시도합니다.

공개 URL에는 누구든 요청을 보낼 수 있으므로 웹훅에는 서명이 붙습니다. 발신자는 공유 비밀 키로 메시지에 대한 HMAC 서명을 계산하고, 수신자는 이를 다시 계산해 서명이 일치하는 메시지만 신뢰합니다.

## TimeTracking의 웹훅

TimeTracking은 근무 시간의 상태가 바뀔 때 HMAC으로 서명된 웹훅을 보내며, 실패하면 재시도합니다. CRM을 업데이트하거나, 청구 처리를 시작하거나, 채팅 채널에 메시지를 게시하는 데 쓸 수 있습니다. 반대 방향, 즉 필요할 때 데이터를 읽고 쓰는 일은 OpenAPI 명세를 갖춘 REST API가 담당합니다.

- [API 및 연동](https://timetracking.tech/ko/features/api-and-integrations)
- [MCP](https://timetracking.tech/ko/glossary/mcp)
- [감사 추적](https://timetracking.tech/ko/glossary/audit-trail)