메인 콘텐츠로 건너뛰기

개요

에이전트가 HubSpot 내에서 회사 및 연락처를 관리할 수 있도록 지원합니다. 새로운 레코드를 생성하고 AI 기반 자동화로 CRM 프로세스를 효율화하세요.

사전 준비 사항

HubSpot 통합을 사용하기 전에 다음을 확인하세요.
  • 활성 구독이 있는 CrewAI AMP 계정
  • 적절한 권한이 있는 HubSpot 계정
  • 통합 페이지를 통해 HubSpot 계정이 연결되어 있음

HubSpot 통합 설정

1. HubSpot 계정 연결하기

  1. CrewAI AMP Integrations로 이동합니다.
  2. 인증 통합 섹션에서 HubSpot을 찾습니다.
  3. Connect를 클릭하고 OAuth 플로우를 완료합니다.
  4. 회사 및 연락처 관리를 위한 필요한 권한을 부여합니다.
  5. 계정 설정에서 Enterprise Token을 복사합니다.

2. 필수 패키지 설치

uv add crewai-tools

사용 가능한 액션

설명: HubSpot에서 새로운 회사 레코드를 생성합니다.파라미터:
  • name (string, 필수): 회사명.
  • domain (string, 선택): 회사 도메인명.
  • industry (string, 선택): 산업군. HubSpot에서 미리 정의된 값 중 하나여야 합니다.
  • phone (string, 선택): 전화번호.
  • hubspot_owner_id (string, 선택): 회사 소유자 ID.
  • type (string, 선택): 회사 유형. 사용 가능한 값: PROSPECT, PARTNER, RESELLER, VENDOR, OTHER.
  • city (string, 선택): 도시.
  • state (string, 선택): 주/지역.
  • zip (string, 선택): 우편번호.
  • numberofemployees (number, 선택): 직원 수.
  • annualrevenue (number, 선택): 연간 매출.
  • timezone (string, 선택): 시간대.
  • description (string, 선택): 설명.
  • linkedin_company_page (string, 선택): LinkedIn 회사 페이지 URL.
  • company_email (string, 선택): 회사 이메일.
  • first_name (string, 선택): 회사 연락처의 이름.
  • last_name (string, 선택): 회사 연락처의 성.
  • about_us (string, 선택): 회사 소개.
  • hs_csm_sentiment (string, 선택): CSM 만족도. 사용 가능한 값: at_risk, neutral, healthy.
  • closedate (string, 선택): 마감일.
  • hs_keywords (string, 선택): 회사 키워드. 미리 정의된 값 중 하나여야 합니다.
  • country (string, 선택): 국가/지역.
  • hs_country_code (string, 선택): 국가/지역 코드.
  • hs_employee_range (string, 선택): 직원 범위.
  • facebook_company_page (string, 선택): Facebook 회사 페이지 URL.
  • facebookfans (number, 선택): Facebook 팬 수.
  • hs_gps_coordinates (string, 선택): GPS 좌표.
  • hs_gps_error (string, 선택): GPS 오류.
  • googleplus_page (string, 선택): Google Plus 페이지 URL.
  • owneremail (string, 선택): HubSpot 소유자 이메일.
  • ownername (string, 선택): HubSpot 소유자 이름.
  • hs_ideal_customer_profile (string, 선택): 이상적인 고객 프로필 티어. 사용 가능한 값: tier_1, tier_2, tier_3.
  • hs_industry_group (string, 선택): 산업 그룹.
  • is_public (boolean, 선택): 공개 여부.
  • hs_last_metered_enrichment_timestamp (string, 선택): 마지막 enrichment 타임스탬프.
  • hs_lead_status (string, 선택): 리드 상태. 사용 가능한 값: NEW, OPEN, IN_PROGRESS, OPEN_DEAL, UNQUALIFIED, ATTEMPTED_TO_CONTACT, CONNECTED, BAD_TIMING.
  • lifecyclestage (string, 선택): 라이프사이클 단계. 사용 가능한 값: subscriber, lead, marketingqualifiedlead, salesqualifiedlead, opportunity, customer, evangelist, other.
  • linkedinbio (string, 선택): LinkedIn 바이오.
  • hs_linkedin_handle (string, 선택): LinkedIn 핸들.
  • hs_live_enrichment_deadline (string, 선택): 라이브 enrichment 기한.
  • hs_logo_url (string, 선택): 로고 URL.
  • hs_analytics_source (string, 선택): 원래 유입 경로.
  • hs_pinned_engagement_id (number, 선택): 고정된 참여 ID.
  • hs_quick_context (string, 선택): 간략한 컨텍스트.
  • hs_revenue_range (string, 선택): 매출 범위.
  • hs_state_code (string, 선택): 주/지역 코드.
  • address (string, 선택): 거리 주소.
  • address2 (string, 선택): 거리 주소 2.
  • hs_is_target_account (boolean, 선택): 타깃 계정 여부.
  • hs_target_account (string, 선택): 타깃 계정 티어. 사용 가능한 값: tier_1, tier_2, tier_3.
  • hs_target_account_recommendation_snooze_time (string, 선택): 타깃 계정 추천 일시중지 시간.
  • hs_target_account_recommendation_state (string, 선택): 타깃 계정 추천 상태. 사용 가능한 값: DISMISSED, NONE, SNOOZED.
  • total_money_raised (string, 선택): 총 조달 금액.
  • twitterbio (string, 선택): 트위터 바이오.
  • twitterfollowers (number, 선택): 트위터 팔로워 수.
  • twitterhandle (string, 선택): 트위터 핸들.
  • web_technologies (string, 선택): 사용한 웹 기술. 미리 정의된 값 중 하나여야 합니다.
  • website (string, 선택): 웹사이트 URL.
  • founded_year (string, 선택): 설립 연도.
설명: HubSpot에서 새로운 연락처 레코드를 생성합니다.파라미터:
  • email (string, 필수): 연락처 이메일 주소.
  • firstname (string, 선택): 이름.
  • lastname (string, 선택): 성.
  • phone (string, 선택): 전화번호.
  • hubspot_owner_id (string, 선택): 연락처 소유자.
  • lifecyclestage (string, 선택): 라이프사이클 단계. 사용 가능한 값: subscriber, lead, marketingqualifiedlead, salesqualifiedlead, opportunity, customer, evangelist, other.
  • hs_lead_status (string, 선택): 리드 상태. 사용 가능한 값: NEW, OPEN, IN_PROGRESS, OPEN_DEAL, UNQUALIFIED, ATTEMPTED_TO_CONTACT, CONNECTED, BAD_TIMING.
  • annualrevenue (string, 선택): 연간 매출.
  • hs_buying_role (string, 선택): 구매 역할.
  • cc_emails (string, 선택): 참조(CC) 이메일.
  • ch_customer_id (string, 선택): Chargify 고객 ID.
  • ch_customer_reference (string, 선택): Chargify 고객 참조.
  • chargify_sites (string, 선택): Chargify 사이트(들).
  • city (string, 선택): 도시.
  • hs_facebook_ad_clicked (boolean, 선택): Facebook 광고 클릭 여부.
  • hs_linkedin_ad_clicked (string, 선택): LinkedIn 광고 클릭 여부.
  • hs_clicked_linkedin_ad (string, 선택): LinkedIn 광고 클릭 여부.
  • closedate (string, 선택): 마감일.
  • company (string, 선택): 회사명.
  • company_size (string, 선택): 회사 규모.
  • country (string, 선택): 국가/지역.
  • hs_country_region_code (string, 선택): 국가/지역 코드.
  • date_of_birth (string, 선택): 생년월일.
  • degree (string, 선택): 학위.
  • hs_email_customer_quarantined_reason (string, 선택): 이메일 주소 격리 사유.
  • hs_role (string, 선택): 고용 역할. 미리 정의된 값 중 하나여야 합니다.
  • hs_seniority (string, 선택): 고용 직급. 미리 정의된 값 중 하나여야 합니다.
  • hs_sub_role (string, 선택): 고용 하위 역할. 미리 정의된 값 중 하나여야 합니다.
  • hs_employment_change_detected_date (string, 선택): 고용 변경 감지 날짜.
  • hs_enriched_email_bounce_detected (boolean, 선택): 향상된 이메일 바운스 감지됨.
  • hs_facebookid (string, 선택): Facebook ID.
  • hs_facebook_click_id (string, 선택): Facebook 클릭 ID.
  • fax (string, 선택): 팩스번호.
  • field_of_study (string, 선택): 전공.
  • followercount (number, 선택): 팔로워 수.
  • gender (string, 선택): 성별.
  • hs_google_click_id (string, 선택): Google 광고 클릭 ID.
  • graduation_date (string, 선택): 졸업 날짜.
  • owneremail (string, 선택): HubSpot 소유자 이메일(레거시).
  • ownername (string, 선택): HubSpot 소유자 이름(레거시).
  • industry (string, 선택): 산업군.
  • hs_inferred_language_codes (string, 선택): 추정 언어 코드. 미리 정의된 값 중 하나여야 합니다.
  • jobtitle (string, 선택): 직책.
  • hs_job_change_detected_date (string, 선택): 직장 변경 감지 날짜.
  • job_function (string, 선택): 직무.
  • hs_journey_stage (string, 선택): 여정 단계. 미리 정의된 값 중 하나여야 합니다.
  • kloutscoregeneral (number, 선택): Klout 점수.
  • hs_last_metered_enrichment_timestamp (string, 선택): 마지막 enrichment 타임스탬프.
  • hs_latest_source (string, 선택): 최신 유입 경로.
  • hs_latest_source_timestamp (string, 선택): 최신 유입 경로 날짜.
  • hs_legal_basis (string, 선택): 연락처 데이터 처리를 위한 법적 근거.
  • linkedinbio (string, 선택): LinkedIn 바이오.
  • linkedinconnections (number, 선택): LinkedIn 연결 수.
  • hs_linkedin_url (string, 선택): LinkedIn URL.
  • hs_linkedinid (string, 선택): LinkedIn ID.
  • hs_live_enrichment_deadline (string, 선택): 라이브 enrichment 기한.
  • marital_status (string, 선택): 결혼 상태.
  • hs_content_membership_email (string, 선택): 멤버 이메일.
  • hs_content_membership_notes (string, 선택): 멤버십 노트.
  • message (string, 선택): 메시지.
  • military_status (string, 선택): 군복무 상태.
  • mobilephone (string, 선택): 휴대전화 번호.
  • numemployees (string, 선택): 직원 수.
  • hs_analytics_source (string, 선택): 원래 유입 경로.
  • photo (string, 선택): 사진.
  • hs_pinned_engagement_id (number, 선택): 고정된 참여 ID.
  • zip (string, 선택): 우편번호.
  • hs_language (string, 선택): 선호 언어. 미리 정의된 값 중 하나여야 합니다.
  • associatedcompanyid (number, 선택): 기본 연결된 회사 ID.
  • hs_email_optout_survey_reason (string, 선택): 이메일 수신 거부 사유.
  • relationship_status (string, 선택): 관계 상태.
  • hs_returning_to_office_detected_date (string, 선택): 사무실 복귀 감지 날짜.
  • salutation (string, 선택): 호칭.
  • school (string, 선택): 학교.
  • seniority (string, 선택): 직급.
  • hs_feedback_show_nps_web_survey (boolean, 선택): NPS 웹 설문조사를 표시할지 여부.
  • start_date (string, 선택): 시작일.
  • state (string, 선택): 주/지역.
  • hs_state_code (string, 선택): 주/지역 코드.
  • hs_content_membership_status (string, 선택): 상태.
  • address (string, 선택): 거리 주소.
  • tax_exempt (string, 선택): 세금 면제.
  • hs_timezone (string, 선택): 시간대. 미리 정의된 값 중 하나여야 합니다.
  • twitterbio (string, 선택): 트위터 바이오.
  • hs_twitterid (string, 선택): 트위터 ID.
  • twitterprofilephoto (string, 선택): 트위터 프로필 사진.
  • twitterhandle (string, 선택): 트위터 사용자명.
  • vat_number (string, 선택): 부가가치세 번호.
  • ch_verified (string, 선택): ACH/eCheck 결제 인증됨.
  • website (string, 선택): 웹사이트 URL.
  • hs_whatsapp_phone_number (string, 선택): WhatsApp 전화번호.
  • work_email (string, 선택): 업무용 이메일.
  • hs_googleplusid (string, 선택): googleplus ID.
설명: HubSpot에서 새로운 거래(deal) 레코드를 생성합니다.파라미터:
  • dealname (string, 필수): 거래 이름.
  • amount (number, 선택): 거래 금액.
  • dealstage (string, 선택): 거래의 파이프라인 단계.
  • pipeline (string, 선택): 거래가 속한 파이프라인.
  • closedate (string, 선택): 예상 마감일.
  • hubspot_owner_id (string, 선택): 거래 소유자.
  • dealtype (string, 선택): 거래 유형. 사용 가능한 값: newbusiness, existingbusiness.
  • description (string, 선택): 거래 설명.
  • hs_priority (string, 선택): 거래 우선순위. 사용 가능한 값: low, medium, high.
설명: HubSpot에서 새로운 참여(예: 노트, 이메일, 통화, 미팅, 작업)를 생성합니다.파라미터:
  • engagementType (string, 필수): 참여 유형. 사용 가능한 값: NOTE, EMAIL, CALL, MEETING, TASK.
  • hubspot_owner_id (string, 선택): 이 활동이 할당된 사용자.
  • hs_timestamp (string, 선택): 활동 날짜 및 시간.
  • hs_note_body (string, 선택): 노트 본문. (NOTE에서 사용)
  • hs_task_subject (string, 선택): 작업 제목. (TASK에서 사용)
  • hs_task_body (string, 선택): 작업 노트. (TASK에서 사용)
  • hs_task_status (string, 선택): 작업 상태. (TASK에서 사용)
  • hs_meeting_title (string, 선택): 미팅 제목. (MEETING에서 사용)
  • hs_meeting_body (string, 선택): 미팅 설명. (MEETING에서 사용)
  • hs_meeting_start_time (string, 선택): 미팅 시작 시간. (MEETING에서 사용)
  • hs_meeting_end_time (string, 선택): 미팅 종료 시간. (MEETING에서 사용)
설명: HubSpot에서 기존 회사 레코드를 업데이트합니다.파라미터:
  • recordId (string, 필수): 업데이트할 회사의 ID.
  • name (string, 선택): 회사명.
  • domain (string, 선택): 회사 도메인명.
  • industry (string, 선택): 산업군.
  • phone (string, 선택): 전화번호.
  • city (string, 선택): 도시.
  • state (string, 선택): 주/지역.
  • zip (string, 선택): 우편번호.
  • numberofemployees (number, 선택): 직원 수.
  • annualrevenue (number, 선택): 연간 매출.
  • description (string, 선택): 설명.
설명: HubSpot에서 지정된 오브젝트 타입의 레코드를 생성합니다.파라미터:
  • recordType (string, 필수): 커스텀 오브젝트의 오브젝트 타입 ID.
  • 추가 파라미터는 커스텀 오브젝트의 스키마에 따라 다릅니다.
설명: HubSpot에서 기존 연락처 레코드를 업데이트합니다.파라미터:
  • recordId (string, 필수): 업데이트할 연락처의 ID.
  • firstname (string, 선택): 이름.
  • lastname (string, 선택): 성.
  • email (string, 선택): 이메일 주소.
  • phone (string, 선택): 전화번호.
  • company (string, 선택): 회사명.
  • jobtitle (string, 선택): 직책.
  • lifecyclestage (string, 선택): 라이프사이클 단계.
설명: HubSpot에서 기존 거래 레코드를 업데이트합니다.파라미터:
  • recordId (string, 필수): 업데이트할 거래의 ID.
  • dealname (string, 선택): 거래 이름.
  • amount (number, 선택): 거래 금액.
  • dealstage (string, 선택): 거래의 파이프라인 단계.
  • pipeline (string, 선택): 거래가 속한 파이프라인.
  • closedate (string, 선택): 예상 마감일.
  • dealtype (string, 선택): 거래 유형.
설명: HubSpot에서 기존 참여(engagement)를 업데이트합니다.파라미터:
  • recordId (string, 필수): 업데이트할 참여의 ID.
  • hs_note_body (string, 선택): 노트 본문.
  • hs_task_subject (string, 선택): 작업 제목.
  • hs_task_body (string, 선택): 작업 노트.
  • hs_task_status (string, 선택): 작업 상태.
설명: HubSpot에서 지정된 오브젝트 타입의 레코드를 업데이트합니다.파라미터:
  • recordId (string, 필수): 업데이트할 레코드의 ID.
  • recordType (string, 필수): 커스텀 오브젝트의 오브젝트 타입 ID.
  • 추가 파라미터는 커스텀 오브젝트의 스키마에 따라 다릅니다.
설명: HubSpot에서 회사 레코드 목록을 가져옵니다.파라미터:
  • paginationParameters (object, 선택): 다음 페이지를 가져오려면 pageCursor를 사용하세요.
설명: HubSpot에서 연락처 레코드 목록을 가져옵니다.파라미터:
  • paginationParameters (object, 선택): 다음 페이지를 가져오려면 pageCursor를 사용하세요.
설명: HubSpot에서 거래 레코드 목록을 가져옵니다.파라미터:
  • paginationParameters (object, 선택): 다음 페이지를 가져오려면 pageCursor를 사용하세요.
설명: HubSpot에서 참여(engagement) 레코드 목록을 가져옵니다.파라미터:
  • objectName (string, 필수): 가져올 참여 유형(예: “notes”).
  • paginationParameters (object, 선택): 다음 페이지를 가져오려면 pageCursor를 사용하세요.
설명: HubSpot에서 지정된 오브젝트 타입의 레코드 목록을 가져옵니다.파라미터:
  • recordType (string, 필수): 커스텀 오브젝트의 오브젝트 타입 ID.
  • paginationParameters (object, 선택): 다음 페이지를 가져오려면 pageCursor를 사용하세요.
설명: ID로 단일 회사 레코드를 가져옵니다.파라미터:
  • recordId (string, 필수): 가져올 회사의 ID.
설명: ID로 단일 연락처 레코드를 가져옵니다.파라미터:
  • recordId (string, 필수): 가져올 연락처의 ID.
설명: ID로 단일 거래 레코드를 가져옵니다.파라미터:
  • recordId (string, 필수): 가져올 거래의 ID.
설명: ID로 단일 참여(engagement) 레코드를 가져옵니다.파라미터:
  • recordId (string, 필수): 가져올 참여의 ID.
설명: 지정된 오브젝트 타입의 단일 레코드를 ID로 가져옵니다.파라미터:
  • recordType (string, 필수): 커스텀 오브젝트의 오브젝트 타입 ID.
  • recordId (string, 필수): 가져올 레코드의 ID.
설명: 필터 수식을 사용해 HubSpot에서 회사 레코드를 검색합니다.파라미터:
  • filterFormula (object, 선택): 분리 정규형(OR of ANDs) 필터.
  • paginationParameters (object, 선택): 다음 페이지를 가져오려면 pageCursor를 사용하세요.
설명: 필터 수식을 사용해 HubSpot에서 연락처 레코드를 검색합니다.파라미터:
  • filterFormula (object, 선택): 분리 정규형(OR of ANDs) 필터.
  • paginationParameters (object, 선택): 다음 페이지를 가져오려면 pageCursor를 사용하세요.
설명: 필터 수식을 사용해 HubSpot에서 거래 레코드를 검색합니다.파라미터:
  • filterFormula (object, 선택): 분리 정규형(OR of ANDs) 필터.
  • paginationParameters (object, 선택): 다음 페이지를 가져오려면 pageCursor를 사용하세요.
설명: 필터 수식을 사용해 HubSpot에서 참여(engagement) 레코드를 검색합니다.파라미터:
  • engagementFilterFormula (object, 선택): 참여 필터.
  • paginationParameters (object, 선택): 다음 페이지를 가져오려면 pageCursor를 사용하세요.
설명: HubSpot에서 지정된 오브젝트 타입의 레코드를 검색합니다.파라미터:
  • recordType (string, 필수): 검색할 오브젝트 타입 ID.
  • filterFormula (string, 선택): 적용할 필터 수식.
  • paginationParameters (object, 선택): 다음 페이지를 가져오려면 pageCursor를 사용하세요.
설명: ID로 회사 레코드를 삭제합니다.파라미터:
  • recordId (string, 필수): 삭제할 회사의 ID.
설명: ID로 연락처 레코드를 삭제합니다.파라미터:
  • recordId (string, 필수): 삭제할 연락처의 ID.
설명: ID로 거래 레코드를 삭제합니다.파라미터:
  • recordId (string, 필수): 삭제할 거래의 ID.
설명: ID로 참여(engagement) 레코드를 삭제합니다.파라미터:
  • recordId (string, 필수): 삭제할 참여의 ID.
설명: 지정된 오브젝트 타입의 레코드를 ID로 삭제합니다.파라미터:
  • recordType (string, 필수): 커스텀 오브젝트의 오브젝트 타입 ID.
  • recordId (string, 필수): 삭제할 레코드의 ID.
설명: 지정된 리스트 ID로부터 연락처 목록을 가져옵니다.파라미터:
  • listId (string, 필수): 연락처를 가져올 리스트의 ID.
  • paginationParameters (object, 선택): 이후 페이지를 위해 pageCursor 사용.
설명: 특정 오브젝트 타입 및 작업에 대한 예상 스키마를 가져옵니다.파라미터:
  • recordType (string, 필수): 오브젝트 타입 ID(예: ‘companies’).
  • operation (string, 필수): 작업 유형(예: ‘CREATE_RECORD’).

사용 예시

기본 HubSpot 에이전트 설정

from crewai import Agent, Task, Crew
from crewai_tools import CrewaiEnterpriseTools

# Get enterprise tools (HubSpot tools will be included)
enterprise_tools = CrewaiEnterpriseTools(
    enterprise_token="your_enterprise_token"
)

# Create an agent with HubSpot capabilities
hubspot_agent = Agent(
    role="CRM Manager",
    goal="Manage company and contact records in HubSpot",
    backstory="An AI assistant specialized in CRM management.",
    tools=[enterprise_tools]
)

# Task to create a new company
create_company_task = Task(
    description="Create a new company in HubSpot with name 'Innovate Corp' and domain 'innovatecorp.com'.",
    agent=hubspot_agent,
    expected_output="Company created successfully with confirmation"
)

# Run the task
crew = Crew(
    agents=[hubspot_agent],
    tasks=[create_company_task]
)

crew.kickoff()

특정 HubSpot 도구 필터링

from crewai_tools import CrewaiEnterpriseTools

# Get only the tool to create contacts
enterprise_tools = CrewaiEnterpriseTools(
    enterprise_token="your_enterprise_token",
    actions_list=["hubspot_create_record_contacts"]
)

contact_creator = Agent(
    role="Contact Creator",
    goal="Create new contacts in HubSpot",
    backstory="An AI assistant that focuses on creating new contact entries in the CRM.",
    tools=[enterprise_tools]
)

# Task to create a contact
create_contact = Task(
    description="Create a new contact for 'John Doe' with email 'john.doe@example.com'.",
    agent=contact_creator,
    expected_output="Contact created successfully in HubSpot."
)

crew = Crew(
    agents=[contact_creator],
    tasks=[create_contact]
)

crew.kickoff()

연락처 관리

from crewai import Agent, Task, Crew
from crewai_tools import CrewaiEnterpriseTools

enterprise_tools = CrewaiEnterpriseTools(
    enterprise_token="your_enterprise_token"
)

crm_manager = Agent(
    role="CRM Manager",
    goal="Manage and organize HubSpot contacts efficiently.",
    backstory="An experienced CRM manager who maintains an organized contact database.",
    tools=[enterprise_tools]
)

# Task to manage contacts
contact_task = Task(
    description="Create a new contact for 'Jane Smith' at 'Global Tech Inc.' with email 'jane.smith@globaltech.com'.",
    agent=crm_manager,
    expected_output="Contact database updated with the new contact."
)

crew = Crew(
    agents=[crm_manager],
    tasks=[contact_task]
)

crew.kickoff()

도움 받기

도움이 필요하신가요?

HubSpot 연동 설정 또는 문제 해결에 도움이 필요하시면 지원팀에 문의해 주세요.
I