Zapier를 통해 클라비요에 동의를 보내는 방법

학습 내용

사용자 지정 Zapier 웹훅을 만들어 클라비요에 SMS 동의를 전송하는 방법을 알아보세요. 이 가이드의 지침을 쉽게 수정하여 이메일 동의도 보낼 수 있습니다. 

아래 단계는 Python 스크립트 작업을 트리거하는 웹훅(캐치 훅이라고도 함)을 사용하여 Zap을 만드는 데 도움이 됩니다. 이 스크립트는 이메일과 전화번호를 목록에 구독하기 위해 클라비요에 API 호출을 보냅니다.

통합 정보

이 가이드에서는 트리거가 감지되면 Python 스크립트를 실행하는 Zapier 코드 액션을 사용합니다. 이 솔루션을 사용하면 클라비요 엔드포인트에 필요한 데이터 유형, 특히 구독 프로필 및 구독 취소 프로필 엔드포인트에 필드를 매핑할 수 있습니다.

Zapier 웹훅 설정

1. Zapier 계정에 로그인합니다.
2. Zapier의 메인 페이지에서 +생성을 선택한 다음 Zap을 선택합니다.
3. 새 Zap의 이름을 입력합니다(예: 클라비요 웹훅).
4. 웹훅을 검색한 다음 트리거 메뉴에서 Zapier별 웹훅을 선택합니다.
   
5. 다음 메뉴의 트리거 이벤트 옵션에서 캐치 훅을 선택합니다.
   
6. 계속을 클릭합니다.
7. 테스트 탭을 선택합니다.
8. 요청을 보낼 수 있도록 Zapier에서 제공하는 웹훅 URL을 복사합니다.
   
9. 테스트하기 전에 웹훅으로 테스트 데이터를 보내야 합니다. 자세한 내용은 Zapier로 테스트 데이터를 전송하는 방법 가이드를 참조하세요. 테스트 데이터를 전송할 때 전화번호의 형식을 올바르게 지정해야 합니다.
10. 테스트 데이터를 웹훅으로 전송한 후 테스트 트리거 ( 테스트 탭에서)를 클릭합니다.
    
11. 요청이 성공하면 성공 메시지가 표시되고 아래 예시와 유사하게 테스트 데이터가 성공 메시지 아래에 채워집니다:
    
12. 트리거가 작동하면 선택한 레코드로 계속을 클릭합니다.

재피어 액션 설정

1. 작업 메뉴의 검색창에 Zapier별 코드를 입력하고 목록에서 옵션을 선택합니다.
   
2. 이벤트 선택 > 파이썬 실행을 클릭합니다.
   
3. 계속을 클릭합니다.

필드 매핑 설정 및 스크립트 로직 만들기

1. 필드 매핑을 설정하여 아래 표의 입력 데이터를 이전에 전송한 올바른 테스트 데이터와 연관시키세요. 
   

   입력 데이터	매핑된 테스트 데이터
   이메일	1. 이메일: <Test email>
   전화 번호	1. 전화번호: <Test phone number>
   SMS_CONSENT	1. Sms_consent: true
   이름	1. 이름: <Test name>

   
2. 코드 상자에 아래와 같은 스크립트를 추가합니다:
   

   요청 가져오기
   
   # SMS 구독 또는 구독 취소 호출 구성하기
   if (입력_데이터["sms_consent"] == "true" 또는 입력_데이터["sms_consent"] == "true" 또는 입력_데이터["sms_consent"] == "TRUE"):
     url = "https://a.klaviyo.com/api/profile-subscription-bulk-create-jobs/"
     페이로드 = { "데이터": {
          "type": "profile-subscription-bulk-create-job",
          "속성": {
              "프로필": { "data": [
                       {
                          "type": "profile",
                          "속성": {
                              "이메일": 입력_데이터["이메일"],
                              "전화 번호": 입력_데이터["전화 번호"],
                              "구독": {
                                  "SMS": { " 마케팅": { "consent": "SUBSCRIBED" } }
                               }
                           }
                       }
                   ] }
           },
          "관계": { "list": { "data": {
                       "type": "list",
                       "id": "LIST_ID"
                   } } }
       } }
   
   elif (input_data["sms_consent"] == "false" 또는 input_data["sms_consent"] == "False" 또는 input_data["sms_consent"] == "FALSE"):
     url = "https://a.klaviyo.com/api/profile-subscription-bulk-delete-jobs/"
     페이로드 = { "데이터": {
          "유형": "프로필-구독-일괄삭제-작업",
          "속성": {
              "프로필": { "data": [
                       {
                          "type": "profile",
                          "속성": {
                               "email": input_data["email"],
                               "phone_number": input_data["phone_number"],
                           }
                       }
                   ] }
           },
          "관계": { "list": { "data": {
                       "type": "list",
                       "id": "LIST_ID"
                   } } }
       } }
   
   headers = {
       "accept": "application/json",
       "revision": "2024-05-15",
       "content-type": "application/json",
       "Authorization": "Klaviyo-API-Key your-private-api-key"
   }
   
   response = requests.post(url, json=payload, headers=headers)
   
   # Zapier에는 'output' 객체가 필요합니다.
   output = {"response text": response.text}
   

3. your-private-api-key를클라비요 비공개 API 키로바꿉니다.
   

   비공개 API 키를 비밀번호처럼 취급하여 안전한 곳에 보관하고 공개적으로 노출하지 마세요.

4. 두 위치 모두에서 LIST_ID를 Zapier 데이터를 전송할 클라비요 목록 ID로 바꿉니다. 클라비요에서 오디언스 > 목록 & 세그먼트 > 설정으로 이동하여 목록 ID를 찾을 수 있습니다. 확인 없이 즉시 사람들을 구독하게 하려면(테스트 중에 유용할 수 있음) 리스트가 단일 옵트인으로 설정되어 있는지 확인하세요(리스트 설정의 동의 탭에서 찾을 수 있음). 
5. 계속을 클릭한 다음 테스트 단계를 클릭합니다.
6. 테스트가 성공하면 아래와 같이 오류 없이 응답이 표시됩니다:
   
7. 목록으로 이동하여 프로필이 추가되었는지 확인하여 클라비요에서 테스트에 성공했는지 확인할 수도 있습니다.
   
8. 테스트가 성공하면 게시를 클릭하여 잽을 게시합니다. 테스트에 성공하지 못한 경우 일반적인 문제에 대한 문제 해결 팁을 확인하세요.

문제 해결 팁

다음은 Zapier 웹훅을 설정하는 동안 발생할 수 있는 일반적인 문제입니다. 다른 문제가 발생하면 클라비요 커뮤니티에 문의하여 추가 안내를 받을 수 있습니다.

문자열 리터럴을 스캔하는 동안 EOL

이 오류가 표시되면 변수 중 하나에 따옴표가 누락된 것입니다. 목록 ID와 비공개 API 키의 양쪽이 따옴표로 묶여 있는지 확인합니다.

구문 오류: 잘못된 구문

이 오류가 표시되면 Python 코드에서 주석( #으로 시작하는 모든 줄)을 제거하세요.

추가 리소스

• API를 통해 SMS 동의를 수집하는 방법
• 메시지 개인화 참조
• 계정의 API 키를 관리하는 방법
• Zapier로 테스트 데이터를 보내는 방법