메인 콘텐츠로 건너뛰기
모든 콜렉션연동 가이드웹훅
데이터스페이스 웹훅 연동
데이터스페이스 웹훅 연동

데이터스페이스 웹훅 등록 방법을 알아봅니다.

j
작성자: junhyeok lee
최소 한 달 전에 업데이트됨

데이터스페이스 웹훅이란?

데이터스페이스에서 설문 응답이 발생할 때마다 자동으로 특정 URL로 이벤트를 전송하는 기능입니다. 설문 응답을 완료한 사용자에게 쿠폰 또는 리워드를 즉시 지급하고 싶은 경우에 활용됩니다.

웹훅은 특정 플랜 구독 이후 사용 가능합니다. 구독이 필요한 경우 오른쪽 하단에 물음표 버튼을 통해 먼저 문의해 주세요.

웹훅 설정 방법 알아보기

웹훅 설정은 스페이스 내 Developer 권한을 가지고 있는 멤버만 가능합니다. 필요 시 Admin 멤버에게 문의하여 권한을 먼저 받아 주세요.

① 웹훅 목록에서 등록하기

1) 데이터스페이스 왼쪽 GNB에서 설정 > 개발 연동 > 웹훅을 선택합니다.

2) 웹훅 목록 내 오른쪽 상단의 [웹훅 등록] 버튼을 선택하여 아래 정보를 입력합니다.

  • 이름: 등록한 웹훅을 쉽게 구분할 수 있도록 이름을 입력하는 영역입니다. 최대 100자까지 입력할 수 있습니다.

  • URL: 웹훅을 수신할 대상 URL을 입력하는 영역입니다. 보안이 강화된 HTTPS 통신만 지원하며 URL 입력 시에는 ‘https://’ 제외하고 입력합니다.

  • HMAC: 웹훅 유효성 검사 사용 여부를 선택하는 영역입니다. 사용할 경우 유효성 판단에 활용될 HMAC 키를 입력합니다. 최대 16자까지 입력 가능합니다.

  • 이벤트 타입: 전송할 이벤트를 선택하는 영역입니다. ‘스페이스 내 모든 응답'과 ‘수집그룹 응답' 중 한 가지를 선택할 수 있습니다.

    • 스페이스 내 모든 응답: 해당 스페이스에 속한 모든 수집그룹의 응답을 전송합니다.

    • 수집그룹 응답: 해당 스페이스에 속한 수집그룹 중 지정된 수집그룹의 응답만 전송합니다. 특정 수집그룹 지정을 위해서는 웹훅을 등록 중인 멤버가 해당 프로젝트에 초대되어 있어야 합니다.

3) 마지막 아래 안내문을 읽고 동의하는 경우 ‘동의합니다.’ 체크박스를 선택합니다. [등록] 버튼까지 누르면 웹훅 등록이 완료됩니다. 데이터 보안 등의 이유로 수용할 수 없는 내용이라면 등록하지 않는 것을 권장합니다.

② 수집그룹 설정에서 등록하기

위에 안내된 웹훅 목록에서 웹훅 설정 시 어떤 이벤트를 전송할지 선택할 수 있었다면, 아래에서는 특정 수집그룹 내에서 바로 웹훅을 설정할 수 있는 방법을 안내합니다. 이 경우 이벤트 타입은 해당 ‘수집그룹 응답’으로 자동 지정됩니다.

1) 수집 탭에서 웹훅을 설정할 수집그룹을 선택합니다.

2) 수집그룹 내 웹훅 목록 영역에서 오른쪽 상단의 [웹훅 등록] 버튼을 선택하여 아래 정보를 입력합니다.

  • 이름: 등록한 웹훅을 쉽게 구분할 수 있도록 이름을 입력하는 영역입니다. 최대 100자까지 입력할 수 있습니다.

  • URL: 웹훅을 수신할 대상 URL을 입력하는 영역입니다. 보안이 강화된 HTTPS 통신만 지원하며 URL 입력 시에는 ‘https://’ 제외하고 입력합니다.

  • HMAC: 웹훅 유효성 검사 사용 여부를 선택하는 영역입니다. 사용할 경우 유효성 판단에 활용될 HMAC 키를 입력합니다. 최대 16자까지 입력 가능합니다.

3) 마지막 아래 안내문을 읽고 동의하는 경우 ‘동의합니다.’ 체크박스를 선택합니다. [등록] 버튼까지 누르면 웹훅 등록이 완료됩니다. 데이터 보안 등의 이유로 수용할 수 없는 내용이라면 등록하지 않는 것을 권장합니다.

웹훅 설정된 수집그룹 구분하기

웹훅이 설정된 수집그룹의 경우 수집 탭에서 수집그룹 명 옆에 아래와 같이 표시됩니다. 해당 표시로 웹훅 설정 여부를 목록에서 구분할 수 있습니다. 이 외 등록한 웹훅 관리하기는 아래 아티클을 확인해 주세요.

📌 꼭 알아두세요!

동일한 URL에 중복되는 조건의 웹훅을 등록할 경우 ‘활성화’ 상태의 웹훅의 수만큼 전송됩니다. 예를 들어 아래와 같이 두 개의 웹훅을 등록하면 example.com으로 동일한 내용이 2회 전송됩니다. 중복된 데이터가 들어오지 않도록 웹훅 등록 시 유의해 주세요!

  • 웹훅 A

    • URL: example.com

    • 이벤트: 스페이스 내 모든 응답

  • 웹훅 B

    • URL: example.com

    • 이벤트: 수집그룹 응답 (수집그룹 이름: a)

📌 함께 알아두면 좋을 내용

웹훅 설정이 가능한 스페이스는 데이터스페이스 왼쪽 GNB에서 설정 > 데이터스페이스 > 구독 정보에서 확인 가능합니다. 애드온 항목에 ‘API 이용’이 활성화되어 있는지 확인해 주세요.

답변이 도움되었나요?