콘텐츠로 이동

HubSpot 연동

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

HubSpot 통합을 사용하기 전에 다음을 확인하세요.

  • 활성 구독이 있는 CrewAI AMP 계정
  • 적절한 권한이 있는 HubSpot 계정
  • 통합 페이지를 통해 HubSpot 계정이 연결되어 있음
  1. CrewAI AMP Integrations로 이동합니다.
  2. 인증 통합 섹션에서 HubSpot을 찾습니다.
  3. Connect를 클릭하고 OAuth 플로우를 완료합니다.
  4. 회사 및 연락처 관리를 위한 필요한 권한을 부여합니다.
  5. 통합 설정에서 Enterprise Token을 복사합니다.
Terminal window
uv add crewai-tools
Terminal window
export CREWAI_PLATFORM_INTEGRATION_TOKEN="your_enterprise_token"

또는 .env 파일에 추가하세요:

CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
hubspot/create_company

설명: 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/create_contact

설명: 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/create_deal

설명: 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/create_record_engagements

설명: 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/update_company

설명: 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/create_record_any

설명: HubSpot에서 지정된 오브젝트 타입의 레코드를 생성합니다.

파라미터:

  • recordType (string, 필수): 커스텀 오브젝트의 오브젝트 타입 ID.
  • 추가 파라미터는 커스텀 오브젝트의 스키마에 따라 다릅니다.
hubspot/update_contact

설명: HubSpot에서 기존 연락처 레코드를 업데이트합니다.

파라미터:

  • recordId (string, 필수): 업데이트할 연락처의 ID.
  • firstname (string, 선택): 이름.
  • lastname (string, 선택): 성.
  • email (string, 선택): 이메일 주소.
  • phone (string, 선택): 전화번호.
  • company (string, 선택): 회사명.
  • jobtitle (string, 선택): 직책.
  • lifecyclestage (string, 선택): 라이프사이클 단계.
hubspot/update_deal

설명: HubSpot에서 기존 거래 레코드를 업데이트합니다.

파라미터:

  • recordId (string, 필수): 업데이트할 거래의 ID.
  • dealname (string, 선택): 거래 이름.
  • amount (number, 선택): 거래 금액.
  • dealstage (string, 선택): 거래의 파이프라인 단계.
  • pipeline (string, 선택): 거래가 속한 파이프라인.
  • closedate (string, 선택): 예상 마감일.
  • dealtype (string, 선택): 거래 유형.
hubspot/update_record_engagements

설명: HubSpot에서 기존 참여(engagement)를 업데이트합니다.

파라미터:

  • recordId (string, 필수): 업데이트할 참여의 ID.
  • hs_note_body (string, 선택): 노트 본문.
  • hs_task_subject (string, 선택): 작업 제목.
  • hs_task_body (string, 선택): 작업 노트.
  • hs_task_status (string, 선택): 작업 상태.
hubspot/update_record_any

설명: HubSpot에서 지정된 오브젝트 타입의 레코드를 업데이트합니다.

파라미터:

  • recordId (string, 필수): 업데이트할 레코드의 ID.
  • recordType (string, 필수): 커스텀 오브젝트의 오브젝트 타입 ID.
  • 추가 파라미터는 커스텀 오브젝트의 스키마에 따라 다릅니다.
hubspot/list_companies

설명: HubSpot에서 회사 레코드 목록을 가져옵니다.

파라미터:

  • paginationParameters (object, 선택): 다음 페이지를 가져오려면 pageCursor를 사용하세요.
hubspot/list_contacts

설명: HubSpot에서 연락처 레코드 목록을 가져옵니다.

파라미터:

  • paginationParameters (object, 선택): 다음 페이지를 가져오려면 pageCursor를 사용하세요.
hubspot/list_deals

설명: HubSpot에서 거래 레코드 목록을 가져옵니다.

파라미터:

  • paginationParameters (object, 선택): 다음 페이지를 가져오려면 pageCursor를 사용하세요.
hubspot/get_records_engagements

설명: HubSpot에서 참여(engagement) 레코드 목록을 가져옵니다.

파라미터:

  • objectName (string, 필수): 가져올 참여 유형(예: “notes”).
  • paginationParameters (object, 선택): 다음 페이지를 가져오려면 pageCursor를 사용하세요.
hubspot/get_records_any

설명: HubSpot에서 지정된 오브젝트 타입의 레코드 목록을 가져옵니다.

파라미터:

  • recordType (string, 필수): 커스텀 오브젝트의 오브젝트 타입 ID.
  • paginationParameters (object, 선택): 다음 페이지를 가져오려면 pageCursor를 사용하세요.
hubspot/get_company

설명: ID로 단일 회사 레코드를 가져옵니다.

파라미터:

  • recordId (string, 필수): 가져올 회사의 ID.
hubspot/get_contact

설명: ID로 단일 연락처 레코드를 가져옵니다.

파라미터:

  • recordId (string, 필수): 가져올 연락처의 ID.
hubspot/get_deal

설명: ID로 단일 거래 레코드를 가져옵니다.

파라미터:

  • recordId (string, 필수): 가져올 거래의 ID.
hubspot/get_record_by_id_engagements

설명: ID로 단일 참여(engagement) 레코드를 가져옵니다.

파라미터:

  • recordId (string, 필수): 가져올 참여의 ID.
hubspot/get_record_by_id_any

설명: 지정된 오브젝트 타입의 단일 레코드를 ID로 가져옵니다.

파라미터:

  • recordType (string, 필수): 커스텀 오브젝트의 오브젝트 타입 ID.
  • recordId (string, 필수): 가져올 레코드의 ID.
hubspot/search_companies

설명: 필터 수식을 사용해 HubSpot에서 회사 레코드를 검색합니다.

파라미터:

  • filterFormula (object, 선택): 분리 정규형(OR of ANDs) 필터.
  • paginationParameters (object, 선택): 다음 페이지를 가져오려면 pageCursor를 사용하세요.
hubspot/search_contacts

설명: 필터 수식을 사용해 HubSpot에서 연락처 레코드를 검색합니다.

파라미터:

  • filterFormula (object, 선택): 분리 정규형(OR of ANDs) 필터.
  • paginationParameters (object, 선택): 다음 페이지를 가져오려면 pageCursor를 사용하세요.
hubspot/search_deals

설명: 필터 수식을 사용해 HubSpot에서 거래 레코드를 검색합니다.

파라미터:

  • filterFormula (object, 선택): 분리 정규형(OR of ANDs) 필터.
  • paginationParameters (object, 선택): 다음 페이지를 가져오려면 pageCursor를 사용하세요.
hubspot/search_records_engagements

설명: 필터 수식을 사용해 HubSpot에서 참여(engagement) 레코드를 검색합니다.

파라미터:

  • engagementFilterFormula (object, 선택): 참여 필터.
  • paginationParameters (object, 선택): 다음 페이지를 가져오려면 pageCursor를 사용하세요.
hubspot/search_records_any

설명: HubSpot에서 지정된 오브젝트 타입의 레코드를 검색합니다.

파라미터:

  • recordType (string, 필수): 검색할 오브젝트 타입 ID.
  • filterFormula (string, 선택): 적용할 필터 수식.
  • paginationParameters (object, 선택): 다음 페이지를 가져오려면 pageCursor를 사용하세요.
hubspot/delete_record_companies

설명: ID로 회사 레코드를 삭제합니다.

파라미터:

  • recordId (string, 필수): 삭제할 회사의 ID.
hubspot/delete_record_contacts

설명: ID로 연락처 레코드를 삭제합니다.

파라미터:

  • recordId (string, 필수): 삭제할 연락처의 ID.
hubspot/delete_record_deals

설명: ID로 거래 레코드를 삭제합니다.

파라미터:

  • recordId (string, 필수): 삭제할 거래의 ID.
hubspot/delete_record_engagements

설명: ID로 참여(engagement) 레코드를 삭제합니다.

파라미터:

  • recordId (string, 필수): 삭제할 참여의 ID.
hubspot/delete_record_any

설명: 지정된 오브젝트 타입의 레코드를 ID로 삭제합니다.

파라미터:

  • recordType (string, 필수): 커스텀 오브젝트의 오브젝트 타입 ID.
  • recordId (string, 필수): 삭제할 레코드의 ID.
hubspot/get_contacts_by_list_id

설명: 지정된 리스트 ID로부터 연락처 목록을 가져옵니다.

파라미터:

  • listId (string, 필수): 연락처를 가져올 리스트의 ID.
  • paginationParameters (object, 선택): 이후 페이지를 위해 pageCursor 사용.
hubspot/describe_action_schema

설명: 특정 오브젝트 타입 및 작업에 대한 예상 스키마를 가져옵니다.

파라미터:

  • recordType (string, 필수): 오브젝트 타입 ID(예: ‘companies’).
  • operation (string, 필수): 작업 유형(예: ‘CREATE_RECORD’).
from crewai import Agent, Task, Crew
# 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.",
apps=['hubspot']
)
# 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()
# Get only the tool to create contacts
actions_list=["hubspot/create_contact"]
)
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.",
apps=['hubspot']
)
# Task to create a contact
create_contact = Task(
description="Create a new contact for 'John Doe' with email '[email protected]'.",
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
crm_manager = Agent(
role="CRM Manager",
goal="Manage and organize HubSpot contacts efficiently.",
backstory="An experienced CRM manager who maintains an organized contact database.",
apps=['hubspot']
)
# Task to manage contacts
contact_task = Task(
description="Create a new contact for 'Jane Smith' at 'Global Tech Inc.' with email '[email protected]'.",
agent=crm_manager,
expected_output="Contact database updated with the new contact."
)
crew = Crew(
agents=[crm_manager],
tasks=[contact_task]
)
crew.kickoff()

도움이 필요하신가요?

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