Configure o OAuth para ingestão no HubSpot.

O conector gerenciado do HubSpot no Lakeflow Connect usa autenticação OAuth 2.0 user-to-machine (U2M). Use os detalhes de autenticação que você recuperou dos passos nesta página para criar uma conexão do Unity Catalog no Databricks.

nota

O HubSpot descontinuou a UI de criação de aplicativo público legado. Crie seu aplicativo usando a plataforma baseada em projeto da HubSpot e a CLI da HubSpot, conforme descrito nesta página. Consulte o registro de alterações do HubSpot para obter detalhes.

Instalar e autenticar a CLI do HubSpot

1. Instale o Node.js versão 20 ou acima.

2. Instale a CLI do HubSpot:

   Bash

   npm install -g @hubspot/cli

3. Autentique a CLI com sua account HubSpot:

   Bash

   hs account auth

   Siga os prompts para gerar uma key de acesso pessoal e salve-a na sua configuração local da CLI.

Criar um aplicativo e recuperar detalhes de autenticação

1. Crie um aplicativo na plataforma baseada em projeto da HubSpot:

   Bash

   hs project create --project-base app --auth oauth --distribution private

2. No arquivo app-hsmeta.json gerado, defina auth.redirectUrls como a URL de redirecionamento do seu workspace (formato: https://<your_workspace_domain>/login/oauth/lakehousefederation.html). Por exemplo: https://my-workspace.cloud.databricks.com/login/oauth/lakehousefederation.html

3. No mesmo arquivo, defina auth.requiredScopes apenas para os seguintes escopos. A omissão de qualquer um deles, ou a adição de escopos não listados nesta página, causa falhas posteriormente no processo de configuração.

   • oauth
   • communication_preferences.read
   • content
   • crm.objects.marketing_events.read
   • crm.objects.marketing_events.write
   • forms
   • forms-uploaded-files
   • marketing.campaigns.read

info

Beta

A ingestão de objetos do HubSpot CRM Hub está em Beta. Os administradores do workspace podem controlar o acesso a esse recurso na página Pré-visualizações ao optar pela prévia hubspot_connector_crm_objects. Consulte Gerenciar prévias do Databricks.

Se você habilitou esta visualização, adicione também os seguintes escopos a auth.requiredScopes para ingerir objetos do HubSpot CRM Hub:

• crm.objects.companies.read
• crm.objects.contacts.read
• crm.objects.deals.read
• crm.objects.leads.read
• crm.objects.line_items.read
• crm.objects.orders.read
• crm.objects.owners.read
• crm.objects.products.read
• crm.schemas.companies.read
• crm.schemas.contacts.read
• crm.schemas.deals.read
• crm.schemas.line_items.read
• crm.schemas.orders.read
• sales-email-read
• tickets

4. Implantar o aplicativo na sua conta HubSpot:

   Bash

   hs project upload

5. Recupere os detalhes de autenticação do aplicativo:

   Bash

   hs project open

   Em Componentes do Projeto , selecione seu aplicativo e clique na tab . Observe a ID do Cliente e o Segredo do Cliente . Use-os para criar uma conexão do Unity Catalog no Databricks.

6. Instale o aplicativo na sua account HubSpot:

   1. Acesse **Desenvolvimento > Projetos**.
   2. Selecione seu projeto e, em seguida, seu aplicativo.
   3. Na tab Distribuição , clique em Instalar agora e autorize o aplicativo.

Migrar um aplicativo legado

Se já houver um aplicativo público legado configurado para ingestão do HubSpot, migre-o para a plataforma baseada em projetos em vez de criar um novo aplicativo. A migração preserva o ID de Cliente, o segredo do Cliente e as instalações existentes do aplicativo, portanto, não é necessário atualizar a conexão do Unity Catalog.

1. Atualize a CLI do HubSpot para a versão 7.6.0 ou posterior:

   Bash

   npm install -g @hubspot/cli@latest

2. Execute o comando de migração e siga as instruções para selecionar seu aplicativo e confirmar os componentes a serem migrados:

   Bash

   hs app migrate

Para obter detalhes, consulte o guia de migração da HubSpot.

Próximos passos

Use o Explorador de Catálogos para criar uma conexão. Qualquer usuário com USE CONNECTION ou ALL PRIVILEGES pode, então, criar pipelines a partir dela. Consulte Criar uma conexão HubSpot.