Começando
Funcionalidades
Documentação de Integração
- Integração com Asana
- Integração com Box
- Integração com ClickUp
- Integração com GitHub
- Integração com Gmail
- Integração com Google Calendar
- Integração com Google Sheets
- Integração com HubSpot
- Integração com Jira
- Integração com o Linear
- Integração com o Notion
- Integração com Salesforce
- Integração com Shopify
- Integração com Slack
- Integração Stripe
- Integração com Zendesk
Guias
Recursos
Integração com HubSpot
Gerencie empresas e contatos no HubSpot com o CrewAI.
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
uv add crewai-tools
Ações Disponíveis
Descrição: Crie um novo registro de empresa no HubSpot.
Parâmetros:
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.
Descrição: Crie um novo registro de contato no HubSpot.
Parâmetros:
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.
Descrição: Crie um novo registro de negócio (deal) no HubSpot.
Parâmetros:
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
.
Descrição: Crie um novo engajamento (ex: nota, e-mail, ligação, reunião, tarefa) no HubSpot.
Parâmetros:
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
)
Descrição: Atualize um registro de empresa existente no HubSpot.
Parâmetros:
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.
Descrição: Crie um registro para um tipo de objeto especificado no HubSpot.
Parâmetros:
recordType
(string, obrigatório): ID do tipo de objeto personalizado.- Parâmetros adicionais dependem do esquema do objeto personalizado.
Descrição: Atualize um registro de contato existente no HubSpot.
Parâmetros:
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.
Descrição: Atualize um registro de negócio existente no HubSpot.
Parâmetros:
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.
Descrição: Atualize um engajamento existente no HubSpot.
Parâmetros:
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.
Descrição: Atualize um registro para um tipo de objeto especificado no HubSpot.
Parâmetros:
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.
Descrição: Obtenha uma lista de registros de empresas do HubSpot.
Parâmetros:
paginationParameters
(object, opcional): UsepageCursor
para buscar páginas subsequentes.
Descrição: Obtenha uma lista de registros de contatos do HubSpot.
Parâmetros:
paginationParameters
(object, opcional): UsepageCursor
para buscar páginas subsequentes.
Descrição: Obtenha uma lista de registros de negócios do HubSpot.
Parâmetros:
paginationParameters
(object, opcional): UsepageCursor
para buscar páginas subsequentes.
Descrição: Obtenha uma lista de registros de engajamentos do HubSpot.
Parâmetros:
objectName
(string, obrigatório): O tipo de engajamento a ser buscado (ex.: “notes”).paginationParameters
(object, opcional): UsepageCursor
para buscar páginas subsequentes.
Descrição: Obtenha uma lista de registros de qualquer tipo de objeto no HubSpot.
Parâmetros:
recordType
(string, obrigatório): O ID do tipo de objeto personalizado.paginationParameters
(object, opcional): UsepageCursor
para buscar páginas subsequentes.
Descrição: Obtenha um registro de empresa pelo seu ID.
Parâmetros:
recordId
(string, obrigatório): ID da empresa a ser consultada.
Descrição: Obtenha um registro de contato pelo seu ID.
Parâmetros:
recordId
(string, obrigatório): ID do contato a ser consultado.
Descrição: Obtenha um registro de negócio pelo seu ID.
Parâmetros:
recordId
(string, obrigatório): ID do negócio a ser consultado.
Descrição: Obtenha um registro de engajamento pelo seu ID.
Parâmetros:
recordId
(string, obrigatório): ID do engajamento a ser consultado.
Descrição: Obtenha um registro de qualquer tipo de objeto especificado pelo seu ID.
Parâmetros:
recordType
(string, obrigatório): ID do tipo de objeto personalizado.recordId
(string, obrigatório): ID do registro a ser consultado.
Descrição: Pesquise registros de empresas no HubSpot utilizando uma fórmula de filtro.
Parâmetros:
filterFormula
(object, opcional): Filtro em forma normal disjuntiva (OU de E).paginationParameters
(object, opcional): UsepageCursor
para buscar páginas subsequentes.
Descrição: Pesquise registros de contatos no HubSpot utilizando uma fórmula de filtro.
Parâmetros:
filterFormula
(object, opcional): Filtro em forma normal disjuntiva (OU de E).paginationParameters
(object, opcional): UsepageCursor
para buscar páginas subsequentes.
Descrição: Pesquise registros de negócios no HubSpot utilizando uma fórmula de filtro.
Parâmetros:
filterFormula
(object, opcional): Filtro em forma normal disjuntiva (OU de E).paginationParameters
(object, opcional): UsepageCursor
para buscar páginas subsequentes.
Descrição: Pesquise registros de engajamento no HubSpot utilizando uma fórmula de filtro.
Parâmetros:
engagementFilterFormula
(object, opcional): Filtro para engajamentos.paginationParameters
(object, opcional): UsepageCursor
para buscar páginas subsequentes.
Descrição: Pesquise registros de qualquer tipo de objeto no HubSpot.
Parâmetros:
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.
Descrição: Exclua um registro de empresa pelo seu ID.
Parâmetros:
recordId
(string, obrigatório): ID da empresa a ser excluída.
Descrição: Exclua um registro de contato pelo seu ID.
Parâmetros:
recordId
(string, obrigatório): ID do contato a ser excluído.
Descrição: Exclua um registro de negócio pelo seu ID.
Parâmetros:
recordId
(string, obrigatório): ID do negócio a ser excluído.
Descrição: Exclua um registro de engajamento pelo seu ID.
Parâmetros:
recordId
(string, obrigatório): ID do engajamento a ser excluído.
Descrição: Exclua um registro de qualquer tipo de objeto especificado pelo seu ID.
Parâmetros:
recordType
(string, obrigatório): ID do tipo de objeto personalizado.recordId
(string, obrigatório): ID do registro a ser excluído.
Descrição: Obtenha contatos de uma lista específica pelo seu ID.
Parâmetros:
listId
(string, obrigatório): ID da lista da qual obter os contatos.paginationParameters
(object, opcional): UsepageCursor
para páginas subsequentes.
Descrição: Obtenha o esquema esperado para um dado tipo de objeto e operação.
Parâmetros:
recordType
(string, obrigatório): ID do tipo de objeto (ex.: ‘companies’).operation
(string, obrigatório): Tipo de operação (ex.: ‘CREATE_RECORD’).
Exemplos de Uso
Configuração Básica de Agente HubSpot
from crewai import Agent, Task, Crew
from crewai_tools import CrewaiEnterpriseTools
# Obtenha as ferramentas enterprise (ferramentas HubSpot incluídas)
enterprise_tools = CrewaiEnterpriseTools(
enterprise_token="your_enterprise_token"
)
# Crie um agente com capacidades HubSpot
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 para criar nova empresa
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"
)
# Execute a tarefa
crew = Crew(
agents=[hubspot_agent],
tasks=[create_company_task]
)
crew.kickoff()
Filtrando Ferramentas HubSpot Específicas
from crewai_tools import CrewaiEnterpriseTools
# Obtenha somente a ferramenta para criar contatos
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 para criar contato
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()
Gerenciamento de Contatos
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 para gerenciar contatos
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()
Precisa de Ajuda?
Precisa de Ajuda?
Entre em contato com nossa equipe de suporte para assistência na configuração ou solução de problemas com a integração HubSpot.
Esta página foi útil?