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, consulteMétodos de autenticação.
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 emConfigurar integrações no console.
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
. -
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
-
Faça login na sua HubSpot conta.
-
Navegue até Desenvolvimento e, em seguida, MCP Auth Apps.
-
Escolha Criar aplicativo de autenticação MCP.
-
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/oauthcallbackregionSubstitua por sua AWS região, por exemplo,us-east-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
Configurando a integração no Amazon Quick
Depois de verificar o acesso à sua HubSpot conta, crie o conector no Amazon Quick.
-
No console do Amazon Quick, escolha Conectores.
-
Escolha a guia Criar para sua equipe.
-
HubSpotEscolha entre as opções disponíveis.
-
Na HubSpotcaixa 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.
-
-
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
-
-
Escolha Avançar, revise as HubSpot ações e escolha Avançar novamente.
-
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.
-
-
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.
| 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, consulteGerenciando integrações existentes.
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
. 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.
