Webhook

기술 용어
약 1분 읽기

특정 이벤트가 발생했을 때 서버가 지정된 URL로 실시간 데이터를 전송하는 HTTP 기반의 이벤트 알림 메커니즘입니다.

다른 이름
웹훅

상세 설명

Webhook은 '역방향 API'라고도 불리며, 애플리케이션 간에 실시간 데이터를 주고받는 효율적인 방식입니다. 클라이언트가 서버에 데이터를 요청하는 Polling 방식과 달리, 서버에서 특정 이벤트(결제 완료, 코드 푸시, AI 작업 완료 등)가 발생하면 미리 등록된 URL로 HTTP POST 요청을 보냅니다. 이를 통해 시스템은 리소스를 낭비하지 않고도 이벤트 발생 즉시 후속 작업을 수행할 수 있습니다. 특히 처리 시간이 긴 생성형 AI API나 자동화 워크플로우를 구축할 때 필수적인 기술 요소입니다.

AI 도구 선택에서 중요한 이유

대규모 언어 모델(LLM)이나 이미지 생성 AI는 결과 출력까지 시간이 걸리는 비동기 작업이 많습니다. 이때 Webhook을 지원하는 도구를 선택해야만 무한정 대기하지 않고 작업 완료 시점에 맞춰 효율적으로 결과물을 수신하고 다음 단계를 실행할 수 있습니다.

확인할 점

  • 보안을 위한 서명 검증(Secret Key/HMAC) 기능을 지원하는가?
  • 전송 실패 시 재시도(Retry) 로직이 구현되어 있는가?
  • 전송되는 데이터 형식(JSON 등)이 기존 시스템과 호환되는가?
  • 테스트를 위한 로그 확인 및 시뮬레이션 기능을 제공하는가?

실제 활용 예시

사용자가 챗봇에 복잡한 분석을 요청하면, AI 서비스는 분석을 마친 뒤 미리 지정된 슬랙(Slack)의 Webhook URL로 결과 메시지를 전송하여 사용자에게 즉시 알림을 보냅니다.

헷갈리기 쉬운 용어

Polling

데이터가 있는지 확인하기 위해 클라이언트가 주기적으로 서버에 물어보는 방식 (리소스 소모 큼)

Webhook

이벤트가 발생했을 때만 서버가 클라이언트에게 알려주는 방식 (실시간성 및 효율성 높음)

관련 용어

APIpollingevent-driven-architecturerest-api