클라비요에서 사용할 수 있는 다양한 웹훅 이해하기

학습 내용 

클라비요에서 제공되는 웹훅 솔루션의 차이점과 각 솔루션을 언제 사용해야 하는지 알아보세요. 

시작하기 전 안내 사항

CDP 웹훅과 코드는 클라비요 CDP의 일부입니다. CDP는 클라비요의 표준 마케팅 애플리케이션에 포함되어 있지 않으며, 관련 기능에 액세스하려면 CDP 구독이 필요합니다. 요금제에 이 기능을 추가하는 방법에 대해   자세히 알아보거나 신규  고객인경우 시작하려면청구 가이드로 이동하세요 .

웹훅이란 무엇인가요?

웹훅을 사용하면 클라비요가 HTTP 요청을 통해 정보를 전달하거나 다른 애플리케이션, 도구, 서버를 '호출'할 수 있습니다. 발생한 이벤트(예: 주문 접수, 신규 고객 가입 등)에 대한 정보를 보내거나 이벤트가 발생했음을 외부 시스템에 알릴 수 있습니다.

웹훅은 몇 가지 주요 구성 요소로 이루어져 있습니다:

• 주제
  웹훅이 실행되는 이벤트입니다.
• 본문 (또는 "페이로드")
  웹훅이 전송하는 데이터입니다.
• 헤더
  추가 정보(예: 인증)를 전달하기 위한 공간입니다.

플로우 웹훅

흐름이 특정 단계 또는 단계에 도달할 때 발생하는 작업으로 흐름에 웹훅을 추가할 수 있습니다. 플로우가 웹훅 액션에 도달하면 페이로드를 구성하는 방법에 따라 플로우를 트리거한 이벤트 또는 수신자에 대한 데이터와 함께 POST 요청이 전송됩니다. 

플로우 웹훅은 플로우 트리거 이벤트(즉, 플로우 트리거로 사용할 수 있는 이벤트)를 기반으로만 보낼 수 있습니다. 또한 플로우는 일반적으로 메시지 수신으로 끝나므로 플로우 웹훅은 메시지 관련 이벤트(예: 이메일 수신, 이메일 클릭, 스팸으로 표시된 이메일)를 지원하지 않습니다. 

플로우 웹훅의 사용 사례 예시

플로우 웹훅이 가장 효과적인 몇 가지 사용 사례는 다음과 같습니다:

• 세그먼트 또는 리스트에 추가되는 구독자를 기반으로 트리거되는 메시지 또는 POST 요청을 보냅니다.
• 프로필이 참여하지 않은 세그먼트에 진입할 때 자동으로 억제를 실행합니다. 
• 고객이 구매하면 왓츠앱이나 페이스북 메신저와 같은 서비스를 통해 개인화된 감사 메시지를 보내세요. 

클라비요 CDP의 웹훅 

클라비요 CDP의 웹훅을 사용하면 웹훅 작업으로 이어지는 일련의 단계에 의존하지 않고도 이벤트에 대한 응답으로 외부 시스템에 알림을 보낼 수 있습니다. CDP 웹훅을 사용하면 웹훅 요청 본문을 수동으로 구성하거나 지정할 필요가 없습니다. 사용자 지정 개발 없이 외부 시스템에 이벤트가 발생했음을 알리려면 Klaviyo CDP의 웹훅이 가장 효과적입니다. 

또한 CDP 웹훅은 요청을 트리거하기 위해 더 광범위한 주제를 지원하며, 이벤트 가져오기 API를 통해 쿼리할 수 있는 모든 이벤트에 대한 응답으로 정보를 보낼 수 있습니다.

여기에는 다음이 포함됩니다:

• 이메일 이벤트(예: 이메일 수신, 이메일 클릭, 스팸으로 표시된 이메일)
• SMS 이벤트(예: 보낸 SMS, 받은 SMS)
• 푸시 알림 이벤트(예: 푸시 수신, 푸시 반송)
• 연동 이벤트(즉, 클라비요에서 생성한 퍼스트 파티 연동 이벤트)
• API 이벤트(예: 클라비요의 API를 통해 동기화된 이벤트)

여기에는 플로우 웹훅에서 지원하지 않는 수신 거부, 이메일 수신 또는 이메일 클릭과 같은 메시지 관련 이벤트가 포함됩니다.

또한 단일 트리거 플로우에 의존하는 플로우 웹훅과 달리 CDP 웹훅을 사용하면 한 번에 여러 트리거를 구독할 수 있습니다.

CDP 웹훅의 사용 사례 예시

• 고객의 구독 취소 이벤트를 외부 시스템과 동기화합니다.
• 상담원이 이메일 기록을 확인하여 고객에게 더 나은 서비스를 제공할 수 있도록 헬프 데스크 소프트웨어에 이메일 수신 이벤트를 보고합니다.
• 클라비요의 데이터 웨어하우스 동기화에서 지원하지 않는 모든 이메일 전송, 열기, 클릭을 데이터 웨어하우스에 동기화합니다.

코드 

코드는 클라비요 CDP에 포함된 기능입니다. 클라비요의 표준 마케팅 애플리케이션에는 포함되어 있지 않으며, 관련 기능에 액세스하려면 CDP 구독이 필요합니다. 요금제에 이 기능을 추가하는 방법에 대해 자세히 알아보거나 신규 고객인 경우 시작하려면 청구 가이드로 이동하세요.

코드는 웹훅을 활용하여 이벤트 트리거에 대한 응답으로 사용자 지정 함수를 실행할 수 있습니다. 클라비요 에디터에서 직접 코드를 작성할 수 있으며, 클라비요는 코드 실행, 모니터링 및 로깅을 관리합니다.

공용 HTTP 엔드포인트를 호스팅하지 않고 외부 시스템으로 요청을 보내려면 코드를 사용할 수 있습니다. 또한 이벤트 발생에 대한 응답으로 사용자 지정 함수를 실행하려면 클라비요에서 제공되는 다른 웹훅 솔루션이 아닌 코드를 사용해야 합니다. 

또한 코드에서는 CDP의 웹훅을 통한 이벤트 트리거를 통해 더욱 세분화된 기능을 지원합니다. 모든 통합 또는 API 이벤트가 아닌 개별 지표를 선택하여 토픽으로 사용할 수 있습니다.

코드 사용 사례 예시 

• Python JSON 라이브러리를 가져와서 이벤트 페이로드를 구문 분석하고 무언가를 추출합니다.
• 클라비요의 API를 사용하여 이벤트 메타데이터를 기반으로 사용자 지정 프로필 속성을 설정하세요.
• 채팅GPT 라이브러리를 가져와서 장바구니의 프로필과 품목을 기반으로 중단된 각 장바구니에 대한 사용자 지정 메시지를 작성합니다.

추가 자료 

흐름에서 웹후크 이해하기
클라비요 CDP에서 웹후크 이해하기
코드 시작하기