

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# HubSpot integración
<a name="hubspot-integration"></a>

Acceda a sus datos de HubSpot CRM directamente desde Amazon Quick utilizando un lenguaje natural. Con el conector de HubSpot acción, puedes recuperar y enumerar contactos, empresas, ofertas y entradas sin salir de Amazon Quick.

HubSpot está disponible como conector integrado en Amazon Quick. Para configurar esta integración, complete los dos pasos siguientes. En primer lugar, prepare su HubSpot cuenta con el acceso necesario. A continuación, crea el conector en Amazon Quick y autentícate con tus HubSpot credenciales.

Este conector admite la autenticación personalizada de aplicaciones OAuth. Para obtener información sobre los métodos de autenticación que admite Amazon Quick, consulte[Métodos de autenticación](quick-action-auth.md).

## Requisitos previos
<a name="hubspot-integration-prerequisites"></a>

Antes de configurar la integración, compruebe que dispone de los siguientes recursos y accesos.
+ Una HubSpot cuenta activa con un rol de administrador.
+ Permisos para acceder a los datos del CRM, incluidos los contactos, las empresas, las ofertas y las entradas de tu HubSpot cuenta.
+ Una suscripción que cumpla los requisitos descritos en[Configurar integraciones en la consola](integration-console-setup-process.md).

## Verificación de tu cuenta HubSpot
<a name="hubspot-account-setup"></a>

Antes de configurar Amazon Quick, comprueba que tu HubSpot cuenta cumple los siguientes requisitos.
+ Tu HubSpot cuenta está activa y puedes iniciar sesión en la [página de HubSpot inicio de sesión](https://app.hubspot.com/login) del sitio HubSpot web.
+ Puedes acceder a los datos de CRM a los que deseas acceder, incluidos los contactos, las empresas, las ofertas y las entradas, desde tu cuenta.

## Configurar tu HubSpot cuenta
<a name="hubspot-configure-account"></a>

El método de autenticación de la aplicación OAuth personalizada de Amazon Quick requiere una aplicación de autenticación MCP configurada en la configuración de desarrollador. HubSpot 

### Para configurar una aplicación de autenticación MCP
<a name="hubspot-configure-oauth"></a>

1. Inicie sesión en su cuenta. HubSpot 

1. Vaya a **Desarrollo** y, a continuación, a **MCP Auth Apps.**

1. Elija **Crear aplicación de autenticación MCP.**

1. En la ventana **Crear una aplicación de autenticación MCP**, complete los siguientes campos:
   + **Nombre**: introduzca un nombre para su aplicación.
   + **Descripción**: introduce una descripción breve.
   + **URL de redireccionamiento**: introduzca`https://{{region}}.quicksight.aws.amazon.com/sn/oauthcallback`. Reemplace {{region}} con su AWS región, por ejemplo,`us-east-1`.

1. Elige **Crear**. HubSpot crea la aplicación y genera un ID de cliente y un secreto de cliente.
**importante**  
Registra el secreto y el ID del cliente.

El ID de cliente y el secreto del cliente sirven como ID de cliente y secreto de cliente al configurar el conector de acciones en Amazon Quick con el método de autenticación de la aplicación OAuth personalizada.

Para obtener más información, consulte el [servidor HubSpot MCP](https://developers.hubspot.com/docs/apps/developer-platform/build-apps/integrate-with-the-remote-hubspot-mcp-server) en el sitio web. HubSpot 

## Configuración de la integración en Amazon Quick
<a name="hubspot-integration-setup"></a>

Tras verificar el acceso a tu HubSpot cuenta, crea el conector en Amazon Quick.

1. En la consola Amazon Quick, selecciona **Connectors**.

1. Selecciona la pestaña **Crear para tu equipo**.

1. Elige **HubSpot**entre las opciones disponibles. 

1. En el **HubSpot**cuadro de diálogo, introduzca los siguientes campos:
   + **Nombre**: un nombre descriptivo para el HubSpot conector.
   + **Descripción (opcional)**: seleccione **\+ Añadir descripción** para añadir notas sobre cómo se utilizará este conector.
   + **Tipo de conexión**: elija **Red pública**.

1. Para el método de autenticación de **la aplicación OAuth personalizada**, introduce los siguientes campos:
   + **URL base**: este campo se rellena automáticamente como`https://mcp.hubspot.com`.
   + **ID de cliente**: introduzca el ID de cliente de su aplicación HubSpot MCP Auth.
   + **Secreto de cliente**: introduzca el secreto de cliente de su aplicación de autenticación HubSpot MCP.
   + **URL del token**: este campo se rellena automáticamente como`https://api.hubapi.com/oauth/v1/token`.
   + **URL de autorización**: este campo se rellena automáticamente como`https://app.hubspot.com/oauth/authorize`.
   + **URL de redireccionamiento**: este campo se rellena automáticamente como`https://us-east-1.quicksight.aws.amazon.com/sn/oauthcallback`.

1. Seleccione **Siguiente**, revise las acciones y HubSpot, a continuación, vuelva a seleccionar **Siguiente**.

1. Especifique quién puede acceder al conector:
   + Para compartir con un equipo, introduce el nombre del equipo o el correo electrónico del grupo.
   + Para mantenerlo privado, deja el campo en blanco.
   + Para compartir con todos los usuarios, activa la opción **Todos los miembros de tu organización**.

1. Elija **Publicar**.

El conector aparece en el panel **Disponible** con el estado **Conectado**.

## Uso de las acciones disponibles
<a name="hubspot-integration-actions"></a>

Tras configurar el conector, puede utilizar las siguientes acciones de solo lectura para acceder a sus datos de HubSpot CRM.


**HubSpot acciones disponibles**  

| Action | Description (Descripción) | 
| --- | --- | 
| Obtenga objetos de CRM | Obtiene varios objetos de CRM del mismo tipo de objeto en una sola solicitud. | 
| Obtiene propiedades | Obtiene las propiedades de los objetos de CRM. | 
| Obtenga los detalles del usuario | Obtiene los detalles del usuario. | 
| Busca objetos de CRM | Busca en todos los objetos de CRM. | 
| Busca propietarios | Busca entre propietarios. | 
| Busca propiedades | Busca en todas las propiedades. | 

**nota**  
Este conector admite acciones de solo lectura. Las acciones que puedes usar dependen de los ámbitos configurados en tu aplicación. HubSpot 

## Resolución de problemas
<a name="hubspot-integration-troubleshooting"></a>

Para editar, compartir o eliminar el conector, consulte[Administrar las integraciones existentes](integration-workflows.md#managing-existing-integrations).

### Resolver problemas de autenticación
<a name="hubspot-troubleshooting-auth"></a>
+ **Sign-in falla**: comprueba que tu HubSpot cuenta esté activa y que puedes iniciar sesión en la [página de HubSpot inicio de sesión](https://app.hubspot.com/login) del sitio HubSpot web. Si tu organización usa el inicio de sesión único (SSO), confirma que tu proveedor de identidad esté configurado correctamente.
+ **Acceso denegado**: confirme que su HubSpot usuario tiene un rol de administrador con permisos para acceder a los datos de CRM. Comprueba que el ID de cliente y el secreto de cliente de tu aplicación sean correctos y que los ámbitos de lectura necesarios estén configurados.