> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getnexor.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# Conectar HubSpot
> Importa contactos de HubSpot, deja que un agente de IA los trabaje y sincroniza cada resultado de vuelta a HubSpot.
Conecta tu cuenta de HubSpot para que los agentes de IA de Nexor trabajen tus contactos de punta a punta: importa los contactos o listas que elijas, deja que un agente contacte y califique a cada uno por WhatsApp, llamadas, email o SMS, y recibe cada resultado escrito de vuelta en HubSpot automáticamente.
## Qué se sincroniza
| Datos | Dirección | Cómo |
| ------------------------ | --------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Contactos | HubSpot → Nexor | Importa las listas o contactos que elijas; cada uno se convierte en un lead asignado al agente que definas. Opcionalmente, los contactos nuevos de HubSpot entran automáticamente casi en tiempo real. |
| Propiedades del contacto | Nexor → HubSpot | Las variables que captura tu agente — más el estado de calificación, un resumen de la conversación y la fecha del último contacto — se escriben en las propiedades del contacto que mapees. |
| Negocios | HubSpot ↔ Nexor | Nexor lee los negocios para dar contexto a la conversación, y tu agente puede crear o actualizar un negocio cuando un lead califica (si habilitas las herramientas de negocios). |
| Propietarios | HubSpot → Nexor | Los propietarios de HubSpot se emparejan con tu equipo de ventas en Nexor para que los leads calificados lleguen al vendedor correcto. |
## Requisitos
* Una cuenta de HubSpot donde puedas instalar aplicaciones (Superadministrador, o un usuario con permiso de **acceso al Marketplace de aplicaciones**).
* Acceso de administrador a tu organización de Nexor.
* Toda propiedad del contacto que quieras que Nexor actualice debe existir previamente en HubSpot. Nexor actualiza valores de propiedades — nunca crea, renombra ni elimina propiedades.
## Conectar
Inicia sesión en Nexor y ve a **Integraciones → HubSpot**. La conexión queda ligada a tu organización de Nexor, así que parte desde Nexor — no desde HubSpot.
Haz clic en **Conectar**, elige tu cuenta de HubSpot, revisa los permisos solicitados y haz clic en **Conectar aplicación**. Volverás a Nexor con la conexión activa.
Selecciona las listas o contactos a importar y el agente que los trabajará. Define un **agente predeterminado** para que todo contacto importado quede ruteado y sea contactado — los contactos sin agente se guardan pero nunca se trabajan.
Mapea propiedades de HubSpot a campos de Nexor — por ejemplo **Teléfono** → teléfono, **Email** → email, **Nombre** → nombre. Un lead necesita al menos un teléfono o un email.
Nexor se conecta únicamente por OAuth. Autorizas la app desde la pantalla de HubSpot — no hay claves que crear ni pegar, y puedes revisar los permisos exactos antes de concederlos.
## Permisos que solicita Nexor
Nexor pide solo los permisos que sus funciones usan:
| Permiso | Para qué lo necesita Nexor |
| --------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Leer contactos | Importar los contactos y listas que elijas. |
| Escribir contactos | Actualizar las propiedades del contacto que mapees con datos capturados, estado de calificación, resúmenes y fecha del último contacto. |
| Leer listas | Mostrar tus listas para que elijas cuáles importar. |
| Leer propietarios | Emparejar los propietarios de HubSpot con tu equipo de ventas en Nexor. |
| Leer negocios | Dar contexto de conversación al agente y cruzar conversiones. |
| Escribir negocios | Crear o actualizar un negocio cuando el agente califica un lead (solo se usa si habilitas las herramientas de negocios). |
| Leer empresas | Mostrar la empresa asociada a un contacto. |
| Leer y escribir leads | Encontrar el registro Lead asociado a un contacto y mantener su etapa y propietario sincronizados (solo se usa si trabajas con el objeto Leads de HubSpot). |
## Escribir resultados de vuelta en HubSpot
Con un agente trabajando leads de HubSpot, tú eliges exactamente qué propiedades del contacto mantiene actualizadas Nexor. En la configuración del agente, junto a **Variables**, abre el panel de mapeo y empareja cada variable de Nexor con una propiedad existente del contacto en HubSpot. Además de las variables capturadas, puedes mapear:
* **Estado de calificación** — el estado del lead en el funnel, traducido a los valores de la propiedad de lista desplegable que elijas.
* **Resumen de la conversación** — un recuento de las conversaciones del agente, escrito en una propiedad de texto.
* **Fecha del último contacto** — cuándo fue la última interacción del agente con el lead.
Las actualizaciones son casi en tiempo real: las propiedades se refrescan a medida que el agente captura datos y cada vez que cambia el estado del lead. El emparejamiento usa el ID del contacto de HubSpot, así que no se generan contactos duplicados.
## Desconectar
* **Desde Nexor**: ve a **Integraciones → HubSpot** y haz clic en **Desconectar**. La sincronización se detiene de inmediato en ambas direcciones.
* **Desde HubSpot**: ve a **Configuración → Integraciones → Aplicaciones conectadas**, busca **Nexor** y haz clic en **Desinstalar**.
Desconectar elimina la configuración de la integración en Nexor, incluidos el ruteo de listas y los mapeos de propiedades. Tus datos de HubSpot nunca se modifican ni se eliminan — los leads que ya están en Nexor permanecen en Nexor.
## Solución de problemas
Las cuentas de desarrollador de HubSpot y algunas cuentas de prueba no pueden instalar aplicaciones. Conecta desde tu cuenta de HubSpot de producción con un usuario que tenga permisos para instalar aplicaciones.
Los contactos no tienen agente asignado. Define un **agente predeterminado** en la configuración de la integración (o rutea cada lista a un agente) y luego re-importa o asigna los leads a un agente.
La propiedad debe existir previamente en HubSpot con el nombre interno exacto que mapeaste. En propiedades de lista desplegable, cada valor de Nexor debe estar mapeado a una de las opciones de la propiedad — los valores sin mapear se omiten para proteger el resto de la actualización.
Un lead necesita al menos un número de teléfono o un email. Los contactos sin ninguno de los dos se omiten durante la importación.
## Datos y privacidad
Nexor almacena el ID del contacto de HubSpot y los campos que mapees (típicamente nombre, teléfono y email) de los contactos que importas. No se lee nada más de tu cuenta, y Nexor nunca elimina datos de HubSpot. Para solicitar la eliminación de datos sincronizados, escribe a [hola@getnexor.ai](mailto:hola@getnexor.ai).