> ## 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.
# Configurar integraciones CRM por chat
> Configura conexiones, rutas, campos e importaciones compatibles con Nexor desde NexorAI o Claude con el MCP de Nexor.
NexorAI y Claude con el MCP de Nexor pueden consultar y configurar la integración de Nexor con HubSpot, GoHighLevel, Kommo, Zoho, webhooks de entrada personalizados y Odoo. Esto cubre las configuraciones implementadas por Nexor. No incluye todas las funciones administrativas de cada CRM, como crear cualquier objeto o cambiar permisos de sus usuarios.
Estas operaciones requieren las versiones correspondientes del backend y del MCP. Ver una herramienta en el catálogo no demuestra que el backend ya esté desplegado. Las consultas requieren `workflows:read`; los cambios y las previsualizaciones que guardan una aprobación requieren `workflows:write`. NexorAI conserva los permisos del operador conectado y los bloqueos de los Agentes.
## Elige primero el alcance
En una conversación de Agente o Grupo, el asistente usa herramientas acotadas y conserva la configuración de los demás Agentes. Los valores compartidos, las importaciones de toda la conexión y las reasignaciones requieren una **conversación de cuenta en NexorAI**, sin un Agente o Grupo seleccionado. En Claude se indica `scope: "account"` explícitamente.
Pide: “Muéstrame la configuración del CRM y qué impide sincronizar”. El asistente consulta los identificadores exactos, la revisión actual y las opciones disponibles del proveedor. La evidencia de toda la conexión se identifica como tal; no demuestra que un Agente específico se haya sincronizado.
Antes de cambiar la cuenta, el asistente muestra todos los Agentes afectados, incluidos quienes heredan los valores generales. Los Agentes nuevos también pueden heredarlos. No se puede omitir un Agente bloqueado para evitar la autorización.
El cambio incluye `expected_revision`, todos los `affected_workflow_ids` revisados y `confirm: true`. Si cambió la configuración, la lista de tareas o un bloqueo, se rechaza. El asistente vuelve a consultar antes de pedir otra confirmación. Guardar correctamente no demuestra que una importación o escritura en el CRM haya terminado.
## Configuraciones disponibles
* **Variables recopiladas:** consultar o reemplazar sus vínculos con metadata y conversiones de valores mediante `get_agent_variable_bindings` y `set_agent_variable_bindings`.
* **GoHighLevel:** elegir pipelines, etapas, entradas por workflow o defecto, filtros de importación recurrente y equivalencias de resultados con `change_agent_ghl_flow` y sus catálogos.
* **Zoho:** campos, Variables, estados, herencia y activación de salidas por Agente con `change_agent_zoho_flow`; `change_zoho_account_defaults` cambia valores generales y conserva las configuraciones particulares.
* **HubSpot:** rutas de listas, campos, estados, entrada del portal, historial de actividades y comportamiento de Grupo. `list_agent_hubspot_catalog` consulta propietarios, pipelines y propiedades. `change_hubspot_account_controls` configura controles generales de entrada e historial.
* **Kommo:** crear, cambiar, pausar, activar o eliminar rutas con `change_agent_kommo_route`, incluida la entrada de leads sin clasificar para la ruta principal. Las rutas modificadas quedan pausadas. `count_agent_kommo_source` cuenta sin importar; `has_more` indica que puede haber más registros.
* **Webhooks personalizados:** crear, mapear, pausar, activar o eliminar con `change_agent_custom_intake`. `reassign_crm_intake` mueve una entrada personalizada o ruta de Kommo a otro Agente y la deja pausada; no mueve leads existentes.
* **Agendamiento nativo:** seleccionar un enlace de HubSpot o calendario de GoHighLevel con las [herramientas de agenda CRM](/docs/es/guides/meetings/crm-booking-chat).
`list_crm_account_connections` incluye entradas personalizadas sin Agente asignado. `get_crm_account_configuration` devuelve los valores compartidos, su revisión y los Agentes que debes revisar. `get_crm_intake_details` entrega la URL autorizada de recepción y, en entradas personalizadas, los nombres y tipos de campos recibidos sin los valores del lead. La URL contiene un secreto: compártela solo con el operador autorizado del sistema que enviará datos. `rotate_kommo_webhook_token` la renueva después de confirmar; actualiza los sistemas externos con la nueva URL. La limpieza de la suscripción anterior puede fallar y no se presenta como garantizada.
## Importaciones y sincronización manual
`run_crm_account_import` agrega un trabajo con la configuración revisada. El proceso la comprueba nuevamente antes de empezar:
* GoHighLevel `dry_run` solo consulta. `backfill` importa contactos históricos sin asignar Agentes ni iniciar contacto.
* Kommo `run_now` recorre todas las rutas activas y puede importar o mover registros e iniciar contacto.
* Odoo `inbound` respeta los bloqueos del motor y puede incorporar o contactar leads. No ejecuta salidas hacia Odoo.
Consulta `get_crm_import_job` con el identificador devuelto. Estar en cola no significa haber terminado; un trabajo terminado puede incluir errores o registros omitidos. `not_found` tampoco demuestra que terminó. No repitas automáticamente una solicitud cuyo resultado sea incierto.
`get_hubspot_sync_preview` revisa una sincronización de negocios o el contexto activo inequívoco de un contacto. `run_hubspot_sync` exige las revisiones de la configuración y del contexto. La sincronización de un contacto puede enviar su estado e historial/campos pendientes de distintas tareas; por eso se trata como operación de cuenta. La sincronización de negocios aplica las transiciones configuradas y puede disparar sus efectos.
`get_agent_crm_diagnostics` consulta evidencia segura de toda la conexión para los proveedores compatibles. Excluye errores crudos, credenciales y datos recibidos de leads. `get_agent_ghl_import_status` detalla ejecuciones guardadas de GoHighLevel. Un historial vacío significa que no hay evidencia guardada de ejecución.
## Límites de Odoo
Usa `connect_crm` con `provider: "odoo"`. Introduce URL, base de datos, usuario y API key solamente en el formulario seguro. Reconectar la misma identidad renueva sus credenciales y conserva la configuración. No pegues credenciales en el chat.
Para un Agente o Grupo usa `get_agent_odoo_inputs`, `preview_agent_odoo_inputs` y `change_agent_odoo_inputs`. Guardar exige una previsualización exitosa y reciente del mismo cambio. Las rutas, campos y reglas de ciclo de vida conservan la configuración de los demás Agentes. Los conteos de la previsualización abarcan toda la conexión, incluidas las rutas que se conservan.
`change_odoo_account_inputs` configura rutas compartidas, fecha de corte, campos y límites. Las conexiones antiguas solo aceptan rutas equivalentes al comportamiento anterior, activación y fecha de corte. Las actualizaciones de motor no disponibles se rechazan. `list_odoo_sync_conflicts` y `resolve_odoo_sync_conflict` permiten consultar conflictos y registrar decisiones admitidas; resolver no agrega una sincronización a la cola. La falta de visibilidad del proveedor no se puede ignorar como si fuera una decisión de negocio.
El motor nuevo de aplicación de entradas y las salidas de Odoo mantienen sus bloqueos. `change_odoo_account_outputs` puede guardar salidas desactivadas o solicitar una previsualización sin escrituras. Un análisis incompleto no sirve como aprobación y devolver cero operaciones no demuestra que no haya trabajo. Actividades, cotizaciones y recuperación ante fallos de salida siguen fuera de esta entrega.
La referencia pública incluye [configuración de cuenta](/docs/es/api/crm-chat/get-crm-account-configuration), [importaciones](/docs/es/api/crm-chat/run-crm-account-import), [diagnóstico](/docs/es/api/crm-chat/get-agent-crm-diagnostics) y [entradas Odoo](/docs/es/api/crm-chat/get-agent-odoo-inputs). Esta entrega suma 21 herramientas a las 16 anteriores de este trabajo de paridad: 37 incorporaciones. No es el total del catálogo MCP de Nexor.