Conexão HubSpot
Introdução
Uma conexão HubSpot, criada usando o conector HubSpot, estabelece acesso ao HubSpot. Depois que uma conexão é configurada, você pode criar instâncias de atividades do HubSpot associadas a essa conexão para serem usadas como origens (para fornecer dados em uma operação) ou como destinos (para consumir dados em uma operação).
Importante
Para usar o conector HubSpot, você deve ter um aplicativo privado HubSpot, o conjunto de permissões de escopo apropriado e um token de acesso conforme descrito em Pré-requisitos do HubSpot.
Criar ou editar uma conexão HubSpot
Uma nova conexão HubSpot é criada usando o conector HubSpot de um destes locais:
- A aba endpoints e conectores do projeto da paleta de componentes de design (consulte paleta de componentes de design).
- A página Conexões globais (consulte Criar um endpoint global em Conexões Globais).
Uma conexão HubSpot existente pode ser editada nestes locais:
- A aba endpoints e conectores do projeto da paleta de componentes de design (consulte paleta de componentes de design).
- A aba Componentes do painel do projeto (consulte menu de ações do componente na aba Componentes do painel Projeto).
- A página Conexões globais (consulte Editar um endpoint global em Conexões Globais).
Configurar uma conexão HubSpot
Cada elemento da interface do usuário da tela de configuração de conexão do HubSpot é descrito abaixo.
Dica
Campos com um ícone variável suporte usando variáveis globais, variáveis do projeto e variáveis Jitterbit. Comece digitando um colchete aberto [
no campo ou clicando no ícone de variável para exibir uma lista das variáveis existentes para escolher.
-
Nome da conexão: Insira um nome para usar para identificar a conexão. O nome deve ser exclusivo para cada conexão HubSpot e não deve conter barras
/
ou dois pontos:
. Este nome também é usado para identificar o endpoint do HubSpot, que se refere tanto a uma conexão específica quanto às suas atividades. -
Tipo de autenticação: Selecione o tipo de autenticação, Chave de API ou OAuth 2.0.
Nota
As chaves da API do HubSpot estão obsoletas, o que significa que a autenticação com um aplicativo privado e OAuth 2.0 é necessária. Para obter mais informações, consulte Pré-requisitos do HubSpot.
-
Chave de API: Se Chave de API for selecionado como o tipo de autenticação, insira a chave de API para seu aplicativo público. (Obsoleto.)
-
OAuth 2.0: Se OAuth 2.0 for selecionado como o tipo de autenticação, o campo Access Token se tornará visível. Insira o token de acesso para seu aplicativo privado. Para obter mais informações, consulte Pré-requisitos do HubSpot.
-
-
Configurações opcionais: Clique para expandir configurações opcionais adicionais:
-
Versão da API: Clique para selecionar HubSpot API V3 ou V4.
-
Usar configurações de proxy (somente Agente privado): Ao usar um agente privado, esta configuração pode ser selecionada para usar configurações de proxy do agente privado.
-
-
Teste: Clique para verificar a conexão usando a configuração fornecida. Quando a conexão é testada, a versão mais recente do conector é baixada pelo(s) agente(s) no grupo de agentes associado ao ambiente atual. Este conector suporta a suspensão do download da versão mais recente do conector usando a Desabilitar atualização automática do conector política da organização.
Nota
Você deve ter o
read
permissão habilitada para ocrm.objects.owners
escopo em seu aplicativo privado. Caso contrário, a conexão HubSpot não será bem-sucedido. -
Salvar alterações: Clique para salvar e fechar a configuração de conexão.
-
Descartar alterações: Após fazer alterações em uma configuração nova ou existente, clique para fechar a configuração sem salvar. Uma mensagem pede para você confirmar que deseja descartar as alterações.
-
Excluir: Após abrir uma configuração de conexão existente, clique para excluir permanentemente a conexão do projeto e fechar a configuração (consulte Dependências, exclusão e remoção de componentes). Uma mensagem pede para você confirmar que deseja excluir a conexão.
Próximos passos
Após a criação de uma conexão com o HubSpot, você coloca um tipo de atividade na quadro de design para criar instâncias de atividade a serem usadas como fontes (para fornecer dados em uma operação) ou como destinos (para consumir dados em uma operação).
As ações de menu para uma conexão e seus tipos de atividade são acessíveis a partir do painel do projeto e da paleta de componentes de design. Para obter detalhes, consulte Menus de ações em Noções básicas do conector.
Esses tipos de atividade estão disponíveis:
-
Pesquisar: Recupera dados de objetos do HubSpot e deve ser usado como fonte em uma operação.
-
Criar: Cria dados de objeto no HubSpot e se destina a ser usado como um alvo em uma operação.
-
Atualizar: Atualiza dados de objetos no HubSpot e deve ser usado como um alvo em uma operação.
-
Excluir: Exclui dados de objeto do HubSpot e deve ser usado como alvo em uma operação.