# 클라비요 통합 클라비요 연동을 통해 Botpress 챗봇을 선도적인 고객 데이터 및 마케팅 자동화 플랫폼인 클라비요와 연결할 수 있습니다. 이 연동을 통해 챗봇은 리드를 생성하고, 고객 정보를 업데이트하고, 프로필을 SMS 및 이메일 마케팅에 구독할 수 있습니다. 사용 가능한 작업 ## 사용 가능한 작업 ### 프로필 만들기 클라비요에서 새 고객 프로필을 생성합니다. 이 작업을 통해 포괄적인 프로필 정보와 함께 클라비요 데이터베이스에 새 연락처를 추가할 수 있습니다. **필수 필드:** - 이메일 주소** 또는 **전화 번호**(+15005550006과 같은 E.164 형식) **선택 필드:** - **이름** 및 **성** - **조직** 및 **직책** - **로케일**(en-US, fr-FR과 같은 IETF BCP 47 형식) - 위치**(주소 라인, 도시, 국가, 지역, 우편번호를 포함한 주소 세부 정보) - 사용자 지정 속성**(추가 프로필 데이터 저장을 위한 키-값 쌍) **출력: **생성된 프로필을 고유한 클라비요 ID와 함께 반환합니다. ### 프로필 업데이트 프로필의 고유 ID를 사용하여 클라비요에서 기존 고객 프로필을 업데이트합니다. 이 작업을 통해 생성 후 프로필 정보를 수정할 수 있습니다. **필수 필드:** - **프로필 ID**(업데이트할 프로필의 클라비요 고유 식별자) **선택 필드:** - 이메일 주소** (프로필의 이메일 업데이트) - **전화 번호**(E.164 형식) - 이름** 및 **성**. - **조직** 및 **직책** - 로케일**(IETF BCP 47 형식) - 위치**(전체 주소 정보) - 사용자 지정 속성**(키-값 쌍) **출력:** 모든 현재 정보가 포함된 업데이트된 프로필을 반환합니다. ### 프로필 가져오기 고유 ID를 사용하여 클라비요에서 특정 고객 프로필을 검색합니다. 이 작업은 개별 고객 정보를 조회할 때 유용합니다. **필수 필드:** - **프로필 ID**(검색할 프로필의 클라비요 고유 식별자) **출력:** 아이디, 이메일, 전화, 이름 및 기타 저장된 모든 데이터를 포함한 전체 프로필 정보를 반환합니다. ### 프로필 가져오기 필터와 정렬 옵션을 사용하여 클라비요에서 여러 고객 프로필을 검색하고 가져옵니다. 이 작업은 특정 기준에 따라 고객 그룹을 찾는 데 적합합니다. **필터 옵션:** - **필터 필드:** `ID`, `이메일`, `전화번호`, `외부_ID`, `생성` 또는 `업데이트` 중에서 선택합니다. - **필터 연산자:** '같음', '포함', '보다 큼', '보다 작음', '다음으로 시작', '다음으로 끝' 등의 비교 연산자를 사용합니다. - **필터 값:** 검색할 값(문자열 및 날짜 지원) **페이지 매김 및 정렬:** - **페이지 크기:** 반환할 프로필 수(1~100, 기본값: 20) - 정렬:** 선택적 내림차순(`-`로 접두사)으로 원하는 필드별로 정렬 **사용 사례 예시:** - 특정 날짜 이후에 생성된 모든 프로필 찾기 - 도메인이 포함된 이메일 주소로 프로필 검색하기 - 생성 날짜별로 정렬된 프로필 가져오기(최신 것부터) **출력:** 조건과 일치하는 프로필 배열을 반환합니다. ### 프로필 구독 클라비요에서 여러 고객 프로필을 이메일 및/또는 SMS 마케팅 목록에 구독합니다. 이 작업은 구독을 비동기적으로 처리하며 한 번에 최대 1,000개의 프로필을 처리할 수 있습니다. **필수 필드:** - **프로필 구독:** 동의 정보가 있는 프로필 배열 - **프로필 ID**(또는 본인 확인을 위한 이메일/전화) - **이메일 동의 :** 이메일 마케팅 동의를 나타내는 부울입니다. - SMS 동의 :** SMS 마케팅에 대한 동의를 나타내는 부울입니다. **선택 필드:** - **목록 ID:** 구독한 프로필을 추가할 특정 클라비요 목록 - **기록 가져오기 :** 과거 프로필 가져오기를 위한 부울입니다. **중요 참고 사항 :** - 요청당 최대 1,000개의 프로필 - 하나 이상의 프로필이 필요합니다. - 동의 플래그에 따라 프로필이 구독할 마케팅 채널이 결정됩니다. - 이 작업은 클라비요에 의해 비동기적으로 처리됩니다. **출력:** 구독 작업이 성공적으로 예약되었는지 여부를 나타내는 성공 부울을 반환합니다.
