Crear un Canvas

Canvas es el generador visual de recorridos de Joryio. Úsalo para crear flujos automatizados de varios pasos que respondan en tiempo real al comportamiento de las personas: onboarding, carritos abandonados, conversiones de prueba, campañas de reactivación y mucho más.

Naming

La ruta interna y el nombre de entidad siguen siendo canvas, pero el nombre visible para el usuario es Recorrido de usuario. Ambos términos se usan indistintamente en la documentación.

Qué puedes crear

• Flujos de onboarding: guía a las nuevas personas a través de tu producto.
• Carrito abandonado: recuerda a las personas que completen una compra.
• Conversión de prueba: acompaña a quienes están en periodo de prueba hacia planes de pago.
• Reactivación: recupera a usuarios inactivos.
• Secuencias de upselling: fomenta mejoras de plan.
• Orquestación multicanal: coordina email, SMS, Push, WhatsApp e in-app.

El asistente de seis pestañas

Canvas usa un asistente numerado de seis pestañas. El encabezado muestra un indicador de pasos con subtítulos, líneas de conexión, marcas verdes en los pasos completados y una insignia naranja ! en las pestañas que visitaste y dejaste con errores de validación. Continuar, Guardar borrador y Publicar están en el encabezado; no hay una barra de navegación inferior.

Cada cambio de pestaña guarda automáticamente el trabajo con status='draft'. El primer guardado crea el registro y los siguientes hacen PATCH. Puedes salir y volver sin perder nada.

N.º	Pestaña	Qué configuras
1	Detalles	Nombre, descripción, estado y etiquetas.
2	Entrega	Tipo de envío y configuración del desencadenante.
3	Audiencia	Selector de modo → creador de filtros → política de reentrada → criterios de salida.
4	Conversión	Eventos de conversión principal y secundarios.
5	Editor de recorridos	El editor de nodos a pantalla completa.
6	Resumen	Revisión de solo lectura antes de publicar.

Abre el asistente en Canvas → Nuevo recorrido de usuario.

Pestaña 1: Detalles

• Nombre - obligatorio - y descripción opcional.
• Estado: draft / active / paused / archived. La mayoría de los recorridos empiezan como draft y pasan a active al publicarlos.
• Etiquetas: etiquetas para delimitar equipos que también sirven para omitir listas de supresión, igual que en las campañas. Escribe una etiqueta, pulsa Intro y se añade como una píldora que puedes eliminar debajo del campo.

Pestaña 2: Entrega

Elige un tipo de envío; es obligatorio, sin valor predeterminado oculto:

Tipo de envío	Cuándo entran las personas
immediate	Una vez, justo después de publicar, para todas las personas que coincidan con la audiencia.
scheduled	Una vez en la fecha y hora elegidas, para quienes coincidan en ese momento.
recurring	Según una programación - diaria, semanal, mensual o cron personalizado - . La audiencia se vuelve a evaluar en cada ejecución.
trigger	Cuando se activa un desencadenante: evento, cambio de entidad, WhatsApp entrante, SMS entrante o llamada a API. La audiencia determina la entrada de cada persona.

Para el modo trigger, elige un tipo de desencadenante, también obligatorio:

• Integrado: los desencadenantes propios de alto valor de Joryio, presentados en una lista seleccionada para no tener que buscarlos entre todos los eventos registrados:

  • Vuelve a estar disponible / reposición: un producto o artículo que interesó a una persona vuelve a estar disponible. Elige la fuente: Catálogo de productos - back_in_stock, emitido automáticamente por persona desde tu tienda sincronizada: Shopify / WooCommerce / Magento - o Entidad personalizada - entity_back_in_stock, procedente de una alerta de relación entre entidades, por ejemplo un curso, episodio o turno - .
  • Bajada de precio - price_drop - : un producto que interesó a una persona bajó de precio por debajo de tu umbral, según el catálogo de productos sincronizado.

  Cada uno se guarda como un desencadenante de evento normal, y puedes añadir condiciones por propiedad directamente en el selector - por ejemplo, solo una categoría específica o por debajo de un precio - .

• Evento registrado: se activa cuando se registra para la persona un evento con el nombre indicado.

• Entidad modificada: se activa al created / updated / deleted o al cambiar un campo de una entidad personalizada.

• WhatsApp entrante: se activa cuando la persona envía un mensaje entrante de WhatsApp que coincide.

• SMS entrante: se activa cuando un contacto conocido escribe. Filtra por cuenta de SMS, tipo de mensaje y condiciones sobre Texto del mensaje / Tipo de mensaje - igual, contiene, empieza por, etc. - . El SMS entrante se captura mediante el webhook entrante del número. Solo se inscriben contactos que ya estén en tu audiencia y tengan ese número de teléfono; las respuestas de números desconocidos se guardan, pero no crean automáticamente un contacto.

• Atributo modificado: se activa cuando cambia el valor de un atributo de usuario.

• Estado de suscripción: se activa cuando cambia el estado de suscripción de un canal o lista.

• API (entrada manual): no hay escucha automática. Las personas entran mediante POST /api/canvas/:id/enter.

Configuración adicional de entrega:

• Omitir horas de silencio: ignora las horas, días o festivos de silencio para este recorrido.
• Omitir reglas de contacto: evita los límites de frecuencia del espacio de trabajo. Se reserva para mensajes transaccionales o críticos.

Pestaña 3: Audiencia

La pestaña Audiencia se abre con un selector de modo, las mismas dos tarjetas que el asistente de campañas:

• Audiencia objetivo (RECOMENDADO: insignia verde): el creador de filtros.
• Enviar a todos: difusión a todo el espacio de trabajo.

Una vez elegido el modo, el asistente de recorridos replica exactamente el de campañas: interfaz del creador de filtros v2 - insignias de color numeradas por grupo, ConnectorChip AND/OR en línea entre filas y grupos, botones punteados + Añadir condición / + Añadir grupo de filtros, confirmación al eliminar grupos no vacíos y píldoras de conteo en vivo por grupo - . El panel derecho muestra el tamaño de la audiencia con una píldora verde En vivo, el porcentaje del espacio de trabajo, una barra de progreso de 4 px y el desglose por canal.

Los selectores de eventos y atributos son cuadros combinados con búsqueda que muestran la fila + Crear evento/atributo "<query>" cuando no hay coincidencias.

Política de reentrada

Qué ocurre cuando una persona que ya tiene una ejecución activa vuelve a activar el recorrido:

Política	Comportamiento	Etiqueta de minIntervalMinutes
block (predeterminada)	No permite reentrar.	«Enfriamiento tras la salida (minutos)»: deben pasar N minutos entre la última salida y la siguiente entrada.
restart	Sale de la ejecución anterior e inicia una nueva.	Campo oculto: reiniciar ya finaliza la ejecución anterior.
parallel	Permite varias ejecuciones simultáneas por persona.	«Tiempo mínimo entre entradas (minutos)»: limita desde la última entrada.

Para el modo parallel, define también el Máximo simultáneo - de 1 a 10 - .

Criterios de salida

Define cuándo una persona debe salir antes de un recorrido en ejecución. Usa el mismo creador de grupos de filtros que Audiencia, solo con el bloque de inclusión - sin exclusión, ya que superponer una exclusión a «eliminar usuarios que coincidan con X» crearía una doble negación confusa - .

Una tarea programada se ejecuta cada cinco minutos. Para cada recorrido activo con criterios de salida definidos, resuelve las personas coincidentes, las cruza con las ejecuciones activas y las cambia a exited con exitReason='exit_criteria_matched'.

Usos habituales:

• Detener cuando la persona convierte: filtro de evento de conversión principal.
• Eliminar al darse de baja: filtro de suscripción a canal o pertenencia a lista.
• Omitir a quienes completan el objetivo en otro lugar: filtro de comportamiento o de ejecución de Canvas.

Pestaña 4: Conversión

• Evento de conversión principal: el nombre del evento que marca a la persona como convertida. Las condiciones de propiedad opcionales afinan la coincidencia.
• Ventana de atribución: horas posteriores a la entrada durante las que aún se atribuye una conversión.
• Modelo de atribución: first_touch / last_touch / linear.
• Eventos de conversión secundarios: objetivos adicionales registrados junto al principal - por ejemplo, added_to_cart, viewed_pricing - . Cada uno puede tener una etiqueta opcional.

Pestaña 5: Editor de recorridos

Al hacer clic en esta pestaña se abre el editor de nodos a pantalla completa en /canvas/:id?from=wizard. El nodo de desencadenante ya contiene la configuración de la pestaña Entrega y está bloqueado: no puedes editarlo ni eliminarlo desde el editor. Para cambiar cómo comienza el recorrido, vuelve a la pestaña Entrega.

Nodos disponibles

Nodos de mensaje

• Email: envía un email.
• SMS: envía un mensaje de texto.
• Push: envía una notificación Push.
• WhatsApp: envía una plantilla de WhatsApp.
• In-app: muestra un mensaje in-app.
• Webhook: llama a una API externa.

Nodos lógicos

• Espera: espera un periodo fijo - por ejemplo, 1 día o 3 horas - .
• Esperar hasta: espera un evento, un cambio de atributo o una fecha específica.
• Ramificación: divide a las personas según condiciones.
• Filtro: solo deja pasar a las personas que cumplan los criterios.
• Salida: termina el recorrido.

Nodos de experimento

• Prueba A/B: prueba variantes de mensaje.
• División aleatoria: asigna personas a rutas al azar.

La acción «Volver al asistente» te devuelve a la pestaña Resumen para revisar y publicar.

Pestaña 6: Resumen

Revisión de solo lectura de toda la configuración. Los errores de validación de las pestañas anteriores aparecen aquí en un banner. El botón Publicar permanece desactivado hasta que no haya errores y el recorrido tenga al menos un nodo guardado.

Ejemplo: recorrido de conversión de prueba

Un flujo sencillo que acompaña a las personas en prueba hacia un plan de pago:

[Desencadenante: evento «trial_started»]
    ↓
[Espera: 1 día]
    ↓
[Email: bienvenida + guía de primeros pasos]
    ↓
[Espera: 3 días]
    ↓
[Ramificación: ¿ha usado la función X?]
    ├─ Sí → [Email: consejos avanzados]
    └─ No → [Email: cómo usar la función X]
    ↓
[Espera: 7 días]
    ↓
[Filtro: ¿sigue en prueba?]
    ↓
[Email: la prueba termina pronto: 20 % de descuento]
    ↓
[Esperar hasta: convierte O termina la prueba]
    ├─ Convertido → [Email: bienvenida a Premium]
    └─ Tiempo agotado → [Salida]

Ciclo de vida de una ejecución: completada o salida

Cada persona que entra en un recorrido tiene una ejecución independiente. Una ejecución puede estar en uno de cuatro estados:

Estado	Significado
active	La persona está recorriendo el flujo actualmente.
completed	La persona llegó de forma natural a un nodo de salida: terminó la ruta esperada. Se establece cuando el tiempo de ejecución alcanza un paso Salida.
exited	La persona salió del recorrido antes de alcanzar un nodo Salida. La fila de ejecución registra un campo exitReason con uno de los casos siguientes.
failed	Un nodo produjo un error grave; por ejemplo, un webhook devolvió 500 sin alternativa.

Por qué existen las ejecuciones con salida

Una ejecución puede finalizarse de forma forzada en cuatro situaciones:

• exit_criteria_matched: la ejecución coincidió con un filtro global de Criterios de salida - por ejemplo, el usuario se dio de baja o se convirtió en cliente de pago - . La tarea programada de cinco minutos retira antes a las personas coincidentes.
• reentry_restart: la persona volvió a entrar al recorrido mientras una ejecución anterior seguía activa y la política de reentrada es restart. La ejecución anterior se finaliza para que la nueva pueda empezar correctamente.
• force_exited_on_publish: un administrador publicó una nueva versión con el modo de transición forzar salida de usuarios existentes. Todas las personas en curso en la versión anterior salen.
• version_orphaned_cleanup: la persona quedó en una versión archivada. Tras una hora de inactividad en una versión huérfana, el tiempo de ejecución la limpia.

No flow-level timeout

Los recorridos de larga duración - flujos de reactivación de varias semanas o meses, etc. - están expresamente admitidos: no hay un límite global de «terminar la ejecución después de N horas». Si necesitas limitar la espera de un paso concreto, usa la duración del nodo Espera; si debes retirar a personas cuando cambie su estado, usa Criterios de salida.

Por qué la distinción importa para la segmentación

El filtro Recorrido de Canvas del creador de segmentos tiene operadores independientes para cada estado, porque describen cohortes diferentes:

• Canvas completado: tu cohorte de conversión o éxito. Personas que terminaron el flujo de forma natural.
• Canvas con salida: tu cohorte de abandono del flujo. Personas que empezaron, pero no terminaron; es útil para retargeting - por ejemplo, «usuarios que salieron pronto del recorrido de activación» → campaña de reactivación - .
• Está en Canvas: personas con ejecuciones active en este momento.
• No está en Canvas: excluye solo ejecuciones active, por lo que incluye tanto a personas que completaron como a quienes salieron; es útil para «cualquier persona que haya pasado por este recorrido en algún momento y no esté dentro ahora».

Dónde revisar lo ocurrido

• El panel Ejecuciones de recorrido - Analítica en la barra superior del editor - enumera cada ejecución con su píldora de estado, versión, nodo actual y marcas de tiempo. Al expandir una fila se muestran la cronología de ejecución - todos los nodos visitados y sus resultados - y las variables de contexto - el conjunto de variables resueltas de la ejecución - .
• Para una ejecución con salida, el motivo aparece en la API como execution.exitReason. La interfaz Ejecuciones de recorrido muestra el motivo en línea en la cronología cuando termina la ejecución.

Transiciones de estado

draft ──▶ active ──▶ paused ──▶ active
                 │
                 └──▶ archived

• Solo los recorridos draft pueden modificarse estructuralmente - nodos y conexiones - .
• active se pausa al pulsar Pausa; paused se reanuda al reactivarlo.
• Los recorridos recurrentes se pausan automáticamente cuando pasa endDate o se alcanza maxOccurrences.

Version control

Al publicar cambios en un recorrido activo, se crea una nueva versión. Las personas existentes continúan en su versión original y las nuevas reciben la actualizada. Consulta Historial de versiones para obtener más información.

Para ir más allá

• Buenas prácticas para recorridos: pautas para recorridos sencillos, oportunos y personalizados.
• Patrones de recorrido habituales: flujos listos para adaptar, como series de onboarding, carritos abandonados, reactivación y un bot de soporte por WhatsApp.

Legado

El antiguo modal «Configuración» del editor de nodos ya no contiene la política de reentrada, el seguimiento de conversiones, las etiquetas ni nada de lo que ahora está en el asistente. Solo conserva las Variantes personalizadas - selección de variantes impulsada por ML para recorridos A/B/n - .

Próximos pasos

• Referencia de nodos de Canvas
• Ramificación avanzada
• Historial de versiones
• Analítica de Canvas
• API de Canvas