개요
에이전트가 HubSpot 내에서 회사 및 연락처를 관리할 수 있도록 지원합니다. 새로운 레코드를 생성하고 AI 기반 자동화로 CRM 프로세스를 효율화하세요.사전 준비 사항
HubSpot 통합을 사용하기 전에 다음을 확인하세요.- 활성 구독이 있는 CrewAI AMP 계정
- 적절한 권한이 있는 HubSpot 계정
- 통합 페이지를 통해 HubSpot 계정이 연결되어 있음
HubSpot 통합 설정
1. HubSpot 계정 연결하기
- CrewAI AMP Integrations로 이동합니다.
- 인증 통합 섹션에서 HubSpot을 찾습니다.
- Connect를 클릭하고 OAuth 플로우를 완료합니다.
- 회사 및 연락처 관리를 위한 필요한 권한을 부여합니다.
- 통합 설정에서 Enterprise Token을 복사합니다.
2. 필수 패키지 설치
3. 환경 변수 설정
Agent(apps=[])와 함께 통합을 사용하려면 Enterprise Token으로 CREWAI_PLATFORM_INTEGRATION_TOKEN 환경 변수를 설정해야 합니다..env 파일에 추가하세요:
사용 가능한 액션
hubspot/create_company
hubspot/create_company
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/create_contact
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/create_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/create_record_engagements
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/update_company
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/create_record_any
recordType(string, 필수): 커스텀 오브젝트의 오브젝트 타입 ID.- 추가 파라미터는 커스텀 오브젝트의 스키마에 따라 다릅니다.
hubspot/update_contact
hubspot/update_contact
recordId(string, 필수): 업데이트할 연락처의 ID.firstname(string, 선택): 이름.lastname(string, 선택): 성.email(string, 선택): 이메일 주소.phone(string, 선택): 전화번호.company(string, 선택): 회사명.jobtitle(string, 선택): 직책.lifecyclestage(string, 선택): 라이프사이클 단계.
hubspot/update_deal
hubspot/update_deal
recordId(string, 필수): 업데이트할 거래의 ID.dealname(string, 선택): 거래 이름.amount(number, 선택): 거래 금액.dealstage(string, 선택): 거래의 파이프라인 단계.pipeline(string, 선택): 거래가 속한 파이프라인.closedate(string, 선택): 예상 마감일.dealtype(string, 선택): 거래 유형.
hubspot/update_record_engagements
hubspot/update_record_engagements
recordId(string, 필수): 업데이트할 참여의 ID.hs_note_body(string, 선택): 노트 본문.hs_task_subject(string, 선택): 작업 제목.hs_task_body(string, 선택): 작업 노트.hs_task_status(string, 선택): 작업 상태.
hubspot/update_record_any
hubspot/update_record_any
recordId(string, 필수): 업데이트할 레코드의 ID.recordType(string, 필수): 커스텀 오브젝트의 오브젝트 타입 ID.- 추가 파라미터는 커스텀 오브젝트의 스키마에 따라 다릅니다.
hubspot/list_companies
hubspot/list_companies
paginationParameters(object, 선택): 다음 페이지를 가져오려면pageCursor를 사용하세요.
hubspot/list_contacts
hubspot/list_contacts
paginationParameters(object, 선택): 다음 페이지를 가져오려면pageCursor를 사용하세요.
hubspot/list_deals
hubspot/list_deals
paginationParameters(object, 선택): 다음 페이지를 가져오려면pageCursor를 사용하세요.
hubspot/get_records_engagements
hubspot/get_records_engagements
objectName(string, 필수): 가져올 참여 유형(예: “notes”).paginationParameters(object, 선택): 다음 페이지를 가져오려면pageCursor를 사용하세요.
hubspot/get_records_any
hubspot/get_records_any
recordType(string, 필수): 커스텀 오브젝트의 오브젝트 타입 ID.paginationParameters(object, 선택): 다음 페이지를 가져오려면pageCursor를 사용하세요.
hubspot/get_company
hubspot/get_company
recordId(string, 필수): 가져올 회사의 ID.
hubspot/get_contact
hubspot/get_contact
recordId(string, 필수): 가져올 연락처의 ID.
hubspot/get_deal
hubspot/get_deal
recordId(string, 필수): 가져올 거래의 ID.
hubspot/get_record_by_id_engagements
hubspot/get_record_by_id_engagements
recordId(string, 필수): 가져올 참여의 ID.
hubspot/get_record_by_id_any
hubspot/get_record_by_id_any
recordType(string, 필수): 커스텀 오브젝트의 오브젝트 타입 ID.recordId(string, 필수): 가져올 레코드의 ID.
hubspot/search_companies
hubspot/search_companies
filterFormula(object, 선택): 분리 정규형(OR of ANDs) 필터.paginationParameters(object, 선택): 다음 페이지를 가져오려면pageCursor를 사용하세요.
hubspot/search_contacts
hubspot/search_contacts
filterFormula(object, 선택): 분리 정규형(OR of ANDs) 필터.paginationParameters(object, 선택): 다음 페이지를 가져오려면pageCursor를 사용하세요.
hubspot/search_deals
hubspot/search_deals
filterFormula(object, 선택): 분리 정규형(OR of ANDs) 필터.paginationParameters(object, 선택): 다음 페이지를 가져오려면pageCursor를 사용하세요.
hubspot/search_records_engagements
hubspot/search_records_engagements
engagementFilterFormula(object, 선택): 참여 필터.paginationParameters(object, 선택): 다음 페이지를 가져오려면pageCursor를 사용하세요.
hubspot/search_records_any
hubspot/search_records_any
recordType(string, 필수): 검색할 오브젝트 타입 ID.filterFormula(string, 선택): 적용할 필터 수식.paginationParameters(object, 선택): 다음 페이지를 가져오려면pageCursor를 사용하세요.
hubspot/delete_record_companies
hubspot/delete_record_companies
recordId(string, 필수): 삭제할 회사의 ID.
hubspot/delete_record_contacts
hubspot/delete_record_contacts
recordId(string, 필수): 삭제할 연락처의 ID.
hubspot/delete_record_deals
hubspot/delete_record_deals
recordId(string, 필수): 삭제할 거래의 ID.
hubspot/delete_record_engagements
hubspot/delete_record_engagements
recordId(string, 필수): 삭제할 참여의 ID.
hubspot/delete_record_any
hubspot/delete_record_any
recordType(string, 필수): 커스텀 오브젝트의 오브젝트 타입 ID.recordId(string, 필수): 삭제할 레코드의 ID.
hubspot/get_contacts_by_list_id
hubspot/get_contacts_by_list_id
listId(string, 필수): 연락처를 가져올 리스트의 ID.paginationParameters(object, 선택): 이후 페이지를 위해pageCursor사용.
hubspot/describe_action_schema
hubspot/describe_action_schema
recordType(string, 필수): 오브젝트 타입 ID(예: ‘companies’).operation(string, 필수): 작업 유형(예: ‘CREATE_RECORD’).
