웹훅(Webhook) 정의는? 웹훅의 역할과 작동 방식

온라인 비즈니스를 운영하려면, 여러 웹 애플리케이션(웹 앱)이 지속적으로 통신해야 합니다. 결제 시스템, 은행, 재고 관리 소프트웨어, 고객 관계 관리(CRM) 시스템 등 다양한 시스템을 통합하여 데이터를 공유하고 특정 이벤트가 발생할 때마다 조치를 취할 수 있도록 해야 합니다.

웹훅(Webhook)은 이러한 종단간 워크플로를 더욱 원활하게 만들어 줍니다. 안전하고 간단하며 자동화된 메시지를 통해 정보를 주고받기 때문입니다. 웹훅이 IT 기능을 실행하는 데 신뢰할 수 있는 방식인 이유와 웹훅이 필요한 이유, 그리고 가장 효과적으로 활용되는 시점을 살펴보겠습니다.

웹훅이란 무엇인가요?

웹훅은 애플리케이션을 상호 연결하는 특수한 웹 서비스입니다. 이러한 서비스는 특정 이벤트가 발생할 때마다 한 애플리케이션에서 다른 애플리케이션으로 웹을 통해 자동으로 데이터를 전송합니다.

웹훅을 사용하면 웹 애플리케이션이 공통 언어로 소통할 수 있어, 필요한 HTTP 요청(웹 브라우저에서 서버로 콘텐츠를 요청하는 것)을 수행하고 실시간으로 새로운 데이터를 공유할 수 있습니다. 업데이트를 지속적으로 확인하는 대신, 특정 상황이 발생하면 웹훅을 통해 애플리케이션이 자동으로 다른 애플리케이션에 정보를 전송할 수 있습니다.

웹훅 통합은 다음과 같은 다양한 전자상거래 업체의 업무에 활용할 수 있습니다.

• 재고 업데이트. 제품의 재고 수준이 특정 수준에 도달하면 이 이벤트가 공급업체에 알림 메시지를 전송합니다.

• 결제 확인. 결제가 성공적으로 완료되면 회계 및 고객 지원 부서에 알림이 전송됩니다.

• 고객 반품. 웹훅은 재고 데이터를 업데이트하고 환불 프로세스를 시작할 수 있습니다.

• 리드 생성. 직원이 마케팅 플랫폼에 새로운 리드를 추가하면 웹훅이 리드 정보를 고객 관계 관리(CRM) 시스템으로 전송하여 자동으로 새 리드 레코드를 생성합니다.

• 고객 지원. 고객 지원 시스템은 웹훅을 활용하여 수신 전화 알림을 받고, 발신자 ID를 기반으로 고객 데이터를 가져오고, 적절한 상담원에게 통화를 라우팅하거나, 통화 후 설문조사 또는 후속 조치를 시작할 수 있습니다.

웹훅의 작동 원리

기술적으로 말하면 웹훅(Webhook)은 HTTP 푸시 API(또는 푸시 API)라고 불리는 방식의 특수한 구현입니다. 이는 웹 애플리케이션과 서버 간의 푸시 기반 통신을 가능하게 하는 구성입니다. 웹훅은 사용자 정의 HTTP 콜백으로, 정보를 수신 엔드포인트(클라이언트라고 함)로 전달합니다. 클라이언트는 대상 시스템 또는 수신 애플리케이션이라고도 합니다.

트리거 이벤트가 발생하면 시작 시스템이 HTTP를 통해 자동화된 메시지인 웹훅을 전송합니다. 이 기능의 핵심에는 콜백 URL이라고 불리는 URL 필드가 있습니다. 이를 우편함 주소에 비유할 수 있습니다. 메시지 데이터는 POST 요청 형태로 전송되며, 웹훅은 특정 콜백 URL을 사용해 다른 애플리케이션으로 데이터를 푸시합니다. 요청한 데이터를 묻고, 기다리고, 확인하는 대신, 클라이언트(데이터를 수신하는 대상 앱 또는 서비스)에 데이터가 변경될 때마다 자동으로 알림이 전송됩니다.

웹훅이 작동하려면, 클라이언트가 수신되는 코드와 실시간 데이터를 처리하도록 프로그래밍되어 있어야 합니다. 웹훅은 일반적으로 JSON 또는 XML을 데이터 교환 형식으로 사용하지만, JSON이 더 널리 사용되는 표준이 되었습니다.

웹훅의 예시

웹훅은 온라인 주문 처리 시 배송 속도를 개선하고 인적 오류를 줄이는 데 도움이 될 수 있습니다.

예를 들어, 온라인 의류 스토어를 운영하면서 결제 프로세서를 사용한다고 가정해 보겠습니다. 고객이 주문을 하면 웹훅이 트리거되고, 배송 업체의 시스템이 미리 정의된 고유 URL에서 이를 수신합니다. 웹훅의 데이터(또는 페이로드)에는 배송 주소, 제품 라인 항목, 결제 금액 및 기타 관련 정보와 같은 주문 세부 사항이 포함됩니다.

수신 요청을 받으면 배송 업체의 시스템은 특정 작업(이 경우 배송 라벨 생성)을 실행하며, 거래가 완료되는 즉시 라벨이 자동으로 인쇄됩니다.

웹훅 vs. API: 차이점은 무엇인가요?

사람들은 종종 웹훅을 애플리케이션 프로그래밍 인터페이스(API)와 혼동합니다. API는 소프트웨어 애플리케이션과 온라인 서비스 간에 데이터를 검색하고 기능을 교환할 수 있도록 하는 프로토콜입니다. 두 기술은 공통된 기능을 공유하지만, 웹훅과 API 사이에는 중요한 차이점이 있습니다.

• 목적. API는 서로 다른 시스템을 연결하는 애플리케이션 개발에서 널리 사용됩니다. 개발자는 필요한 기능을 추가하기 위해 API(수천 개가 존재함)를 애플리케이션에 연결하는 반면, 웹훅은 트리거 이벤트 후에 푸시되는 자동화된 메시지입니다.

• 통신 유형. API와 웹훅 모두 앱 간 통신을 포함하지만, API는 양방향 통신을 허용하는 반면 웹훅은 트리거 이벤트의 결과로 단방향 통신만 허용합니다.

• 데이터 흐름. 데이터 흐름이 반대로 이루어지는 것처럼 보인다는 이유로 웹훅을 역방향 API라고 부르기도 합니다. 그러나 웹훅은 진정한 의미의 역방향 API가 아니라, 고유한 형태의 실시간 이벤트 기반 통신 방식입니다.

• 복잡성. API는 요청-응답 주기 동안 소스 시스템과 대상 시스템을 모두 수정할 수 있기 때문에 웹훅보다 더 복잡합니다.

두 기술은 서로 다른 메커니즘이지만 함께 사용할 수 있습니다. 예를 들어, 위치 기반 애플리케이션은 사용자의 위치가 변경될 때 서버에 알리기 위해 웹훅을 사용할 수 있습니다. 이후 서버는 Google Maps API를 사용해 새 위치를 기준으로 주변 관심 장소 목록을 수집할 수 있습니다.