Skill de Nexus Workflows

La skill Nexus Sales Automations crea workflows propios del CRM disponible en nexus.atendium.com. Su foco es que cada contacto reciba seguimiento y que cada oportunidad abierta tenga owner, etapa y próxima acción.

Descargar Nexus Workflows .zip

Cuándo usarla

Asignar leads y responsables.
Calificar contactos y actualizar lifecycle o score.
Crear y mover deals.
Crear tareas, llamadas, emails y próximas actividades.
Diseñar cadencias cancelables por respuesta.
Recuperar oportunidades estancadas.
Reaccionar a formularios, mensajes, campañas o eventos CRM.
Revisar o simular una automatización existente.

No es la skill de workflows conversacionales de Atendium. Puede usar acciones como una plantilla WhatsApp desde Nexus, pero el proceso se ejecuta en el CRM.

Recibir contexto desde Atendium

Las skills de Agentes Legacy y Atendium Workflows pueden entregar un prompt de continuidad comercial listo para copiar. Nexus Workflows conserva las decisiones ya resueltas, distingue eventos inferidos por IA de ramas determinísticas y pregunta mediante choices únicamente por datos pendientes como pipeline, owner, SLA o cadencia.

Ese prompt no activa nada ni autoriza efectos reales. Si Atendium ya creó el contacto, deal, etiqueta o actividad, la automatización de Nexus debe evitar duplicarlo.

Invocación

$nexus-sales-automations <comando> <objetivo o archivo>

Comandos generales

Comando	Para qué sirve
`shape`	Indaga el proceso comercial y entrega arquitectura sin JSON final.
`build`	Genera workflow `draft`, escenarios mock y validación.
`edit`	Modifica conservando keys, IDs y comportamiento no solicitado.
`critique`	Evalúa seguimiento, conversión, ownership y próxima actividad.
`audit`	Revisa esquema, seguridad, ramas, duplicación e idempotencia.
`simulate`	Recorre condiciones, respuestas, timeouts y acciones con mocks.
`validate`	Valida y corrige iterativamente.
`harden`	Añade dedupe, límites, fallbacks, aprobación y recuperación.
`optimize`	Reduce runs innecesarios y acciones duplicadas.
`explain`	Explica lo que ocurre con contacto, deal y actividad en cada ruta.

Comandos comerciales

Comando	Para qué sirve
`cadence`	Seguimiento multintento que termina por respuesta, opt-out, conversión o límite.
`rescue`	Recuperación de leads fríos, actividades vencidas o deals fuera de SLA.
`funnel`	Recorrido completo desde entrada hasta `won`, `lost` o nurture.

Ejemplos

$nexus-sales-automations shape seguimiento de leads de WhatsApp
$nexus-sales-automations build asignar nuevos leads por round-robin
$nexus-sales-automations cadence tres intentos si el lead no responde
$nexus-sales-automations rescue deals estancados en propuesta
$nexus-sales-automations funnel contacto nuevo hasta venta
$nexus-sales-automations simulate workflow.json

Descubrimiento guiado

La skill pregunta en lenguaje comercial y presenta choices. Puede indagar trigger, canal, identidad, calificación, pipeline, owner, SLA, cadencia, cierre y KPI.

¿Las conversaciones deben tratarse igual en todos los canales?

A. Todos los canales siguen la misma lógica.
B. Cada canal tiene seguimiento o cadencias diferentes.
C. Sólo WhatsApp tiene tratamiento especial.
D. Otro — describilo con tus palabras.

No pregunta qué nodos desea el usuario: traduce el proceso a triggers, condiciones y acciones de Nexus.

Capacidades cubiertas

La skill conoce los nodos estructurales de trigger, acción, condición, espera, espera por evento, IA, fuente de datos, HTTP, código, variables, aprobación humana y fin.

También conoce los triggers de contactos, deals, actividades, Inbox, marketing, tickets, agenda y webhooks; además de acciones para ownership, lifecycle, scoring, pipeline, actividades, comunicación, secuencias, marketing e integraciones.

Principios comerciales

Resolver identidad y duplicados antes de crear registros.
Crear un deal cuando exista potencial económico, no ante cada interacción.
Toda oportunidad abierta debe tener owner y próximo paso.
Mover de etapa sólo por evidencia comercial.
Detener cadencias ante respuesta, opt-out, conversión o cierre.
Usar IA para clasificar o proponer, con guardas y aprobación para efectos sensibles.
Medir respuesta, contacto efectivo, conversión, aging, SLA, ciclo y win rate.

Validación funcional con mocks

python3 scripts/validate_and_simulate.py workflow.json \
  --scenarios scenarios.json \
  --report report.json

El validador comprueba nodos, triggers, acciones, campos obligatorios, condiciones, ramas, referencias, ciclos, alcanzabilidad, secretos e invariantes comerciales. Después simula caminos como:

lead responde o alcanza timeout;
condición verdadera o falsa;
WhatsApp enviado o fallback;
aprobación o rechazo;
owner disponible o ausente;
evento repetido;
deal en etapa incompatible;
detención por respuesta, opt-out o cierre.

Todas las acciones quedan registradas como efectos simulados y no modifican Nexus.

Resultado de `build`

Objetivo y KPI.
Supuestos y decisiones tomadas mediante choices.
Workflow nativo en draft.
IDs pendientes del tenant.
Escenarios mock y reporte.
Riesgos y estrategia de dry-run.

Límites

La simulación no puede confirmar que un pipeline, etapa, usuario, agente o template exista; tampoco valida credenciales, permisos o entrega del proveedor. Después del mock corresponde preview/dry-run y, con autorización, una prueba controlada.