Journey에서 웹훅 응답 데이터 사용하기

개요

웹훅 응답의 값을 매핑하면 Pushwoosh는 이를 변수로 저장하여 나중에 Journey에서 이벤트 속성을 사용할 수 있는 모든 곳에서 사용할 수 있습니다.

참고

Webhook 요소를 추가하고 응답 매핑을 구성하려면 Webhook을 참조하세요.

사용자 프로필 업데이트로 웹훅 값을 태그로 저장하기

Webhook은 CRM 사용자 ID나 구독 상태와 같이 Pushwoosh가 아직 사용자 프로필에 저장하지 않은 외부 시스템의 데이터를 반환할 수 있습니다. 사용자 프로필 업데이트는 매핑된 값을 태그로 저장하여 세그먼트, 동적 콘텐츠 및 이후 Journey 단계에서 사용할 수 있도록 합니다.

예시: CRM 사용자 ID를 태그로 저장하기

새로운 사용자가 앱에 가입하면 Journey는 CRM에 일치하는 레코드를 생성합니다. 반환된 CRM 사용자 ID를 태그로 저장하면 사용자가 Journey에 다시 들어올 때마다 중복 레코드를 생성하는 대신, 나중에 다른 Journey나 후속 Webhook 호출 등에서 동일한 CRM 레코드를 참조하거나 업데이트할 수 있습니다.

Journey 흐름: 트리거 기반 진입 → Webhook → 사용자 프로필 업데이트 → 종료

1. SignUp 이벤트에 대한 트리거 기반 진입으로 Journey를 생성합니다.
2. 진입 단계 뒤에 Webhook 요소를 추가합니다. 이름을 지정하고(예: Create user in CRM) 요청 URL을 CRM 사용자 생성 엔드포인트로 설정합니다.
3. 응답 매핑에서 경로를 응답의 ID 필드(예: data.user.id)로 설정하고 속성을 crm_user_id로 설정합니다.

4. Webhook 단계 뒤에 사용자 프로필 업데이트 요소를 추가합니다.

5. 동적 태그 값에서 + 동적 값을 클릭합니다. 태그에서 CRM ID를 저장하는 태그를 선택합니다(필요한 경우 미리 생성). 이벤트에서 지정한 이름(Create user in CRM)으로 웹훅 단계를 선택합니다. 동적 값에서 crm_user_id를 선택합니다.

6. 브랜치 끝에 종료를 추가합니다.

주의

사용자에 대한 웹훅 값이 누락된 경우(응답이 JSON이 아니거나, 경로가 확인되지 않거나, 호출이 실패한 경우) Pushwoosh는 해당 태그 업데이트를 건너뜁니다. 태그는 이전 값을 유지하거나 설정되지 않은 상태로 남으며, Journey는 이 단계에서 오류 없이 계속됩니다. 시작하기 전에 웹훅 테스트를 실행하여 매핑을 확인하세요. 자세히 알아보기.

시간 지연으로 웹훅 값에서 지연 예약하기

방문 날짜, 갱신 마감일, 배송 기간 등은 종종 외부 예약 또는 청구 시스템에 존재합니다. Webhook이 API 응답에서 날짜를 매핑한 후, 시간 지연은 예를 들어 약속 2일 전과 같이 해당 시점까지 Journey를 일시 중지하여 다음 메시지가 제시간에 발송되도록 할 수 있습니다.

예시: 응답의 날짜로 리마인더 예약하기

사용자가 앱에서 약속을 예약합니다. Journey는 예약 시스템에서 방문 날짜를 가져와 방문 2일 전에 푸시 리마인더를 보냅니다.

1. AppointmentBooked 이벤트에 대한 트리거 기반 진입으로 Journey를 생성합니다.
2. 진입 단계 뒤에 Webhook 요소를 추가합니다. 이름을 지정하고(예: Get appointment details) 요청 URL을 예약 시스템 API로 설정합니다.
3. 응답 매핑에서 경로를 응답의 날짜 필드(예: appointment.date)로 설정하고 속성을 visit_date로 설정합니다.

4. Webhook 단계 뒤에 시간 지연 요소를 추가합니다. 사용자/이벤트 데이터 기반을 선택하고, 날짜 가져오기를 이벤트로 설정하고, 이벤트를 지정한 이름(Get appointment details)으로 웹훅 단계로 설정하고, 이벤트 값을 visit_date로 설정하고, 지연을 2일 전으로 설정합니다.

5. 사용자가 방문 2일 이내에 예약할 수 있는 경우, 시간 지연 요소에서 날짜가 과거이거나 비어 있는 경우 브랜치로 분할을 활성화합니다. 이렇게 하면 과거와 미래의 두 브랜치가 생성됩니다. 날짜가 과거이거나 비어 있을 때 브랜치 분할하기를 참조하세요.
6. 리마인더 메시지와 함께 푸시 단계를 추가합니다. 분할이 활성화된 경우, 과거(즉시 전송)와 미래(시간 지연 후) 두 브랜치 모두에 이 푸시를 추가합니다.
7. 각 브랜치 끝에 종료를 추가합니다.

주의

매핑된 값이 누락되었거나 유효한 날짜가 아닌 경우, 사용자는 이 단계에서 오류와 함께 Journey를 종료합니다.

방문일이 2일 이내인 경우, 사용자가 시간 지연에 도달했을 때 2일 전 목표는 이미 과거이므로, 날짜가 과거이거나 비어 있는 경우 브랜치로 분할을 활성화하지 않으면 사용자는 오류나 리마인더 없이 Journey를 떠납니다.

태그를 변경하지 않고 계속 진행하는 사용자 프로필 업데이트와 달리, 시간 지연은 날짜가 누락되었거나, 유효하지 않거나, 과거인 경우(브랜치 분할 없이) 사용자를 중지시킵니다. 웹훅이 지원되는 형식의 날짜를 안정적으로 반환하는지 확인하세요. 시작하기 전에 웹훅 테스트를 실행하세요. 자세히 알아보기.

유의사항

• 경로 구문: 점으로 구분된 경로(예: data.user.id)를 사용합니다. 와일드카드와 필터는 지원되지 않습니다. 자세한 내용은 웹훅 응답 매핑을 참조하세요.
• 응답 크기: 64 KB보다 큰 응답은 매핑을 위해 처리되지 않습니다.
• 테스트: 라이브 Journey에서 매핑된 값을 사용하기 전에 Webhook 요소에서 웹훅 테스트를 실행하세요.