이 가이드에서는 웹훅과 자피어를 통해 리드가 생성되었을 때, 생성된 리드가 스티비 주소록에 자동으로 추가되도록 설정하는 방법에 대해 설명합니다.
도움말: 아직 자피어를 연동하지 않으셨다면 Zapier 연동하기(클릭)를 먼저 확인해주세요!
자피어로 웹훅을 이용하려면 자피어 Professional plan 결제가 필요합니다.
리캐치 웹훅과 스티비 웹훅을 이용하여 다음과 같이 설정합니다.
리캐치에서 보내는 리드 발생 이벤트를 자피어에서 잡아내도록 설정
자피어가 잡아낸 리캐치의 이벤트 데이터 값(이름, 이메일, 회사명 등)을 스티비로 보내도록 설정
Webhook by Zapier 를 선택해주세요.
Trigger event는 Catch Hook을 선택해주세요.
Configure 단계는 넘어가셔도 됩니다.
Test 단계에서 URL을 복사하신 후 리캐치로 이동해주세요.
리캐치 설정 - 웹훅으로 이동하여 '웹훅 추가'를 클릭해주세요.
URL에 복사한 URL을 입력하고 전송할 이벤트로 '리드 생성'을 선택해주세요.
'테스트 발송'을 클릭하여 앞선 단계와 동일하게 입력한 후 확인 버튼을 클릭해주세요.
동일한 URL을 입력한 후 전송할 이벤트 - 리드 생성 을 클릭해주세요.
(클릭하신 이후 반응이 나타나지 않아도 테스트가 정상적으로 진행된 것입니다.)
도움말: 만약 파이프라인에 추가하는 경우 전송할 이벤트를 '딜 생성' 으로 선택해주시는 것을 권장드립니다.
다시 자피어로 이동하여 Test Trigger를 클릭해주세요
먼저 Webhook by Zapier를 추가해주세요.
Action event 는 Custom Request를 선택해주세요
Configure 단계로 이동해주세요.
Method에는 Post 로 선택해주세요.
URL에는 다음 URL을 넣어주시면 됩니다.
URL : https://api.stibee.com/v1/lists/listId/subscribers
위 URL을 복사한 후 listId 부분에 구독자를 추가할 주소록의 listId 값을 넣어주세요.
listid는 스티비 - 구독자를 추가할 주소록을 클릭한 후 다음과 같이 확인할 수 있습니다.
아래 예시에서는 321238이 listid이며 이 값을 그대로 위의 URL listId 부분에 넣어주시면 됩니다.
Configure 단계의 Data값에는 다음과 같이 입력해주세요
위 값을 복사한 후 groupIds 값 , email 값, name 값을 수정해야합니다.
위 예시는 리캐치 폼에서 email과 name값 만을 가져오는 경우입니다.
groupIds 값 확인하기
groupIds는 특정 그룹의 목록을 조회하는 URL의 맨 뒤에 있는 숫자입니다.
'Re:catch 리캐치 2024'라는 주소록에서 구독자를 추가하고 싶은 그룹의 groupid 는 365202입니다
만약 스티비 주소록에서 그룹 설정을 하지 않으셨다면 "groupIds" 값은 제외하고 입력해주세요.
도움말: email이나 name은 주소록의 사용자 정의 필드의 필드 이름을 가져와서 매칭하는 방식입니다.
회사명이나 부서, 직책의 정보도 리캐치와 매칭하고 싶으시다면 각 이름 값을 Data에서 추가
하시면 됩니다.
email 값, name 값 수정하기
우측 상단의 +버튼을 누르면 데이터 값을 선택할 수 있습니다.
여기서 "email"에는 Payload Payload Fields Data Email
"name"에는 Payload Payload Fields Data Name 을 클릭하여 넣어주시면 됩니다.
사용하시는 폼에 따라 정보를 더 추가로 받아오고 싶으시다면 + 버튼을 클릭하여 리캐치의 폼에서 받은 데이터와 스티비의 주소록 필드에 들어갈 데이터를 연결시킬 수 있습니다
이제 Configure 단계에서 Headers 를 입력해줍니다.
왼쪽에 Content-Type 을 입력해준 후 오른쪽에 application/json을 입력합니다
하단의 'add value set을 클릭해주세요
왼쪽에 AccessToken을 입력한 후 오른쪽에는 스티비 API를 입력합니다.
스티비 API 확인하기
스티비 API는 기본 워크스페이스 - 워크스페이스 설정 - API 키에서 확인하실 수 있어요.
'새로만들기'를 클릭한후 생성된 API를 복사하여 붙여넣기합니다.
모두 입력하였다면 Test 단계를 클릭하여 Test를 진행해주세요.
오류 없이 진행되었다면 Ok 값이 true로 뜨며, 설정한 주소록에 구독이 추가된 것을 확인하실 수 있습니다.
만약 Error가 발생했다면 다음과 같이 Ok 값이 false로 나타납니다.
이러한 경우 Configure 단계에서 Data값을 정확하게 입력했는지 확인해주세요.
아래의 예시에서는 "N" 다음 , 가 아닌 .을 입력했기 때문에 에러가 발생했습니다.
, 와 .를 구분해서 잘 입력하였는지
"email":"[Payload Payload Fields Data Email]" 에서 " " 를 입력했는지
"email":"[Payload Payload Fields Data Email]" 에서 " "사이에 띄어쓰기 없이 입력되었는지 등을 확인해주세요!
도움말: 스티비 API 에 관한 자세한 내용은 스티비에서 제공하는 가이드를 확인해주세요!