> For the complete documentation index, see [llms.txt](https://aizy.gitbook.io/aizy-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://aizy.gitbook.io/aizy-docs/aizy-docs-es/crm-integrations/hubspot.md).

# HubSpot

### 1. Antes de empezar

Crea una **Private App** en HubSpot y obtén su token de acceso. Concede únicamente los scopes necesarios para las acciones que usarás.

Referencias oficiales:

* <https://developers.hubspot.com/docs/api/private-apps>
* <https://knowledge.hubspot.com/integrations/create-and-manage-private-apps>

### 2. Conectar HubSpot

1. En **Integraciones CRM**, selecciona **HubSpot**.
2. Activa la integración.
3. Pega el token de la Private App.
4. Guarda y pulsa **Actualizar permisos**.
5. Revisa los scopes detectados y habilita las acciones necesarias.

### 3. Acciones disponibles

Según los permisos de la Private App, Aizy puede ofrecer:

* Buscar contacto por email.
* Buscar contacto por teléfono.
* Crear o actualizar contacto.
* Crear deal.
* Crear ticket.

Como referencia, contactos requieren permisos de lectura y, para alta/actualización, escritura. Deals también requieren permisos sobre empresas y deals. Tickets necesitan el scope de tickets compatible de HubSpot.

### 4. Configurar una Task

Añade una acción CRM con proveedor HubSpot. Para asociar un contacto a un deal o ticket, coloca primero una búsqueda o alta/actualización de contacto. Completa asunto, contenido o plantillas con las variables disponibles.

Los tickets creados se registran como nota interna de Inbox con ID y enlace validado cuando HubSpot devuelve una URL utilizable.

### 5. Seguridad

El token concede acceso a tu CRM. No lo compartas ni lo incluyas en prompts, documentos o webhooks. Revócalo desde HubSpot si deja de utilizarse.