As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# HubSpot integração
Acesse seus dados de HubSpot CRM diretamente do Amazon Quick usando linguagem natural. Com o conector de HubSpot ação, você pode recuperar e listar contatos, empresas, ofertas e ingressos sem sair do Amazon Quick.
HubSpot está disponível como um conector embutido no Amazon Quick. Para configurar essa integração, conclua as duas etapas a seguir. Primeiro, prepare sua HubSpot conta com o acesso necessário. Em seguida, crie o conector no Amazon Quick e autentique-o com suas HubSpot credenciais.
Esse conector é compatível com a autenticação personalizada do aplicativo OAuth. Para obter informações sobre os métodos de autenticação compatíveis com o Amazon Quick, consulte[Métodos de autenticação](quick-action-auth.md).
## Pré-requisitos
Antes de configurar a integração, verifique se você tem os seguintes recursos e acesso.
+ Uma HubSpot conta ativa com uma função de administrador.
+ Permissões para acessar dados do CRM, incluindo contatos, empresas, negócios e tickets em sua HubSpot conta.
+ Uma assinatura que atenda aos requisitos descritos em[Configurar integrações no console](integration-console-setup-process.md).
## Verificando sua conta HubSpot
Antes de configurar o Amazon Quick, verifique se sua HubSpot conta atende aos seguintes requisitos.
+ Sua HubSpot conta está ativa e você pode entrar na [página HubSpot de login no HubSpot site](https://app.hubspot.com/login).
+ Os dados do CRM que você deseja acessar, incluindo contatos, empresas, negócios e tickets, podem ser acessados em sua conta.
## Configurando sua conta HubSpot
O método de autenticação do aplicativo OAuth personalizado no Amazon Quick exige um aplicativo MCP Auth configurado nas configurações do desenvolvedor. HubSpot
### Para configurar um aplicativo MCP Auth
1. Faça login na sua HubSpot conta.
1. Navegue até **Desenvolvimento** e, em seguida, **MCP Auth Apps.**
1. Escolha **Criar aplicativo de autenticação MCP**.
1. Na janela **Create MCP Auth App**, preencha os seguintes campos:
+ **Nome** — Insira um nome para seu aplicativo.
+ **Descrição** — Insira uma breve descrição.
+ **URL de redirecionamento** — Digite`https://{{region}}.quicksight.aws.amazon.com/sn/oauthcallback`. {{region}}Substitua por sua AWS região, por exemplo,`us-east-1`.
1. Escolha **Criar**. HubSpot cria o aplicativo e gera um ID do cliente e um segredo do cliente.
**Importante**
Registre o segredo do cliente e o ID do cliente.
O ID do cliente e o segredo do cliente servem como ID do cliente e segredo do cliente quando você configura o conector de ação no Amazon Quick com o método de autenticação do aplicativo OAuth personalizado.
Para obter mais informações, consulte [Servidor HubSpot MCP](https://developers.hubspot.com/docs/apps/developer-platform/build-apps/integrate-with-the-remote-hubspot-mcp-server) no HubSpot site.
## Configurando a integração no Amazon Quick
Depois de verificar o acesso à sua HubSpot conta, crie o conector no Amazon Quick.
1. No console do Amazon Quick, escolha **Conectores**.
1. Escolha a guia **Criar para sua equipe**.
1. **HubSpot**Escolha entre as opções disponíveis.
1. Na **HubSpot**caixa de diálogo, insira os seguintes campos:
+ **Nome** — Um nome descritivo para seu HubSpot conector.
+ **Descrição (Opcional)** — Escolha **\+ Adicionar descrição** para adicionar notas sobre como esse conector será usado.
+ **Tipo de conexão** — Escolha **Rede pública**.
1. Para o método de autenticação do **aplicativo OAuth personalizado**, insira os seguintes campos:
+ **URL base** — Esse campo é preenchido automaticamente como. `https://mcp.hubspot.com`
+ **ID do cliente** — insira o ID do cliente do seu HubSpot aplicativo MCP Auth.
+ **Segredo do cliente** — Insira o segredo do cliente do seu HubSpot aplicativo MCP Auth.
+ **URL do token** — Esse campo é preenchido automaticamente como. `https://api.hubapi.com/oauth/v1/token`
+ **URL de autorização** — Esse campo é preenchido automaticamente como. `https://app.hubspot.com/oauth/authorize`
+ **URL de redirecionamento** — Esse campo é preenchido automaticamente como. `https://us-east-1.quicksight.aws.amazon.com/sn/oauthcallback`
1. Escolha **Avançar**, revise as HubSpot ações e escolha **Avançar** novamente.
1. Especifique quem pode acessar o conector:
+ Para compartilhar com uma equipe, insira o nome da equipe ou o e-mail do grupo.
+ Para mantê-lo privado, deixe o campo em branco.
+ Para compartilhar com todos os usuários, ative **Todos na sua organização**.
1. Selecione **Publish**.
O conector aparece no painel **Disponível** com o status **Conectado**.
## Usando as ações disponíveis
Depois de configurar o conector, você pode usar as seguintes ações somente para leitura para acessar seus dados do HubSpot CRM.
**HubSpot ações disponíveis**
| Ação | Description |
| --- | --- |
| Obtenha objetos de CRM | Busca vários objetos do CRM do mesmo tipo de objeto em uma única solicitação. |
| Obtenha propriedades | Busca propriedades para os objetos do CRM. |
| Obter detalhes do usuário | Busca detalhes do usuário. |
| Pesquisar objetos do CRM | Pesquisas em objetos do CRM. |
| Pesquisar proprietários | Pesquisas entre proprietários. |
| Pesquisar propriedades | Pesquisas em propriedades. |
**nota**
Esse conector oferece suporte a ações somente para leitura. As ações que você pode usar dependem dos escopos configurados no seu HubSpot aplicativo.
## Solução de problemas
Para editar, compartilhar ou excluir seu conector, consulte[Gerenciando integrações existentes](integration-workflows.md#managing-existing-integrations).
### Resolvendo problemas de autenticação
+ **Sign-in falha** — Verifique se sua HubSpot conta está ativa e se você pode entrar na [página de HubSpot login no HubSpot site](https://app.hubspot.com/login). Se sua organização usa login único (SSO), confirme se seu provedor de identidade está configurado corretamente.
+ **Acesso negado** — confirme se seu HubSpot usuário tem uma função de administrador com permissões para acessar dados do CRM. Verifique se o ID do cliente e o segredo do cliente do seu aplicativo estão corretos e se os escopos de leitura necessários estão configurados.