HubSpot
O módulo HubSpot permite que o fluxo interaja diretamente com o seu CRM HubSpot — criando, atualizando e consultando registros como contatos, empresas, negócios, tickets e outros tipos de objeto, sem sair da conversa.
🧭 Como acessar
No menu lateral, clique em Gerenciamento de aplicativos.
Em seguida, clique em Fluxos.
Abra ou crie um fluxo e acesse a área de trabalho do fluxo.
No painel de módulos, localize a categoria Integração (identificada pela cor azul).
Arraste o módulo HubSpot para a área de trabalho do fluxo.
Antes de usar este módulo: é necessário ter uma integração do tipo HubSpot já cadastrada, conectada por login com sua conta HubSpot. Para cadastrar, acesse Gerenciamento de aplicativos > Integrações, adicione uma integração do tipo HubSpot e conclua o login. Depois de cadastrada, volte para a tela de Fluxos e continue a configuração do módulo normalmente.
🔍 Conhecendo o módulo
Ao clicar duas vezes no módulo na área de trabalho do fluxo, um painel de configuração é aberto na lateral da tela.
🔌 Integração
Selecione a integração HubSpot já cadastrada e conectada à sua conta.
🗂️ Tipo de registro
Escolha o tipo de registro do HubSpot com o qual deseja trabalhar:
Contatos
Empresas
Negócios
Tickets
Itens de linha
Orçamentos
Ligações
E-mails
Reuniões
Notas
Atividades (tarefas do HubSpot)
Usuários
🧩 Ação
Depois de escolher o Tipo de registro, defina o que o módulo deve fazer com ele.
🎯 Propósito
Indicar ao módulo se ele deve criar um registro novo, atualizar um já existente ou apenas consultar informações já cadastradas no HubSpot.
✅ Como fazer na tela
No campo Ação, escolha uma das opções abaixo (as opções exibidas variam de acordo com o Tipo de registro selecionado):
Criar — cria um novo registro.
Atualizar — edita um registro existente, informado pelo ID.
Buscar pelo ID — consulta um único registro pelo ID.
Buscar vários pelo ID — consulta múltiplos registros a partir de uma lista de IDs.
Listar — busca registros com base em filtros.
Preencha os campos exibidos para a ação escolhida (veja a seção Campos, logo abaixo, e o detalhamento por tipo de registro mais adiante neste documento).
📌 Resultado esperado
Ao rodar o fluxo, o módulo executa a ação escolhida diretamente no HubSpot. Se a operação for concluída, o resultado fica disponível para os próximos módulos pela saída Sucesso; caso contrário, o fluxo segue pela saída Erro.
📋 Campos
Os campos disponíveis para preencher (na criação/atualização) ou usar como critério de busca são carregados automaticamente da sua conta HubSpot, refletindo as propriedades já configuradas para cada tipo de registro — incluindo campos personalizados.
Para tipos de registro com relacionamento (como Negócios e Tickets), também é possível selecionar Pipeline e Estágio, e vincular Associações com outros registros (por exemplo, associar um Negócio a um Contato).
🗂️ Tipos de registro em detalhe
Cada tipo de registro tem suas próprias particularidades. Veja abaixo o que esperar dos principais.
👤 Contatos
Use para criar, atualizar ou consultar pessoas cadastradas no seu CRM, com propriedades como nome, e-mail e telefone.
Ações disponíveis: Criar, Atualizar, Buscar pelo ID, Buscar vários pelo ID e Listar.
🤝 Negócios
Use para registrar oportunidades de venda. Além dos campos próprios, é possível selecionar Pipeline e Estágio, e vincular Associações com contatos ou empresas relacionados.
Ações disponíveis: Criar, Atualizar, Buscar pelo ID, Buscar vários pelo ID e Listar.
🏢 Empresas
Use para criar, atualizar ou consultar empresas cadastradas no seu CRM.
Ações disponíveis: Criar, Atualizar, Buscar pelo ID, Buscar vários pelo ID e Listar.
🧾 Itens de linha
Representa produtos ou serviços vinculados a um Negócio ou Orçamento no HubSpot.
No momento, Itens de linha está disponível apenas para consulta (Buscar pelo ID e Buscar vários pelo ID). Ainda não é possível criar ou atualizar itens de linha por este módulo — para isso, use diretamente o HubSpot.
📄 Orçamentos
Representa propostas comerciais (orçamentos) já criadas no HubSpot.
No momento, Orçamentos está disponível apenas para consulta (Buscar pelo ID e Buscar vários pelo ID). Ainda não é possível criar ou atualizar orçamentos por este módulo — para isso, use diretamente o HubSpot.
🗃️ Outros tipos de registro
Os demais tipos de registro seguem o mesmo padrão de configuração, com pequenas particularidades:
Tickets — chamados de atendimento ao cliente, com Pipeline e Estágio próprios.
Ligações — registros de chamadas telefônicas associadas a um contato ou negócio.
Reuniões — compromissos agendados, associados a um registro do CRM.
Notas — anotações internas vinculadas a um registro.
Atividades (tarefas do HubSpot) — pendências atribuídas a um usuário.
Usuários — consulta os usuários (donos de registro) da sua conta HubSpot. Disponível apenas para Buscar pelo ID e Listar, já que usuários não podem ser criados nem editados por este módulo.
🔀 Saídas do módulo
O módulo tem duas saídas:
Sucesso — a operação foi concluída, com o resultado retornado pelo HubSpot disponível para os próximos módulos do fluxo.
Erro — não foi possível concluir a operação (por exemplo, registro não encontrado, campo inválido ou falha de conexão).
💡 Caso de uso
Cenário: uma empresa quer criar automaticamente um novo contato no HubSpot sempre que um lead se cadastra pelo chatbot.
Configuração:
Adicione o módulo HubSpot ao fluxo, no ponto em que os dados do lead já foram coletados.
Selecione a integração HubSpot já cadastrada.
No campo Tipo de registro, selecione Contatos.
No campo Ação, selecione Criar.
Preencha os campos (e-mail, nome, telefone) com as variáveis coletadas na conversa.
Conecte a saída Sucesso para dar continuidade ao atendimento.
Resultado: cada novo lead capturado pelo chatbot é automaticamente registrado como um contato no HubSpot.
📌 Dicas úteis
Os campos disponíveis dependem das propriedades já cadastradas no seu HubSpot — cadastre campos personalizados por lá antes de usá-los no módulo.
Use Buscar pelo ID ou Listar para verificar se um registro já existe antes de criar um duplicado.
Sempre conecte a saída Erro a algum tratamento, já que operações no CRM podem falhar por diversos motivos.
Use Associações para relacionar registros diferentes, como vincular um Negócio ao Contato correspondente.
Os tipos Itens de linha e Orçamentos permitem apenas consulta neste módulo — para criá-los ou atualizá-los, use diretamente o HubSpot.
📝 Resumo
O módulo HubSpot cria, atualiza e consulta registros do CRM HubSpot diretamente do fluxo.
Suporta 12 tipos de registro, cada um com suas próprias ações disponíveis — veja o detalhamento na seção Tipos de registro em detalhe.
Os campos são carregados automaticamente da sua conta HubSpot.
Itens de linha e Orçamentos só permitem consulta.
O módulo tem uma saída de Sucesso, com o resultado disponível para o fluxo, e uma saída de Erro.
Last updated
Was this helpful?