> ## Documentation Index > Fetch the complete documentation index at: https://docs.chatnorris.ai/llms.txt > Use this file to discover all available pages before exploring further. # HubSpot > Cómo conectar HubSpot a un agente de ChatNorris con una clave de servicio y qué sincroniza el agente en tu CRM: contactos, empresas y objetos Lead. # HubSpot Con la integración de HubSpot, los leads que confirma tu agente de ChatNorris llegan solos a tu CRM, sin salir del chat ni exportar nada a mano. Cuando el agente tiene confirmado el email de un visitante, según lo que actives: * crea o actualiza el visitante como Contact en HubSpot; * busca o crea su empresa y la asocia al contacto; * crea un registro Lead asociado al contacto. ChatNorris nunca lee ni modifica ningún otro dato de tu cuenta de HubSpot. ## Requisitos * Una cuenta de ChatNorris con plan **Standard** o **Premium**. Puedes ver los planes en [chatnorris.ai/pricing](https://chatnorris.ai/pricing). * Al menos un agente creado en ChatNorris. Si todavía no tienes uno, sigue [Crear un agente](https://docs.chatnorris.ai/guias/crear-agente-wizard.md). * Una cuenta de HubSpot donde puedas crear una clave de servicio (o un token de Private App que ya tengas). * Para la capacidad **Crear objeto Lead**, que tu cuenta de HubSpot tenga disponible la herramienta Leads. * Rol **Owner** o **Admin** en tu organización de ChatNorris. ## Conectar HubSpot Cada agente se conecta a una cuenta de HubSpot. **1. Crea la clave de servicio en HubSpot** En HubSpot, ve a **Desarrollo → Claves → Claves de servicio** y crea una clave nueva. Un token de Private App existente también funciona. **2. Otorga los scopes** Los scopes de contactos son obligatorios. Los de empresas y leads solo hacen falta si vas a activar esas capacidades en la Acción: | Scopes | Para qué | | - | - | | `crm.objects.contacts.read` y `crm.objects.contacts.write` | Obligatorios: **Sincronizar contacto**. | | `crm.objects.companies.read` y `crm.objects.companies.write` | **Sincronizar empresa**. | | `crm.objects.leads.read` y `crm.objects.leads.write` | **Crear objeto Lead**. | Crea la clave y cópiala. **3. Abre el hub de Integraciones del agente** En ChatNorris, entra a `Agentes → [tu agente] → Integraciones` y elige **HubSpot**. **4. Pega la clave y conecta** Pega la clave en **Clave de servicio** y haz clic en **Conectar**. Con **Probar conexión** confirmas que la clave funciona antes de usarla en la Acción. La clave se guarda en ChatNorris y el hub solo muestra sus últimos 4 caracteres. Si la rotas en HubSpot, usa **Reemplazar clave** en el menú **···** de la fila: la conexión sigue siendo la misma y la Acción no se toca. ## Configurar la Acción Conectar HubSpot no sincroniza nada todavía. Para elegir qué hace el agente en tu CRM: **1. Crea la Acción HubSpot** Entra a `Agentes → [tu agente] → Acciones`, haz clic en **Nueva acción** y elige **HubSpot**. **2. Elige las capacidades** Activa las que quieras (ver la tabla de abajo). Las tres son independientes, pero jerárquicas: **Sincronizar empresa** y **Crear objeto Lead** requieren tener activo **Sincronizar contacto**. **3. Activa la Acción y guarda** Con **Acción habilitada** activa, haz clic en **Guardar**. Desde ese momento, los leads confirmados de este agente llegan a HubSpot. | Capacidad | Qué hace en HubSpot | Scopes de HubSpot | | - | - | - | | **Sincronizar contacto** | Crea o actualiza un Contact cada vez que se confirma el email de un visitante. Los contactos nuevos entran como Lead con estado **Nuevo**; los existentes nunca se pisan. | `crm.objects.contacts.read` y `.write` | | **Sincronizar empresa** | Busca la empresa del visitante por su nombre exacto, la crea si no existe y la asocia al contacto. Usa la propiedad Empresa del lead o, si no está, su campo personalizado "Empresa"/"Company". | `crm.objects.companies.read` y `.write` | | **Crear objeto Lead** | Crea un registro Lead asociado al contacto, una sola vez por lead. Requiere que tu cuenta de HubSpot tenga disponible la herramienta Leads. | `crm.objects.leads.read` y `.write` | > [!NOTE] > > La sincronización se repite cada vez que el agente tiene confirmado el email del visitante: HubSpot crea el contacto o actualiza el existente (lo busca por email), así que un teléfono o un nombre que el visitante completa más tarde también llega a HubSpot, siempre que ese dato esté vacío en el contacto. Solo el objeto Lead se crea una única vez por lead. ## Desconectar En `Agentes → [tu agente] → Integraciones → HubSpot`, haz clic en **Desconectar** (también está en el menú **···** de la fila). La sincronización de leads se deshabilita: la Acción HubSpot se apaga, pero no se borra y conserva su configuración. La clave se borra de ChatNorris. Para volver a sincronizar, conecta HubSpot de nuevo y reactiva la Acción. Si solo quieres detenerla por un tiempo, apaga el interruptor **Activa** de la integración: la clave se conserva y la Acción no llama a HubSpot hasta que la reactives. ## Preguntas frecuentes > [accordion] ¿Puedo usar un token de Private App en vez de una clave de servicio? > > Sí. Un token de Private App existente sigue funcionando: pégalo en el mismo campo **Clave de servicio**. Revisa que tenga los scopes de las capacidades que vas a activar. > [accordion] ¿La sincronización pisa los datos que ya tengo en HubSpot? > > No. Si el contacto ya existe (ChatNorris lo busca por email), solo se completan el nombre, el apellido y el teléfono que estén vacíos en HubSpot; si no falta nada, el contacto no se toca. Su etapa y su estado de lead tampoco cambian, porque podría estar más avanzado en tu embudo. Los contactos nuevos entran como Lead con estado **Nuevo**. > [accordion] No se crea el objeto Lead > > Revisa que **Crear objeto Lead** esté activa, que la clave tenga los scopes `crm.objects.leads.read` y `crm.objects.leads.write`, y que tu cuenta de HubSpot tenga disponible la herramienta Leads. El objeto Lead se crea una sola vez por lead. > [accordion] ¿Conectar HubSpot consume créditos? > > No. Conectar y probar la integración no tiene costo en créditos. Ver [Modelos de IA y créditos](https://docs.chatnorris.ai/guias/modelos-ia-creditos.md). > [accordion] ¿Puedo conectar dos cuentas de HubSpot en el mismo agente? > > No. Cada proveedor admite una sola conexión por agente. Si necesitas cuentas distintas, usa agentes separados. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.