# Canvas y flujo esperado

> El documento de definición de una implementación: el canvas con sus secciones fijas, el flujo esperado dibujado como diagrama, cómo usar el editor y cómo los aprueba el cliente.

Antes de construir, el cliente aprueba **qué** va a hacer el agente y **cómo** va a ser la conversación. Eso es la **definición**: el canvas y el flujo esperado, que se aprueban juntos. Los dos se editan en la pestaña **Definición** de cada implementación.

<Note>
  El canvas y el flujo esperado son una referencia visual y lógica de lo acordado con el cliente. Editarlos o aprobarlos no configura al agente ni ejecuta acciones: la configuración técnica se realiza por separado en el agente y sus herramientas.
</Note>

## Video

<video controls className="w-full aspect-video rounded-xl" src="/videos/partners/implementaciones.mp4"></video>

## El canvas

En **Definición → Canvas del agente** hay un documento con una caja por sección. Los títulos de las cajas son fijos: no se borran ni se mueven. Adentro escribes libre: párrafos, listas (empieza la línea con `- `), títulos chicos (`## `) y negrita. Se guarda solo, un segundo después de que dejas de escribir.

**El agente**

| Sección | Qué va |
| --- | --- |
| **Objetivo** | Qué tiene que lograr: vender, resolver dudas, tomar turnos. |
| **A quién atiende** | Quiénes escriben y qué suelen buscar. |
| **Tono y estilo** | Tuteo o voseo, emojis, largo de los mensajes. |
| **Qué hace** | Lista de lo que resuelve solo. |
| **Qué no hace** | Lo que no hace nunca: precios especiales, reclamos, temas ajenos al negocio. |
| **Cuándo deriva a una persona** | En qué casos pasa la conversación al equipo, y a quién. |
| **Conocimiento** | Catálogo, políticas, preguntas frecuentes y de dónde salen. |
| **Herramientas** | Qué consulta en sus sistemas: stock, pedidos, turnos, envíos. |

**La plataforma**

| Sección | Qué va |
| --- | --- |
| **Canales** | WhatsApp, Instagram, chat web: qué números y cuentas. |
| **Seguimientos automáticos** | A quién se le escribe solo, cuándo y con qué plantilla. |
| **Campos personalizados** | Qué datos se guardan de cada contacto y de qué tipo. |
| **Integraciones** | Sistemas conectados y por dónde: API, webhooks, MCP. |
| **Miembros y permisos** | Cuántas personas, qué rol y a qué bandejas entra cada una. |
| **Bandejas y horarios** | Cómo se ordena el chat y en qué horario atiende el equipo. |
| **Observaciones** | Todo lo demás. |

La tarea **Definición de cómo debería funcionar el agente** se completa sola cuando el canvas tiene, como mínimo, **Objetivo**, **Qué hace** y **Qué no hace**.

<Tip>
  Escribe **Qué no hace** con tanto detalle como **Qué hace**. Es lo que más se nota en las conversaciones y lo primero que revisa el cliente.
</Tip>

## El flujo esperado

En **Definición → Flujo esperado** se dibuja la conversación como un diagrama de pasos de izquierda a derecha. Puedes tener varios **Inicios**, uno por tipo de consulta, con recorridos independientes o que se unen. Cada paso tiene un tipo:

| Tipo | Para qué |
| --- | --- |
| **Inicio** | Lo que dispara la conversación (*El cliente escribe*). |
| **Responde** | El agente contesta algo. |
| **Pregunta** | El agente pide un dato. |
| **Decide** | El camino se abre según lo que pasa. |
| **Herramienta** | El agente consulta un sistema. |
| **Deriva a humano** | Pasa la conversación al equipo. |
| **Fin** | Cierra la conversación. |

### Cómo usar el editor

- **Empezar**: con el flujo vacío, toca **Usar el ejemplo** (un flujo de consulta de stock con derivación de reclamos) y adáptalo, o **Empezar vacío**.
- **Agregar un paso**: toca el **+** a la derecha de un paso y elige el tipo; queda conectado. Para meter un paso entre dos, toca el **+** de la conexión. También puedes sumar uno suelto con **+ Paso**, o un inicio independiente con **+ Inicio**.
- **Editar**: doble clic en el paso para cambiar el texto (Enter guarda, Escape cancela). Al seleccionarlo aparece un panel debajo con el **Tipo de paso**, el **Detalle** (qué dice, qué datos pide, a quién deriva) y **Sacar paso**.
- **Conectar**: arrastra desde el punto de la derecha de un paso hasta el punto izquierdo de otro. Cada paso puede tener hasta 6 salidas.
- **Condiciones**: toca la etiqueta **condición** de una conexión y escribe cuándo se toma ese camino (*si es un reclamo*, *si hay stock*).
- **Sacar**: selecciona un paso o una conexión y presiona Supr, o usa la **×** de la conexión.
- **Ordenar** acomoda los pasos de izquierda a derecha. **Pantalla completa** te da más espacio (Escape para salir).

Abajo del diagrama aparecen los problemas que conviene arreglar, por ejemplo *Falta un paso de inicio* o un paso que *no lleva a ningún lado* (todos tienen que terminar en **Fin** o **Deriva a humano**).

La tarea **Flujo esperado y derivación a humano** se completa sola cuando el flujo tiene al menos 3 pasos y una derivación.

## La aprobación del cliente

El cliente ve la definición en su cuenta, en **Implementación → Canvas y flujo**, y la aprueba con **Aprobar canvas y flujo**. La aprueba quien administra la cuenta del cliente. En su lista **Lo que necesitamos de vos** le aparece la tarea **Revisar y aprobar el canvas y el flujo esperado** apenas el flujo tiene al menos 2 pasos.

- La aprobación cubre los dos juntos: no hay un alcance aparte para aprobar.
- Si después cambias un texto del canvas, o un paso, una conexión o una condición del flujo, la aprobación queda vencida: ves *Cambió después de que … lo aprobara: hay que volver a aprobarlo* y al cliente le aparece **Volver a aprobar el canvas y el flujo (cambiaron)**.
- **Mover pasos en el diagrama no cuenta** como cambio.
- **Cliente aprueba la definición** es una tarea clave: no se pasa a **Construcción** sin ella.

## Checklist de la definición

- [ ] El canvas tiene todas las secciones del agente completas.
- [ ] **Qué no hace** y **Cuándo deriva a una persona** son concretos.
- [ ] La parte de la plataforma está completa (canales, equipo, bandejas, campos).
- [ ] El flujo tiene inicio, al menos una herramienta si hay sistemas, y todos los caminos terminan en **Fin** o **Deriva a humano**.
- [ ] Las conexiones de cada **Decide** tienen su condición.
- [ ] El cliente aprobó, y no cambió nada después.
