> 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

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.

<figure><img src="https://3829578295-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRWteFkm020DS5IbXoSgj%2Fuploads%2FliR83PVtDM3uvYlXtcis%2F01-visao-geral-canvas.png?alt=media&amp;token=d74adeb2-6b09-42d0-85f9-ace174336430" alt=""><figcaption><p>Imagem 1 - Visão geral do módulo HubSpot na área de trabalho do fluxo.</p></figcaption></figure>

***

### 🧭 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.

<figure><img src="https://3829578295-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRWteFkm020DS5IbXoSgj%2Fuploads%2FfmifF763IHiHVMchIAZe%2F02-lista-modulo-hubspot.png?alt=media&amp;token=042c183c-d434-4e6c-bfea-445fca507eb0" alt=""><figcaption><p>Imagem 2 - Painel de módulos com a categoria Integração expandida e o módulo HubSpot visível.</p></figcaption></figure>

{% 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.

<figure><img src="https://3829578295-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRWteFkm020DS5IbXoSgj%2Fuploads%2Fg6ncUKGG1PidpkRLXayn%2F03-painel-aberto.png?alt=media&amp;token=22a6d5c8-7073-447b-87ac-a5df89257a97" alt=""><figcaption><p>Imagem 3 - Painel de configuração do módulo HubSpot aberto.</p></figcaption></figure>

***

#### 🔌 Integração

Selecione a integração HubSpot já cadastrada e conectada à sua conta.

<figure><img src="https://3829578295-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRWteFkm020DS5IbXoSgj%2Fuploads%2FGBoO64t0ZaQnaBlOmO5f%2F04-integracao-hyperflow.png?alt=media&amp;token=b39f7e22-f1f1-4eba-a78d-ad848cb5b706" alt=""><figcaption><p>Imagem 5 - Campo Tipo de registro com as opções disponíveis.</p></figcaption></figure>

***

#### 🗂️ 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**

<figure><img src="https://3829578295-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRWteFkm020DS5IbXoSgj%2Fuploads%2FHizwL9doKT5jWfJAG6sl%2F05-tipo-registro.png?alt=media&amp;token=86992903-563b-4a2f-9339-16fd1b6ede7a" alt=""><figcaption></figcaption></figure>

***

#### 🧩 Ação

Depois de escolher o **Tipo de registro**, defina o que o módulo deve fazer com ele.

<figure><img src="https://3829578295-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRWteFkm020DS5IbXoSgj%2Fuploads%2FrKfHKeTRKUO2XIB78Q6I%2F06-acao-opcoes.png?alt=media&amp;token=461aead0-98e8-4b09-997e-0e0b02140ee9" alt=""><figcaption><p>Imagem 6 - Campo Ação com as opções disponíveis.</p></figcaption></figure>

**🎯 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**.

<figure><img src="https://3829578295-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRWteFkm020DS5IbXoSgj%2Fuploads%2FspWqfoHyCAXENP9kxo2n%2F07-acao-criar-campos.png?alt=media&amp;token=daba884a-5170-420c-b5b6-d65523e28c34" alt=""><figcaption><p>Imagem 7 - Ação Criar selecionada, com os campos do registro preenchidos.</p></figcaption></figure>

***

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

<figure><img src="https://3829578295-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRWteFkm020DS5IbXoSgj%2Fuploads%2Fnd6DmzovcaIfQukbgqz6%2F08-lista-campos-preenchida.png?alt=media&amp;token=842a8d21-3f55-4d22-bbb6-f4ff8d738ab8" alt=""><figcaption><p>Imagem 8 - Lista de campos preenchida para criação de um registro.</p></figcaption></figure>

***

### 🗂️ 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**.

<figure><img src="https://3829578295-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRWteFkm020DS5IbXoSgj%2Fuploads%2FmWpCz7hYGIYF64u38h37%2F09-tipo-contatos.png?alt=media&amp;token=1e16cf85-602b-4644-b291-52e57f3fe715" alt=""><figcaption><p>Imagem 9 - Configuração do módulo com o Tipo de registro "Contatos" selecionado.</p></figcaption></figure>

***

#### 🤝 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**.

<figure><img src="https://3829578295-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRWteFkm020DS5IbXoSgj%2Fuploads%2FJ6BMxMZ3WJSPvt3VBa6y%2F10-tipo-negocios-pipeline.png?alt=media&amp;token=abdfa70c-e9b7-44b2-bda2-c408c12f81da" alt=""><figcaption><p>Imagem 10 - Configuração do módulo com o Tipo de registro "Negócios" e os campos Pipeline e Estágio preenchidos.</p></figcaption></figure>

***

#### 🏢 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**.

<figure><img src="https://3829578295-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRWteFkm020DS5IbXoSgj%2Fuploads%2FDEf4hqHaX4Y7iFsHZD62%2F11-tipo-empresas.png?alt=media&amp;token=ce6ef219-8ea4-4f89-8d74-7db9a3cc57cf" alt=""><figcaption><p>Imagem 11 - Configuração do módulo com o Tipo de registro "Empresas" selecionado.</p></figcaption></figure>

***

#### 🧾 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 %}

<figure><img src="https://3829578295-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRWteFkm020DS5IbXoSgj%2Fuploads%2FloLREwzJdXk3vVutP9fo%2F12-tipo-itens-linha-acoes.png?alt=media&amp;token=1aa00ac0-a73f-4838-a85f-4c6e002c7d99" alt=""><figcaption><p>Imagem 12 - Configuração do módulo com o Tipo de registro "Itens de linha" selecionado, mostrando apenas as ações de busca.</p></figcaption></figure>

***

#### 📄 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 %}

<figure><img src="https://3829578295-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRWteFkm020DS5IbXoSgj%2Fuploads%2FapjLscmF2N9A0dfM29pQ%2F13-tipo-orcamentos-acoes.png?alt=media&amp;token=f24d99fb-86c6-45f3-a034-c48ab201e6bc" alt=""><figcaption><p>Imagem 13 - Configuração do módulo com o Tipo de registro "Orçamentos" selecionado, mostrando apenas as ações de busca.</p></figcaption></figure>

***

#### 🗃️ 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.

<figure><img src="https://3829578295-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRWteFkm020DS5IbXoSgj%2Fuploads%2F7TJMVyJTNjjLId7mpRha%2F14-tipo-tickets.png?alt=media&amp;token=7eb0a0f2-a020-4697-8744-635327798cd7" alt=""><figcaption><p>Imagem 14 - Configuração do módulo com um destes tipos de registro selecionado (por exemplo, Tickets).</p></figcaption></figure>

***

#### 🔀 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).

<figure><img src="https://3829578295-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRWteFkm020DS5IbXoSgj%2Fuploads%2F19vY3zM3YlnHNouwKTCU%2F15-saidas-sucesso-erro.png?alt=media&amp;token=f4edc9ae-cca4-4006-8314-0c7aec8c1e71" alt=""><figcaption><p>Imagem 15 - Módulo na área de trabalho do fluxo mostrando as saídas Sucesso e Erro.</p></figcaption></figure>

***

### 💡 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.

***

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