CRM NEXUS

CRM NEXUS (nexus_crm) ejecuta una acción determinística usando la conexión Nexus activa del agente. El grafo no guarda URL, tenant ni credenciales.

Recursos y operaciones

• Contactos: crear u obtener el actual, consultar, buscar, editar, agregar y quitar etiquetas.
• Tickets: crear, crear desde conversación, consultar y buscar.
• Oportunidades: crear, buscar, editar y mover de etapa.
• Notas: crear y consultar.
• Actividades: crear, consultar y completar.

La guía exhaustiva de CRM NEXUS detalla los campos de cada acción.

Identidad del contacto

Con Contacto de esta conversación, el runtime prioriza la identidad original del canal y agrega email o teléfono capturados en facts como evidencia no verificada. Nexus resuelve el contacto existente o lo crea cuando corresponde, sin promover automáticamente datos escritos por el usuario a una identidad confiable.

También podés seleccionar Otro contacto y proporcionar un ID o placeholder explícito.

Entrada, salida y memoria

Los parámetros aceptan valores fijos y placeholders. En Guardar datos del resultado mapeá IDs o campos puntuales a facts.

Con manejo por ramas aparecen Éxito y Error. El error normalizado diferencia falta de conexión, autenticación, validación, registro inexistente, conflicto y fallos generales.

Seguridad e idempotencia

Preferí este nodo antes que HTTP para operaciones soportadas. Crear ticket desde conversación usa una clave estable para evitar duplicados durante reintentos de la misma conversación.

Antes de activar

1. Confirmá que el agente tenga Nexus conectado.
2. Revisá contacto actual u otro ID.
3. Elegí pipeline, etapa, etiqueta o responsable válidos.
4. Conectá Éxito y Error.
5. Probá el resultado guardado y un error de integración.

Siguiente categoría: Llamar workflow

Usar Nexus mientras el agente conversa

Para una acción que debe ocurrir al llegar a un paso, usá un nodo Nexus. Para que el agente consulte o actualice información según lo que se conversa, abrí el nodo Agente → Nexus CRM y habilitá sus acciones.

Podés empezar con Datos del contacto o Asistente de ventas. Los ejemplos agregan acciones sin reemplazar las condiciones o los permisos que ya configuraste.

• Contacto: consultar y corregir nombre, email o teléfono, actualizar campos personalizados y agregar o quitar etiquetas.
• Oportunidad: consultar, actualizar sus datos y moverla a una etapa permitida.
• Seguimiento: guardar notas, programar y consultar actividades, completar una actividad del contacto o registrar eventos comerciales definidos en Nexus.
• Atención: crear un ticket para el contacto actual.

En cada acción podés indicar cuándo usarla y elegir los campos que puede modificar. Cada campo obtiene su valor de la conversación, de un valor fijo o de una variable capturada en un paso anterior. Para etiquetas, etapas, responsables y eventos, seleccioná las opciones permitidas. No hace falta copiar sus IDs.

Crear la oportunidad antes de conversar

Conectá tu rama de intención con Crear o recuperar oportunidad y después con el agente. Dentro del agente, elegí ese paso en ¿Con qué oportunidad trabaja?. El agente operará sobre esa oportunidad del contacto actual, también en los mensajes siguientes. Si todavía no existe el vínculo, la acción devuelve un error; no elige otra oportunidad por su cuenta.

Por defecto se conserva una oportunidad por contacto y paso del workflow. Para permitir varias solicitudes de la misma persona, configurá una clave del proceso distinta por solicitud, usando una variable estable. No uses el ID del mensaje: cambia en cada turno. Si la oportunidad ya está cerrada, una nueva solicitud necesita otra clave. La opción Crear otra oportunidad cada vez conserva la creación sin reutilización cuando ese es el comportamiento buscado.

Reintentos y límites

Las notas, actividades, eventos y tickets requieren un identificador estable del mensaje. Repetir la misma acción con los mismos datos en ese mensaje no crea otro registro. Un mensaje nuevo puede crear otro cuando corresponda.

Si Nexus no confirma una creación, la operación queda pendiente de revisión. No se repite automáticamente porque podría haberse guardado en el CRM. Esto evita reintentos ciegos; no constituye una transacción distribuida con Nexus.

Las herramientas se habilitan por nodo. Las restricciones de este panel se aplican a estas acciones nativas; revisá por separado cualquier integración Nexus anterior que hayas agregado en Herramientas. Estas acciones no borran contactos ni cierran oportunidades como ganadas o perdidas. Un evento puede iniciar las reglas comerciales configuradas en Nexus.