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.

Antes de usar este módulo: é necessário ter uma integração do tipo HubSpot já cadastrada, conectada por login com sua conta HubSpot.

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