> For the complete documentation index, see [llms.txt](https://docs.digibee.com/documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.digibee.com/documentation/connectors-and-triggers/pt-br/connectors/industry-solutions/hubspot-crm.md). # HubSpot CRM O conector **HubSpot CRM** dá aos seus pipelines acesso direto ao CRM do HubSpot, banco de dados central que armazena seus relacionamentos e processos de negócio. Use este conector para automatizar fluxos de trabalho que envolvam: * **Contatos e empresas**: Criar, atualizar, buscar, processar em lote e mesclar registros. * **Tickets**: Gerenciar tickets de suporte e atendimento. * **Engajamentos**: Registrar e recuperar ligações, e-mails, reuniões, notas e tarefas associadas a qualquer registro. * **Associações**: Criar e gerenciar relacionamentos entre registros usando a API de Associações v3. * **Propriedades e responsáveis**: Ler e escrever propriedades padrão e customizadas; recuperar atribuições de responsáveis. * **Pipelines**: Inspecionar e gerenciar estágios de pipelines de negócios e tickets. * **Schemas e objetos customizados**: Definir e interagir com tipos de objetos customizados. * **Listas e importações**: Gerenciar listas estáticas e ativas e importar registros em massa. {% hint style="info" %} O conector HubSpot CRM cobre apenas os endpoints CRM core. Para recursos de vendas, como negócios e cotações, use o conector [**HubSpot Sales**](/documentation/connectors-and-triggers/pt-br/connectors/industry-solutions/hubspot.md). Para recursos de gerenciamento de conteúdo, como páginas e blogs, use o conector [**HubSpot CMS**](/documentation/connectors-and-triggers/pt-br/connectors/industry-solutions/hubspot.md). {% endhint %} ### Parâmetros As tabelas abaixo descrevem todos os parâmetros de configuração. Os campos que suportam [expressões Double Braces](/documentation/connectors-and-triggers/pt-br/double-braces/double-braces-functions.md) são marcados na coluna **Suporta DB**. {% tabs %} {% tab title="General" %} | Parâmetro | Descrição | Tipo | Suporta DB | Padrão | | ----------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------- | ---------- | ------ | | **Account** | A [conta](https://docs.digibee.com/documentation/developer-guide/development-cycle/build-overview/accounts) utilizada pelo conector. Tipos suportados: **OAuth Bearer**, **OAuth 2** e **Secret Key**. Consulte Tipos de conta abaixo para detalhes de configuração. | Account | ❌ | N/A | | **Fail On Error** | Quando ativado, a execução do pipeline é interrompida em caso de erro. Quando desativado, a execução continua, mas o resultado exibirá false para a propriedade "success". | Boolean | ❌ | False | | {% endtab %} | | | | | {% tab title="API" %} | Parâmetro | Descrição | Tipo | Suporta DB | Padrão | | ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------ | ---------- | ------ | | **Host** | A URL base da API do HubSpot. | String | ✅ | N/A | | **Path** | O endpoint específico do HubSpot CRM a ser acessado. O caminho selecionado determina as operações disponíveis e as configurações necessárias. Consulte a [referência da API HubSpot CRM](https://developers.hubspot.com/docs/guides/crm/understanding-the-crm) para detalhes sobre cada endpoint. | String | ❌ | N/A | | **Method** | O método HTTP utilizado na requisição. | String | ❌ | N/A | | {% endtab %} | | | | | {% tab title="Settings" %} | Parâmetro | Descrição | Tipo de dado | Suporta DB | Valor padrão | | ----------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------ | ---------- | ------------ | | **Connect Timeout (ms)** | Tempo máximo permitido para estabelecer a conexão, em milissegundos. | Integer | ❌ | 30000 | | **Read Timeout (ms)** | Tempo máximo permitido para leitura dos dados, em milissegundos. | Integer | ❌ | 30000 | | **Stop on Client Error** | Quando ativado, interrompe a execução do pipeline se um erro HTTP 4xx ocorrer. | Boolean | ❌ | False | | **Stop on Server Error** | Quando ativado, interrompe a execução do pipeline se um erro HTTP 5xx ocorrer. | Boolean | ❌ | False | | **Override Response Charset** | Quando ativado, substitui o charset retornado pelo endpoint pelo charset definido no campo **Response Charset**. Quando desativada, o charset do cabeçalho Content-Type é utilizado. | Boolean | ❌ | True | | **Response Charset** | Define o charset a ser usado quando **Override Response Charset** está ativado. | String | ❌ | UTF-8 | | {% endtab %} | | | | | {% tab title="Documentation" %} | Parâmetro | Descrição | Tipo | Suporta DB | Padrão | | ----------------- | ----------------------------------------------------------------------------------------------------- | ------ | ---------- | ------ | | **Documentation** | Seção para documentar informações relevantes sobre a configuração do conector e as regras de negócio. | String | ❌ | N/A | | {% endtab %} | | | | | | {% endtabs %} | | | | | ### Tipos de conta O conector HubSpot CRM suporta três tipos de conta. Escolha o que corresponde à forma como seu app HubSpot está configurado. Para saber mais sobre como configurar cada tipo de conta, acesse a documentação sobre [Contas](/documentation/developer-guide/pt-br/development-cycle/build-overview/accounts.md). | Tipo de conta | Quando usar | | ---------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **OAuth Bearer** | Use quando você tiver um token de acesso OAuth estático de um app privado do HubSpot. Saiba mais no [guia de apps privados do HubSpot](https://developers.hubspot.com/docs/guides/apps/private-apps/overview). | | **OAuth 2** | Use quando seu app HubSpot utiliza o fluxo padrão de código de autorização OAuth 2.0. Saiba mais no [guia de OAuth 2.0 do HubSpot](https://developers.hubspot.com/docs/guides/apps/authentication/working-with-oauth). | | **Secret Key** | Opção legada para integrações que utilizam uma chave de API de desenvolvedor do HubSpot (hapikey). Quando esse tipo é selecionado, o conector injeta automaticamente o cabeçalho developer\_hapikey em cada requisição. | {% hint style="info" %} O HubSpot descontinuou as chaves de API de desenvolvedor em favor de tokens de apps privados e OAuth. Use o tipo de conta **Secret Key** apenas para integrações legadas que não podem ser migradas. Para novas integrações, use **OAuth Bearer**. {% endhint %} ### Paths disponíveis O conector expõe 52 paths organizados por recurso do CRM. A tabela abaixo lista os grupos de recursos e as operações disponíveis para cada um. | Recurso | Operações disponíveis | | ------------------------- | --------------------------------------------------------------------------------------------------------------- | | **Contacts** | Criar, ler, atualizar, excluir, buscar, criar em lote, ler em lote, atualizar em lote, excluir em lote, mesclar | | **Companies** | Criar, ler, atualizar, excluir, buscar, criar em lote, ler em lote, atualizar em lote, excluir em lote, mesclar | | **Tickets** | Criar, ler, atualizar, excluir, buscar, criar em lote, ler em lote, atualizar em lote, excluir em lote | | **Custom objects** | Criar, ler, atualizar, excluir, buscar, criar em lote, ler em lote, atualizar em lote, excluir em lote | | **Engagements: Calls** | Criar, ler, atualizar, excluir, ler em lote, atualizar em lote | | **Engagements: Emails** | Criar, ler, atualizar, excluir, ler em lote, atualizar em lote | | **Engagements: Meetings** | Criar, ler, atualizar, excluir, ler em lote, atualizar em lote | | **Engagements: Notes** | Criar, ler, atualizar, excluir, ler em lote, atualizar em lote | | **Engagements: Tasks** | Criar, ler, atualizar, excluir, ler em lote, atualizar em lote | | **Associations v3** | Criar, ler e excluir associações entre quaisquer dois tipos de objetos | | **Properties** | Ler e escrever propriedades padrão e customizadas para qualquer objeto | | **Owners** | Listar e recuperar registros de responsáveis | | **Pipelines** | Listar e inspecionar estágios de pipelines de negócios e tickets | | **Schemas** | Listar, criar e atualizar schemas de objetos customizados | | **Lists** | Criar, ler, atualizar, excluir e gerenciar associações de membros em listas estáticas e ativas | | **Imports** | Criar e recuperar jobs de importação em massa | Para localizar o objectTypeId exigido por alguns paths (por exemplo, ao trabalhar com objetos customizados ou propriedades), faça uma requisição GET para /crm/v3/schemas. Consulte a [referência de object type IDs do HubSpot](https://developers.hubspot.com/docs/guides/crm/understanding-the-crm#object-type-ids) para a lista completa de IDs de objetos padrão. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.digibee.com/documentation/connectors-and-triggers/pt-br/connectors/industry-solutions/hubspot-crm.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.