고급 노드 (Advanced Node)

개요

고급 노드를 통해 외부 API 및 서비스와 연동하여 등 더욱 고도화된 기능을 여정에 추가할 수 있습니다.

Webhook은 특정 이벤트가 발생하면 한 서비스에서 다른 서비스로 자동으로 보내는 HTTP 요청입니다. Webhook을 사용하면 외부 시스템과 연동하여 여정을 더욱 효과적으로 관리할 수 있으며, 실시간 데이터를 활용해 다음 단계를 개인화할 수 있습니다.

사용자가 Webhook 노드에 도달하면 자동으로 외부 서비스에 HTTP 요청이 보내지고, 해당 서비스에서 필요한 데이터를 받아와 캠페인에 반영됩니다. 이를 통해 다음과 같은 작업이 가능합니다:

Webhook 노드를 만들려면, 노드 사이 또는 노드 뒤에 나타나는 + 아이콘을 클릭한 후, 고급 > Webhook을 선택합니다.

새로 추가된 노드를 클릭하면 다음 필드가 있는 설정 패널이 열립니다:

이름	필수 여부	설명	예시
노드 이름	필수	이 노드의 이름을 입력합니다.	`"쿠폰 발송"`
대상 URL	필수	API의 엔드포인트 URL을 입력합니다.	`https://www.example.com/coupon_endpoint`
HTTP 메서드	필수	드롭다운에서 HTTP 메서드를 선택합니다.	`GET`
QPS	필수 아님	전송할 최대 요청 수(초당 쿼리 수)를 입력합니다.	`10`
배치 요청 활성화	필수 아님	여러 개의 API 호출을 한 번에 묶어 보낼 수 있습니다. 배치를 활성화하려면 `"true"`를 입력하면 됩니다. 배치 크기는 한 번에 보낼 최대 요청 수를 정하며, 최소 간격은 배치를 전송하는 주기를 결정합니다.
HTTP 헤더	필수 아님	필요한 HTTP 헤더를 입력합니다.	`{"Authorization": "Bearer TOKEN"}`
콘텐츠 유형	필수 아님	요청의 콘텐츠 유형을 지정합니다.	`application/json`
요청 본문	필수 아님	요청 본문의 내용을 입력합니다. `{{ }}`를 사용하여 사용자 속성을 동적으로 삽입할 수 있습니다. 예: 사용자의 이메일을 나타내려면 `{{email}}`을 사용합니다.	`{"membership_email":"{{email}}"}`
응답 필드 매핑	필수 아님	Webhook 응답 필드를 커스텀 이름으로 매핑하여 조건이나 동적 콘텐츠에서 활용할 수 있습니다. 중첩된 필드는 점 표기법을 사용합니다.	`{"coupon.code": "coupon_code", "coupon.discount_pct": "discount"}`

Webhook 설정을 완료한 후 다음과 같은 작업을 할 수 있습니다:

사용자 흐름을 나누는 조건을 설정하려면 응답 확인을 선택합니다. 시나리오마다 Webhook에서 받은 응답을 기준으로 하나 이상의 조건을 추가할 수 있습니다.

각 시나리오에서 일치 옆에서 사용자가 모든(All) 조건을 충족해야 하는지, 또는 **하나 이상(Any)**의 조건만 충족해도 되는지를 설정합니다.

각 조건에 대해 다음을 설정합니다:

모든 시나리오와 조건을 추가한 후 저장을 클릭합니다.

캠페인에서 Webhook 응답 데이터를 동적 콘텐츠로 삽입하려면 다음 구문을 사용합니다. 캠페인 채널마다 다른 구문을 사용해야 합니다.

캠페인 채널	동적 콘텐츠 구문
웹 푸시, 앱 푸시, 이메일, SMS, 인앱, 인웹	`{{ctx_<WEBHOOK_RESPONSE_FIELD_NAME>}}`에서 `<WEBHOOK_RESPONSE_FIELD_NAME>`을 응답 필드 매핑에서 가져온 값으로 변경합니다.
WebChat, WhatsApp, Zalo, Viber	`{{extra_params_<WEBHOOK_RESPONSE_FIELD_NAME>}}`에서 `<WEBHOOK_RESPONSE_FIELD_NAME>` 을 응답 필드 매핑에서 가져온 값으로 변경합니다.