Visão Geral
Permita que seus agentes gerenciem empresas e contatos dentro do HubSpot. Crie novos registros e otimize seus processos de CRM com automação baseada em IA.Pré-requisitos
Antes de utilizar a integração com o HubSpot, certifique-se de que você possui:- Uma conta CrewAI AMP com assinatura ativa.
- Uma conta HubSpot com permissões adequadas.
- Sua conta HubSpot conectada pela página de Integrações.
Configurando a Integração com o HubSpot
1. Conecte Sua Conta HubSpot
- Navegue até CrewAI AMP Integrações.
- Encontre HubSpot na seção de Integrações de Autenticação.
- Clique em Conectar e complete o fluxo OAuth.
- Conceda as permissões necessárias para gerenciamento de empresas e contatos.
- Copie o seu Token Enterprise nas Configurações de Integração
2. Instale o Pacote Necessário
3. Configuração de variável de ambiente
Agent(apps=[]), você deve definir a variável de ambiente CREWAI_PLATFORM_INTEGRATION_TOKEN com seu Enterprise Token..env:
Ações Disponíveis
hubspot/create_company
hubspot/create_company
name(string, obrigatório): Nome da empresa.domain(string, opcional): Nome do domínio da empresa.industry(string, opcional): Setor. Deve ser um dos valores predefinidos do HubSpot.phone(string, opcional): Telefone.hubspot_owner_id(string, opcional): ID do responsável pela empresa.type(string, opcional): Tipo da empresa. Valores disponíveis:PROSPECT,PARTNER,RESELLER,VENDOR,OTHER.city(string, opcional): Cidade.state(string, opcional): Estado/Região.zip(string, opcional): CEP.numberofemployees(number, opcional): Número de funcionários.annualrevenue(number, opcional): Receita anual.timezone(string, opcional): Fuso horário.description(string, opcional): Descrição.linkedin_company_page(string, opcional): URL da página da empresa no LinkedIn.company_email(string, opcional): E-mail da empresa.first_name(string, opcional): Nome do contato na empresa.last_name(string, opcional): Sobrenome do contato na empresa.about_us(string, opcional): Sobre nós.hs_csm_sentiment(string, opcional): Sentimento CSM. Valores disponíveis:at_risk,neutral,healthy.closedate(string, opcional): Data de fechamento.hs_keywords(string, opcional): Palavras-chave da empresa. Deve ser um dos valores predefinidos.country(string, opcional): País/Região.hs_country_code(string, opcional): Código do País/Região.hs_employee_range(string, opcional): Faixa de funcionários.facebook_company_page(string, opcional): URL da página da empresa no Facebook.facebookfans(number, opcional): Número de fãs no Facebook.hs_gps_coordinates(string, opcional): Coordenadas GPS.hs_gps_error(string, opcional): Erro de GPS.googleplus_page(string, opcional): URL da página do Google Plus.owneremail(string, opcional): E-mail do proprietário no HubSpot.ownername(string, opcional): Nome do proprietário no HubSpot.hs_ideal_customer_profile(string, opcional): Tier de Perfil de Cliente Ideal. Valores disponíveis:tier_1,tier_2,tier_3.hs_industry_group(string, opcional): Grupo do setor.is_public(boolean, opcional): É público.hs_last_metered_enrichment_timestamp(string, opcional): Último registro de enriquecimento medido.hs_lead_status(string, opcional): Status do lead. Valores disponíveis:NEW,OPEN,IN_PROGRESS,OPEN_DEAL,UNQUALIFIED,ATTEMPTED_TO_CONTACT,CONNECTED,BAD_TIMING.lifecyclestage(string, opcional): Estágio no ciclo de vida. Valores disponíveis:subscriber,lead,marketingqualifiedlead,salesqualifiedlead,opportunity,customer,evangelist,other.linkedinbio(string, opcional): Bio do LinkedIn.hs_linkedin_handle(string, opcional): Handle do LinkedIn.hs_live_enrichment_deadline(string, opcional): Prazo para enriquecimento ao vivo.hs_logo_url(string, opcional): URL do logotipo.hs_analytics_source(string, opcional): Fonte original do tráfego.hs_pinned_engagement_id(number, opcional): ID do engajamento fixado.hs_quick_context(string, opcional): Contexto rápido.hs_revenue_range(string, opcional): Faixa de receita.hs_state_code(string, opcional): Código do Estado/Região.address(string, opcional): Endereço.address2(string, opcional): Complemento de endereço.hs_is_target_account(boolean, opcional): Conta alvo.hs_target_account(string, opcional): Tier da Conta Alvo. Valores disponíveis:tier_1,tier_2,tier_3.hs_target_account_recommendation_snooze_time(string, opcional): Tempo para adiar recomendação de conta alvo.hs_target_account_recommendation_state(string, opcional): Estado da recomendação da conta alvo. Valores disponíveis:DISMISSED,NONE,SNOOZED.total_money_raised(string, opcional): Total arrecadado.twitterbio(string, opcional): Bio do Twitter.twitterfollowers(number, opcional): Seguidores no Twitter.twitterhandle(string, opcional): Usuário do Twitter.web_technologies(string, opcional): Tecnologias web utilizadas. Deve ser um dos valores predefinidos.website(string, opcional): URL do site.founded_year(string, opcional): Ano de fundação.
hubspot/create_contact
hubspot/create_contact
email(string, obrigatório): E-mail do contato.firstname(string, opcional): Nome.lastname(string, opcional): Sobrenome.phone(string, opcional): Telefone.hubspot_owner_id(string, opcional): Responsável pelo contato.lifecyclestage(string, opcional): Estágio no ciclo de vida. Valores disponíveis:subscriber,lead,marketingqualifiedlead,salesqualifiedlead,opportunity,customer,evangelist,other.hs_lead_status(string, opcional): Status do lead. Valores disponíveis:NEW,OPEN,IN_PROGRESS,OPEN_DEAL,UNQUALIFIED,ATTEMPTED_TO_CONTACT,CONNECTED,BAD_TIMING.annualrevenue(string, opcional): Receita anual.hs_buying_role(string, opcional): Papel na compra.cc_emails(string, opcional): E-mails em cópia.ch_customer_id(string, opcional): ID do cliente no Chargify.ch_customer_reference(string, opcional): Referência do cliente no Chargify.chargify_sites(string, opcional): Sites Chargify.city(string, opcional): Cidade.hs_facebook_ad_clicked(boolean, opcional): Clicou em anúncio do Facebook.hs_linkedin_ad_clicked(string, opcional): Clicou em anúncio do LinkedIn.hs_clicked_linkedin_ad(string, opcional): Clicou em anúncio do LinkedIn.closedate(string, opcional): Data de fechamento.company(string, opcional): Nome da empresa.company_size(string, opcional): Tamanho da empresa.country(string, opcional): País/Região.hs_country_region_code(string, opcional): Código do País/Região.date_of_birth(string, opcional): Data de nascimento.degree(string, opcional): Grau de instrução.hs_email_customer_quarantined_reason(string, opcional): Motivo da quarentena de e-mail.hs_role(string, opcional): Cargo. Deve ser um dos valores predefinidos.hs_seniority(string, opcional): Senioridade. Deve ser um dos valores predefinidos.hs_sub_role(string, opcional): Sub papel. Deve ser um dos valores predefinidos.hs_employment_change_detected_date(string, opcional): Data da detecção de mudança de emprego.hs_enriched_email_bounce_detected(boolean, opcional): Bounce de e-mail enriquecido detectado.hs_facebookid(string, opcional): Facebook ID.hs_facebook_click_id(string, opcional): ID de clique no Facebook.fax(string, opcional): Fax.field_of_study(string, opcional): Área de estudo.followercount(number, opcional): Número de seguidores.gender(string, opcional): Gênero.hs_google_click_id(string, opcional): ID de clique no Google.graduation_date(string, opcional): Data de graduação.owneremail(string, opcional): E-mail do proprietário no HubSpot (legado).ownername(string, opcional): Nome do proprietário no HubSpot (legado).industry(string, opcional): Setor.hs_inferred_language_codes(string, opcional): Códigos de idioma inferido. Deve ser um dos valores predefinidos.jobtitle(string, opcional): Cargo.hs_job_change_detected_date(string, opcional): Data de detecção de mudança de emprego.job_function(string, opcional): Função.hs_journey_stage(string, opcional): Estágio da jornada. Deve ser um dos valores predefinidos.kloutscoregeneral(number, opcional): Klout Score.hs_last_metered_enrichment_timestamp(string, opcional): Último registro de enriquecimento medido.hs_latest_source(string, opcional): Fonte de tráfego mais recente.hs_latest_source_timestamp(string, opcional): Data da fonte mais recente.hs_legal_basis(string, opcional): Base legal para o processamento dos dados do contato.linkedinbio(string, opcional): Bio do LinkedIn.linkedinconnections(number, opcional): Conexões no LinkedIn.hs_linkedin_url(string, opcional): URL do LinkedIn.hs_linkedinid(string, opcional): Linkedin ID.hs_live_enrichment_deadline(string, opcional): Prazo para enriquecimento ao vivo.marital_status(string, opcional): Estado civil.hs_content_membership_email(string, opcional): E-mail de membro.hs_content_membership_notes(string, opcional): Notas de associação.message(string, opcional): Mensagem.military_status(string, opcional): Status militar.mobilephone(string, opcional): Celular.numemployees(string, opcional): Número de funcionários.hs_analytics_source(string, opcional): Fonte original do tráfego.photo(string, opcional): Foto.hs_pinned_engagement_id(number, opcional): ID de engajamento fixado.zip(string, opcional): CEP.hs_language(string, opcional): Idioma preferencial. Deve ser um dos valores predefinidos.associatedcompanyid(number, opcional): ID da empresa associada primária.hs_email_optout_survey_reason(string, opcional): Motivo da recusa de e-mail.relationship_status(string, opcional): Status de relacionamento.hs_returning_to_office_detected_date(string, opcional): Data de retorno ao escritório detectada.salutation(string, opcional): Saudação.school(string, opcional): Escola.seniority(string, opcional): Senioridade.hs_feedback_show_nps_web_survey(boolean, opcional): Mostrar pesquisa NPS na web.start_date(string, opcional): Data de início.state(string, opcional): Estado/Região.hs_state_code(string, opcional): Código do Estado/Região.hs_content_membership_status(string, opcional): Status.address(string, opcional): Endereço.tax_exempt(string, opcional): Isento de impostos.hs_timezone(string, opcional): Fuso horário. Deve ser um dos valores predefinidos.twitterbio(string, opcional): Bio do Twitter.hs_twitterid(string, opcional): Twitter ID.twitterprofilephoto(string, opcional): Foto de perfil do Twitter.twitterhandle(string, opcional): Usuário do Twitter.vat_number(string, opcional): Número VAT.ch_verified(string, opcional): Verificado para pagamentos ACH/eCheck.website(string, opcional): URL do site.hs_whatsapp_phone_number(string, opcional): Número do WhatsApp.work_email(string, opcional): E-mail corporativo.hs_googleplusid(string, opcional): googleplus ID.
hubspot/create_deal
hubspot/create_deal
dealname(string, obrigatório): Nome do negócio.amount(number, opcional): Valor do negócio.dealstage(string, opcional): Estágio no pipeline.pipeline(string, opcional): Pipeline ao qual o negócio pertence.closedate(string, opcional): Data prevista de fechamento do negócio.hubspot_owner_id(string, opcional): Responsável pelo negócio.dealtype(string, opcional): Tipo do negócio. Valores disponíveis:newbusiness,existingbusiness.description(string, opcional): Descrição do negócio.hs_priority(string, opcional): Prioridade do negócio. Valores disponíveis:low,medium,high.
hubspot/create_record_engagements
hubspot/create_record_engagements
engagementType(string, obrigatório): Tipo de engajamento. Valores disponíveis:NOTE,EMAIL,CALL,MEETING,TASK.hubspot_owner_id(string, opcional): Usuário responsável pela atividade.hs_timestamp(string, opcional): Data e hora da atividade.hs_note_body(string, opcional): Corpo da nota. (Utilizado paraNOTE)hs_task_subject(string, opcional): Título da tarefa. (Utilizado paraTASK)hs_task_body(string, opcional): Notas da tarefa. (Utilizado paraTASK)hs_task_status(string, opcional): Status da tarefa. (Utilizado paraTASK)hs_meeting_title(string, opcional): Título da reunião. (Utilizado paraMEETING)hs_meeting_body(string, opcional): Descrição da reunião. (Utilizado paraMEETING)hs_meeting_start_time(string, opcional): Horário de início da reunião. (Utilizado paraMEETING)hs_meeting_end_time(string, opcional): Horário de término da reunião. (Utilizado paraMEETING)
hubspot/update_company
hubspot/update_company
recordId(string, obrigatório): ID da empresa a ser atualizada.name(string, opcional): Nome da empresa.domain(string, opcional): Nome do domínio da empresa.industry(string, opcional): Setor.phone(string, opcional): Telefone.city(string, opcional): Cidade.state(string, opcional): Estado/Região.zip(string, opcional): CEP.numberofemployees(number, opcional): Número de funcionários.annualrevenue(number, opcional): Receita anual.description(string, opcional): Descrição.
hubspot/create_record_any
hubspot/create_record_any
recordType(string, obrigatório): ID do tipo de objeto personalizado.- Parâmetros adicionais dependem do esquema do objeto personalizado.
hubspot/update_contact
hubspot/update_contact
recordId(string, obrigatório): ID do contato a ser atualizado.firstname(string, opcional): Nome.lastname(string, opcional): Sobrenome.email(string, opcional): E-mail.phone(string, opcional): Telefone.company(string, opcional): Nome da empresa.jobtitle(string, opcional): Cargo.lifecyclestage(string, opcional): Estágio no ciclo de vida.
hubspot/update_deal
hubspot/update_deal
recordId(string, obrigatório): ID do negócio a ser atualizado.dealname(string, opcional): Nome do negócio.amount(number, opcional): Valor do negócio.dealstage(string, opcional): Estágio do pipeline.pipeline(string, opcional): Pipeline ao qual o negócio pertence.closedate(string, opcional): Data prevista de fechamento.dealtype(string, opcional): Tipo de negócio.
hubspot/update_record_engagements
hubspot/update_record_engagements
recordId(string, obrigatório): ID do engajamento a ser atualizado.hs_note_body(string, opcional): Corpo da nota.hs_task_subject(string, opcional): Título da tarefa.hs_task_body(string, opcional): Notas da tarefa.hs_task_status(string, opcional): Status da tarefa.
hubspot/update_record_any
hubspot/update_record_any
recordId(string, obrigatório): ID do registro a ser atualizado.recordType(string, obrigatório): ID do tipo de objeto personalizado.- Parâmetros adicionais dependem do esquema do objeto personalizado.
hubspot/list_companies
hubspot/list_companies
paginationParameters(object, opcional): UsepageCursorpara buscar páginas subsequentes.
hubspot/list_contacts
hubspot/list_contacts
paginationParameters(object, opcional): UsepageCursorpara buscar páginas subsequentes.
hubspot/list_deals
hubspot/list_deals
paginationParameters(object, opcional): UsepageCursorpara buscar páginas subsequentes.
hubspot/get_records_engagements
hubspot/get_records_engagements
objectName(string, obrigatório): O tipo de engajamento a ser buscado (ex.: “notes”).paginationParameters(object, opcional): UsepageCursorpara buscar páginas subsequentes.
hubspot/get_records_any
hubspot/get_records_any
recordType(string, obrigatório): O ID do tipo de objeto personalizado.paginationParameters(object, opcional): UsepageCursorpara buscar páginas subsequentes.
hubspot/get_company
hubspot/get_company
recordId(string, obrigatório): ID da empresa a ser consultada.
hubspot/get_contact
hubspot/get_contact
recordId(string, obrigatório): ID do contato a ser consultado.
hubspot/get_deal
hubspot/get_deal
recordId(string, obrigatório): ID do negócio a ser consultado.
hubspot/get_record_by_id_engagements
hubspot/get_record_by_id_engagements
recordId(string, obrigatório): ID do engajamento a ser consultado.
hubspot/get_record_by_id_any
hubspot/get_record_by_id_any
recordType(string, obrigatório): ID do tipo de objeto personalizado.recordId(string, obrigatório): ID do registro a ser consultado.
hubspot/search_companies
hubspot/search_companies
filterFormula(object, opcional): Filtro em forma normal disjuntiva (OU de E).paginationParameters(object, opcional): UsepageCursorpara buscar páginas subsequentes.
hubspot/search_contacts
hubspot/search_contacts
filterFormula(object, opcional): Filtro em forma normal disjuntiva (OU de E).paginationParameters(object, opcional): UsepageCursorpara buscar páginas subsequentes.
hubspot/search_deals
hubspot/search_deals
filterFormula(object, opcional): Filtro em forma normal disjuntiva (OU de E).paginationParameters(object, opcional): UsepageCursorpara buscar páginas subsequentes.
hubspot/search_records_engagements
hubspot/search_records_engagements
engagementFilterFormula(object, opcional): Filtro para engajamentos.paginationParameters(object, opcional): UsepageCursorpara buscar páginas subsequentes.
hubspot/search_records_any
hubspot/search_records_any
recordType(string, obrigatório): O ID do tipo de objeto para pesquisa.filterFormula(string, opcional): Fórmula de filtro a aplicar.paginationParameters(object, opcional): UsepageCursorpara buscar páginas subsequentes.
hubspot/delete_record_companies
hubspot/delete_record_companies
recordId(string, obrigatório): ID da empresa a ser excluída.
hubspot/delete_record_contacts
hubspot/delete_record_contacts
recordId(string, obrigatório): ID do contato a ser excluído.
hubspot/delete_record_deals
hubspot/delete_record_deals
recordId(string, obrigatório): ID do negócio a ser excluído.
hubspot/delete_record_engagements
hubspot/delete_record_engagements
recordId(string, obrigatório): ID do engajamento a ser excluído.
hubspot/delete_record_any
hubspot/delete_record_any
recordType(string, obrigatório): ID do tipo de objeto personalizado.recordId(string, obrigatório): ID do registro a ser excluído.
hubspot/get_contacts_by_list_id
hubspot/get_contacts_by_list_id
listId(string, obrigatório): ID da lista da qual obter os contatos.paginationParameters(object, opcional): UsepageCursorpara páginas subsequentes.
hubspot/describe_action_schema
hubspot/describe_action_schema
recordType(string, obrigatório): ID do tipo de objeto (ex.: ‘companies’).operation(string, obrigatório): Tipo de operação (ex.: ‘CREATE_RECORD’).
