For the complete documentation index, see llms.txt. This page is also available as Markdown.

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

  1. No menu lateral, clique em Gerenciamento de aplicativos.

  2. Em seguida, clique em Fluxos.

  3. Abra ou crie um fluxo e acesse a área de trabalho do fluxo.

  4. No painel de módulos, localize a categoria Integração (identificada pela cor azul).

  5. Arraste o módulo HubSpot para a área de trabalho do fluxo.

🔍 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

Para a maioria dos tipos de registro, escolha entre:

  • 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.

O tipo Usuários só permite Buscar pelo ID e Listar, já que usuários do HubSpot não podem ser criados nem editados por este módulo.

📋 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).

🔀 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:

  1. Adicione o módulo HubSpot ao fluxo, no ponto em que os dados do lead já foram coletados.

  2. Selecione a integração HubSpot já cadastrada.

  3. No campo Tipo de registro, selecione Contatos.

  4. No campo Ação, selecione Criar.

  5. Preencha os campos (e-mail, nome, telefone) com as variáveis coletadas na conversa.

  6. 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.

📝 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.

  • Os campos são carregados automaticamente da sua conta HubSpot.

  • O módulo tem uma saída de Sucesso, com o resultado disponível para o fluxo, e uma saída de Erro.