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 Enterprise 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 Enterprise 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 da Conta.
2. Instale o Pacote Necessário
Ações Disponíveis
HUBSPOT_CREATE_RECORD_COMPANIES
HUBSPOT_CREATE_RECORD_COMPANIES
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_RECORD_CONTACTS
HUBSPOT_CREATE_RECORD_CONTACTS
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_RECORD_DEALS
HUBSPOT_CREATE_RECORD_DEALS
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_RECORD_COMPANIES
HUBSPOT_UPDATE_RECORD_COMPANIES
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_RECORD_CONTACTS
HUBSPOT_UPDATE_RECORD_CONTACTS
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_RECORD_DEALS
HUBSPOT_UPDATE_RECORD_DEALS
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_GET_RECORDS_COMPANIES
HUBSPOT_GET_RECORDS_COMPANIES
paginationParameters
(object, opcional): UsepageCursor
para buscar páginas subsequentes.
HUBSPOT_GET_RECORDS_CONTACTS
HUBSPOT_GET_RECORDS_CONTACTS
paginationParameters
(object, opcional): UsepageCursor
para buscar páginas subsequentes.
HUBSPOT_GET_RECORDS_DEALS
HUBSPOT_GET_RECORDS_DEALS
paginationParameters
(object, opcional): UsepageCursor
para 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): UsepageCursor
para 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): UsepageCursor
para buscar páginas subsequentes.
HUBSPOT_GET_RECORD_BY_ID_COMPANIES
HUBSPOT_GET_RECORD_BY_ID_COMPANIES
recordId
(string, obrigatório): ID da empresa a ser consultada.
HUBSPOT_GET_RECORD_BY_ID_CONTACTS
HUBSPOT_GET_RECORD_BY_ID_CONTACTS
recordId
(string, obrigatório): ID do contato a ser consultado.
HUBSPOT_GET_RECORD_BY_ID_DEALS
HUBSPOT_GET_RECORD_BY_ID_DEALS
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_RECORDS_COMPANIES
HUBSPOT_SEARCH_RECORDS_COMPANIES
filterFormula
(object, opcional): Filtro em forma normal disjuntiva (OU de E).paginationParameters
(object, opcional): UsepageCursor
para buscar páginas subsequentes.
HUBSPOT_SEARCH_RECORDS_CONTACTS
HUBSPOT_SEARCH_RECORDS_CONTACTS
filterFormula
(object, opcional): Filtro em forma normal disjuntiva (OU de E).paginationParameters
(object, opcional): UsepageCursor
para buscar páginas subsequentes.
HUBSPOT_SEARCH_RECORDS_DEALS
HUBSPOT_SEARCH_RECORDS_DEALS
filterFormula
(object, opcional): Filtro em forma normal disjuntiva (OU de E).paginationParameters
(object, opcional): UsepageCursor
para buscar páginas subsequentes.
HUBSPOT_SEARCH_RECORDS_ENGAGEMENTS
HUBSPOT_SEARCH_RECORDS_ENGAGEMENTS
engagementFilterFormula
(object, opcional): Filtro para engajamentos.paginationParameters
(object, opcional): UsepageCursor
para 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): UsepageCursor
para 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): UsepageCursor
para 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’).