HubSpot에서 연락처 검색 컴포넌트란?

HubSpot에서 연락처 검색 컴포넌트는 HubSpot의 가능한 모든 속성(사용자 지정 속성 포함)으로 연락처를 찾고 필터링할 수 있습니다. 연산자 옵션과 결합하여 수십 가지의 고유한 활용 사례를 만들 수 있습니다.

이 컴포넌트의 주요 이점

• 유연한 속성 검색: HubSpot의 모든 속성(사용자 지정 필드 포함)으로 연락처를 필터링할 수 있습니다. 데이터 타겟팅 또는 조회에 대한 완전한 제어권을 제공합니다.
• 고급 연산자 지원: 같음, 큼, 작음, 사이, 포함 등 다양한 조건을 사용할 수 있습니다. 이를 통해 정밀하고 맞춤화된 쿼리가 가능합니다.
• 워크플로우 호환성: 다른 컴포넌트와 조합해 완전한 플로우를 구축할 수 있습니다. 리드 추적, 알림, 데이터 동기화 등에 이상적입니다.
• 데이터 위생 개선: 불완전하거나 오래된 연락처 기록을 쉽게 식별할 수 있습니다. CRM을 항상 깨끗하게 유지하는 데 도움이 됩니다.
• 시간 기반 필터링: 생성일 또는 수정일로 검색할 수 있습니다. 기념일 제안, 재참여 캠페인, 휴면 리드 탐지 등에 적합합니다.
• 맞춤 출력 옵션: 결과를 원하는 곳(채팅, Slack, Google Sheets, 이메일 등)으로 보낼 수 있습니다. 리포팅 및 알림 자동화에 편리합니다.

컴포넌트 설정

연산자

연산자는 쿼리와 검색 대상 간의 관계를 설명하는 수학적 함수입니다. 예를 들어 이메일의 정확한 일치를 검색할 수도 있고, 특정 날짜 이후 생성된 연락처, 특정 속성이 없는 연락처 등 다양한 조건으로 검색할 수 있습니다.

속성 이름

HubSpot의 속성 또는 사용자 지정 오브젝트로 검색할 수 있습니다. 연산자 옵션과 결합해 수십 가지의 활용 사례가 가능합니다. 이름, 이메일, 회사 등 연락처 정보 외에도 생성일, 수정일, 라이프사이클 단계 등으로도 필터링할 수 있습니다.

기타 설정

• 제한: 검색할 연락처 수를 설정합니다. 기본값은 1(정확한 일치 검색용)이지만, 대량 작업 시 더 높게 설정할 수 있습니다. 결과 수가 많아질수록 처리 시간과 비용이 증가함을 유념하세요.
• 도구 설명: 에이전트가 도구 사용 방법을 이해할 수 있도록 추가 정보를 입력하세요.
• 도구명: 에이전트가 상세 출력에서 이 컴포넌트를 참조할 때 사용할 이름을 지정하세요. 사용자의 편의를 위한 이름입니다.
• 상세 출력: FlowHunt 채팅 인터페이스에서 에이전트의 사고 과정을 보여줄지 선택합니다. 디버깅에 특히 유용합니다.

핸들

• 도구: 이 컴포넌트를 AI Agent에 도구로 연결합니다. 주요 출력 핸들로, 에이전트가 이 컴포넌트를 사용해 신규 연락처 기록을 생성할 수 있습니다.
• 연락처 추가 후: 연락처 생성 후 수행할 작업을 지정하려면 컴포넌트를 연결하세요. 예를 들어 Slack 알림, Google Sheets 자동 업데이트, 추가 데이터 처리 등을 설정할 수 있습니다.

HubSpot에서 연락처 검색 컴포넌트 사용 방법

컴포넌트의 기능을 살펴봤으니, 이제 실제로 사용하는 방법을 알아보겠습니다. 실습 전, 이 컴포넌트로 해결할 수 있는 대표적인 문제들을 아래 활용 사례로 소개합니다:

• 준수 및 데이터 위생: “not in”, “속성 없음”, “토큰 포함” 연산자를 사용해 테스트 리드, 누락된 연락처 필드, 불완전 기록 등을 찾아 억제 또는 정리합니다.
• 휴면 리드 탐지: 일정 기간 수정되지 않은 라이프사이클=리드 연락처에 대한 자동 알림을 설정합니다.
• 지역 기반 캠페인: 특정 국가, 도시, 우편번호의 연락처를 찾아 위치 기반 캠페인, 이벤트 초대 등을 발송합니다.
• 시간 기반 캠페인: 특정 생성일의 연락처를 찾아 기념일 제안을 자동 발송합니다.
• 자동 갱신 알림: 마지막 수정일에 “작거나 같음” 연산자를 적용해 갱신이 임박한 고객을 찾아 체크인 또는 특별 제안을 트리거합니다.
• 주요 계정의 신규 연락처: 타깃 계정 회사에서 새로 생성된 연락처를 감지해 즉시 내부 알림을 보내거나 담당 영업에게 라우팅합니다.
• 우편번호 기반 영업 라우팅: “in” 연산자를 사용해 연락처를 미리 정의한 우편번호 목록과 매칭하고, 지역 담당자나 캠페인에 배정합니다.
• 관심사 기반 스마트 라우팅: “Interest = Product A”와 같은 사용자 지정 속성으로 연락처를 관련 영업 후속 조치나 콘텐츠 여정으로 즉시 라우팅합니다.

휴면 리드 탐지 플로우 구축하기

컴포넌트를 직접 테스트해보겠습니다. 아주 간단한 휴면 리드 탐지 플로우를 만들 예정입니다. 즉, 라이프사이클 단계 = 리드 AND 마지막 수정일 X일 전인 연락처를 찾는 것입니다.

여기서는 채팅 플로우로 테스트하지만, 이 프로세스는 완전히 자동화된 크론 작업으로도 구현할 수 있고, Slack이나 Gmail 알림, 또는 자동 리포트 작성을 위한 스프레드시트 등 원하는 곳으로 출력을 보낼 수 있습니다.

단계:

1. 채팅 플로우이므로 Chat Input, Output, History를 추가합니다.
2. HubSpot 컴포넌트를 도구로 사용할 AI Agent를 추가합니다.
3. 검색 조건이 2개이므로 Search Contact in HubSpot 컴포넌트를 2개 추가합니다.
4. 아래 그림처럼 컴포넌트를 연결합니다:

5. 다음으로, 검색 연산자와 속성 이름을 설정합니다.
6. 첫 번째 Search 컴포넌트는 lastmodifieddate가 Greater than or equal(이상)인 X일 전의 연락처를 찾습니다. 즉, 휴면 기록을 검색합니다:

7. 두 번째 Search 컴포넌트는 lifecyclestage가 equal(같음)인 lead를 찾습니다. 이 검색을 통해 기존 고객이나 다른 유형의 기록이 결과에 포함되지 않도록 보장합니다:

8. 이로써 채팅에서 지시를 내리고 결과를 받을 수 있는 플로우가 완성됩니다. 이 플로우를 확장해 채팅 대신 외부 앱으로 결과를 보내는 자동 실행 플로우로 만들 수도 있습니다.

이제 실제로 테스트해보겠습니다. 채팅에 다음과 같이 입력합니다:

라이프사이클 단계가 리드이고 마지막 수정일이 5일 이상인 연락처를 반환하세요.

완전 자동화된 워크플로우에서는 이 지시 사항을 AI Agent와 Search Contact 컴포넌트 설정에 영구적으로 입력할 수 있습니다. 여기서는 채팅 플로우이므로 그냥 채팅으로 지시를 보냅니다.

잠시 처리 후, 플로우는 한 명의 연락처를 반환했습니다:

결과가 맞는지 확인해보겠습니다. HubSpot 연락처 목록을 보면 4개의 기록이 있습니다. 하지만 그중 하나는 고객이고, 나머지 두 개는 오늘(4월 10일) 수정되었습니다. 즉, 플로우가 반환한 연락처가 주어진 조건에 유일하게 부합합니다:

이 예시에서는 플로우를 수동으로 실행해 채팅에서 결과를 받지만, 크론 작업으로 자동 실행하고, 출력 소스를 Create Google Sheet 컴포넌트(자동 리포트 생성용), Slack 메시지 전송 또는 이메일 알림 도구(알림용) 등 원하는 것으로 바꿔 완전 자동화된 솔루션으로 손쉽게 전환할 수 있습니다.