> For the complete documentation index, see [llms.txt](https://help.hyperflow.global/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.hyperflow.global/docs/builder-hyperflow/gerenciamento-de-aplicativos/fluxos/integracao/hubspot.md). # HubSpot ## 🟠 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. **📷 Inserir print:** visão geral do módulo HubSpot na área de trabalho do fluxo *** ### 🧭 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. **📷 Inserir print:** painel de módulos com a categoria Integração expandida e o módulo HubSpot visível {% hint style="warning" %} **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. {% endhint %} *** ### 🔍 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. **📷 Inserir print:** painel de configuração do módulo HubSpot aberto *** #### 🔌 Integração Selecione a integração HubSpot já cadastrada e conectada à sua conta. **📷 Inserir print:** campo Integração com a credencial HubSpot selecionada *** #### 🗂️ 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** **📷 Inserir print:** campo Tipo de registro com as opções disponíveis *** #### 🧩 Ação Depois de escolher o **Tipo de registro**, defina o que o módulo deve fazer com ele. **📷 Inserir print:** campo Ação com as opções disponíveis **🎯 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** 1. 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. 2. 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). {% hint style="info" %} Nem todo tipo de registro tem as 5 ações disponíveis — por exemplo, **Usuários** só permite **Buscar pelo ID** e **Listar**. Veja as particularidades de cada tipo na seção **🗂️ Tipos de registro em detalhe**, mais adiante neste documento. {% endhint %} **📌 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**. **📷 Inserir print:** ação Criar selecionada, com os campos do registro preenchidos *** #### 📋 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). **📷 Inserir print:** lista de campos preenchida para criação de um registro *** ### 🗂️ 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**. **📷 Inserir print:** configuração do módulo com o Tipo de registro "Contatos" selecionado *** #### 🤝 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**. **📷 Inserir print:** configuração do módulo com o Tipo de registro "Negócios" e os campos Pipeline e Estágio preenchidos *** #### 🏢 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**. **📷 Inserir print:** configuração do módulo com o Tipo de registro "Empresas" selecionado *** #### 🧾 Itens de linha Representa produtos ou serviços vinculados a um Negócio ou Orçamento no HubSpot. {% hint style="warning" %} 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. {% endhint %} **📷 Inserir print:** configuração do módulo com o Tipo de registro "Itens de linha" selecionado, mostrando apenas as ações de busca *** #### 📄 Orçamentos Representa propostas comerciais (orçamentos) já criadas no HubSpot. {% hint style="warning" %} 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. {% endhint %} **📷 Inserir print:** configuração do módulo com o Tipo de registro "Orçamentos" selecionado, mostrando apenas as ações de busca *** #### ✉️ E-mails Representa e-mails trocados com um contato, registrados no histórico do CRM. {% hint style="danger" %} No momento, o Tipo de registro **E-mails** não funciona corretamente neste módulo: a operação não é concluída, mesmo com os campos preenchidos corretamente. Até que esse comportamento seja corrigido, evite usar este tipo de registro no seu fluxo. {% endhint %} **📷 Inserir print:** configuração do módulo com o Tipo de registro "E-mails" selecionado *** #### 🗃️ 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. **📷 Inserir print:** configuração do módulo com um destes tipos de registro selecionado (por exemplo, Tickets) *** #### 🔀 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). **📷 Inserir print:** módulo na área de trabalho do fluxo mostrando as saídas Sucesso e Erro *** ### 💡 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. * Os tipos **Itens de linha** e **Orçamentos** permitem apenas consulta neste módulo — para criá-los ou atualizá-los, use diretamente o HubSpot. Evite usar o tipo **E-mails**, que no momento não funciona corretamente. *** ### 📝 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, e o tipo **E-mails** ainda não funciona corretamente neste módulo. * O módulo tem uma saída de **Sucesso**, com o resultado disponível para o fluxo, e uma saída de **Erro**.