HubSpot CRM
Saiba mais sobre o conector HubSpot e como usá-lo na Digibee Integration Platform.
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.
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. Para recursos de gerenciamento de conteúdo, como páginas e blogs, use o conector HubSpot CMS.
Parâmetros
As tabelas abaixo descrevem todos os parâmetros de configuração. Os campos que suportam expressões Double Braces são marcados na coluna Suporta DB.
Account
A conta 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
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 para detalhes sobre cada endpoint.
String
❌
N/A
Method
O método HTTP utilizado na requisição.
String
❌
N/A
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
Documentation
Seção para documentar informações relevantes sobre a configuração do conector e as regras de negócio.
String
❌
N/A
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.
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.
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.
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.
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.
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.
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 para a lista completa de IDs de objetos padrão.
Atualizado
Isto foi útil?