Los datos de una conversación

La idea: una libreta que se va llenando

Imagina que cada conversación lleva una libreta. Mientras la persona habla con ELYRA, en esa libreta se van apuntando cosas: quién escribe, qué hora es, lo que la persona respondió, el número de caso que dio el sistema.

Cada apunte tiene dos partes:

• un nombre, siempre el mismo: correo;
• un valor, lo que se apuntó esta vez: [email protected].

A cada apunte se le llama dato. Los datos sirven para dos cosas:

1. Para escribir. Un mensaje puede decir «Te escribo a {{correo}}», y la persona lee «Te escribo a [email protected]». Las llaves dicen «aquí va lo que esté apuntado con ese nombre».
2. Para decidir. Un camino puede preguntar «¿el correo tiene algún valor?» o «¿la hora es menor que 8?» y tomar un rumbo u otro.

En el portal no hace falta recordar ningún nombre: se escribe / en un texto o en una condición y aparece la lista de lo que la libreta tiene, agrupado según de dónde salió cada dato.

Un ejemplo de principio a fin

Una persona escribe por WhatsApp para reportar una falla. Al lado de cada mensaje, en gris, lo que se apunta en la libreta en ese momento.

Reportar una falla

hola

se apunta: remitente, canal, la fecha y la hora

¿En qué te ayudo? Reportar una fallaConsultar un caso

Reportar una falla

¿Qué pasó?

Se cayó el correo de todo el piso

se apunta: descripcion

¿Qué tan urgente es? 🔴 Alta🟢 Baja

🔴 Alta

se apunta: urgencia = alta

Quedó el caso INC000123. Te aviso cuando lo cierren.

el sistema devuelve: numero_caso = INC000123 · y queda: resultado_servicio = ok

Cada respuesta, cada decisión y cada resultado deja algo apuntado.

Al terminar, la libreta de esta conversación tiene esto:

Dato	Valor	Quién lo apuntó
remitente	573001XXXXXX	ELYRA, al llegar el primer mensaje
canal	whatsapp	ELYRA, al llegar el primer mensaje
hora	9	El reloj
descripcion	Se cayó el correo de todo el piso	La pregunta «¿Qué pasó?»
urgencia	alta	La pregunta «¿Qué tan urgente es?»
numero_caso	INC000123	El sistema, al crear el caso
resultado_servicio	ok	El servicio, al terminar bien

Con eso, el mensaje final pudo decir «Quedó el caso {{numero_caso}}», y un camino de más abajo podría decidir «si urgencia es alta, avisa al supervisor».

Léalo así: un dato solo existe después de que algo lo apunta. Antes de la pregunta «¿Qué pasó?», descripcion está vacío. Por eso la salud del documento avisa cuando un texto usa un dato que nada apunta antes.

Los ocho orígenes, uno por uno

En el «/», los datos se agrupan según quién los apunta. Son ocho grupos.

1. Lo que se pregunta

Qué es: la respuesta de la persona a un bloque Pregunta.

Ejemplo: la pregunta «¿Cuál es tu correo?» con el nombre de dato correo. La persona escribe «[email protected]» y se apunta [email protected].

Cuándo aparece: cuando la persona responde.

El nombre lo pones tú al crear la pregunta. El valor se apunta ya limpio, según lo que la pregunta espera: un correo, en minúsculas; un teléfono, solo los dígitos; una opción, su valor exacto aunque la persona haya tocado el botón con su emoji. La tabla completa está al final.

2. Lo que le entregan

Qué es: datos que una capacidad recibe ya hechos de la que la abre, para no volver a preguntarlos.

Ejemplo: la persona consulta un caso y, al final, ELYRA le ofrece vigilarlo. La capacidad «Vigilar un caso» necesita el número, pero la persona ya lo dio un momento antes.

Consultar y luego vigilar

¿Qué número de caso consulto?

INC000123

se apunta: numero_caso = INC000123

El caso INC000123 está En curso. ¿Algo más? Vigilar este casoTerminar

Vigilar este caso

la opción le entrega a «Vigilar un caso»: numero_caso = {{numero_caso}}

Listo, te aviso cuando INC000123 cambie de estado.

no volvió a preguntar el número

La opción del menú le pasa a la siguiente capacidad lo que ya está en la libreta.

Cuándo aparece: desde que la capacidad que lo recibe arranca.

Lo que se entrega lo configura quien arma el menú, en la opción: «a esta capacidad pásale numero_caso». Puede ser un dato de la libreta, como en el ejemplo, o un valor fijo. Además de una opción de menú, pueden entregar datos otra capacidad que la llama, una carta programada o una fila de un archivo en un lote. Lo que una capacidad espera recibir se ve arriba en su documento, en Acepta.

3. Lo que se guarda

Qué es: un dato que la capacidad apunta por su cuenta, sin preguntarle a nadie, con un bloque Guardar un dato.

Ejemplo: guardar origen = chat para que el sistema sepa por dónde llegó el caso; o resumen = {{urgencia}} - {{descripcion}}, armado con otros datos que ya están en la libreta.

Cuándo aparece: cuando la conversación pasa por el bloque.

Lo guardado puede quedarse solo en esta conversación o en la persona: en ese caso ELYRA lo vuelve a tener en sus siguientes conversaciones, hasta que caduca.

4. Lo que responde el sistema

Qué es: lo que devuelve el sistema de la organización cuando un bloque Servicio le pide algo.

Ejemplo: al crear un caso, el sistema contesta con su número y su estado: se apuntan numero_caso = INC000123 y estado = Asignado.

Cuándo aparece: cuando el servicio sale bien. Si falla, no llega nada.

Debajo de cada servicio, el documento enseña lo que ese sistema ha respondido de verdad otras veces, con un ejemplo, para saber qué datos se pueden esperar.

5. El listado

Qué es: cuando el sistema devuelve varios resultados (todos los casos de una persona), además de ellos se apunta el listado ya escrito y su cuenta.

Ejemplo: «Tienes {{total}} casos: {{items}}» se lee «Tienes 3 casos: INC01 abierto, INC02 en curso, INC03 cerrado».

Cuándo aparece: cuando el servicio que lista sale bien.

6. Cómo acabó un bloque

Qué es: algunos bloques pueden acabar de más de una forma, y apuntan cuál fue.

Ejemplo: después de «Por cada fila» se apunta resultado_lote = cancelado si la persona dijo que no. Un camino debajo puede decir «Listo, no lancé nada» en vez de «Va en marcha».

Cuándo aparece: cuando el bloque termina.

Estos datos solo tienen unos pocos valores posibles, y la condición los ofrece en una lista. Todo el detalle: Según cómo acabó un bloque.

7. Siempre disponibles

Qué es: lo que ELYRA sabe de quién escribe y por dónde, sin que nadie lo pregunte.

Ejemplo: {{canal}} vale whatsapp; {{remitente}} es el número desde el que escribe; identidad_verificada dice si ese número es de alguien de la agenda y está probado.

Cuándo aparece: desde el primer mensaje.

8. El reloj

Qué es: la fecha y la hora del momento, en la zona horaria de la organización.

Ejemplo: «si hora es menor que 8 → estamos fuera de horario»; o un mensaje que diga «Recibido el {{fecha_actual}}».

Cuándo aparece: siempre.

Para escribir o para decidir

Casi todos los datos sirven para las dos cosas. Unos pocos solo dicen «sí» o «no» (identidad_verificada, remitente_es_telefono); esos solo se ofrecen en las condiciones, porque dentro de un mensaje se leerían como true.

Cuando un dato solo puede tener unos valores concretos (una pregunta de elegir, cómo acabó un bloque), la condición no pide escribir el valor: lo ofrece en una lista. Los demás tipos de comparación están en Escenario.

Cuánto dura lo apuntado

• La libreta es de la conversación. Todo lo apuntado lo ven todas las capacidades que corren en ella, también las que se llaman unas a otras. Cuando la conversación termina, la libreta se tira.
• Lo guardado en la persona es la excepción: se copia a la ficha de esa persona y vuelve en sus siguientes conversaciones hasta que caduca.
• Si dos bloques apuntan el mismo nombre, vale el último. El segundo borra lo que escribió el primero.

Cómo se llaman

Los nombres van en minúsculas, sin tildes ni espacios: anio y no año, numero_caso y no Número de caso. ELYRA los convierte sola cuando pones el nombre de una pregunta o de un dato guardado. En el documento se lee siempre su nombre humano («El año», «Número de caso»), dentro de una píldora.

Todos los valores, para consultar

Lo que queda según lo que espera una pregunta

La pregunta espera	Lo que se apunta	Ejemplo
Texto libre	Lo escrito, tal cual	Se cayó el correo
Un número	El número	3
Una fecha	Como llegó	2026-10-05 o 05/10/2026
Una hora	Como llegó, en 24 h	14:30
Un correo	En minúsculas	[email protected]
Un teléfono	Solo los dígitos, con + si lo traía	+573001XXXXXX
Un valor en dinero	Número con punto decimal	1250.50
Una de las opciones	El valor de la opción, no lo que ve la persona	alta (la persona tocó «🔴 Alta»)
Un archivo	El nombre del archivo, y en {{dato}}_id su referencia	factura.pdf

Una opción también puede apuntar otros datos al elegirla (elegir «Sede norte» puede apuntar ciudad = Bogotá). Ver Pregunta.

El listado

Dato	Valor
{{items}}	El listado completo, ya escrito
{{total}}	Cuántos hay en total
{{mostrados}}	Cuántos se muestran

Cómo acabó un bloque

Bloque	Dato	Valores
Por cada fila	resultado_lote	lanzado · cancelado
Servicio	resultado_servicio	ok · fallo · sin_respuesta

Siempre disponibles

Dato	Qué vale	Cuándo tiene sentido
{{remitente}}	Quien escribe, tal cual llega	Siempre: un teléfono en WhatsApp, un usuario en Telegram, un id en Teams
{{remitente_digitos}}	Solo los dígitos de quien escribe	Si escribe desde un teléfono
{{remitente_local}}	Los últimos 10 dígitos	Si escribe desde un teléfono
{{canal}}	whatsapp, telegram, teams, slack, google_chat, email o web	Siempre
{{remitente_correo}}	El correo de quien escribe	Si el canal lo trae de su directorio (Teams)
remitente_es_telefono	Sí o no	Solo para decidir
identidad_verificada	Sí o no: está en la agenda y su dirección está probada	Solo para decidir. Un correo que la persona teclea no lo prueba

El reloj

Dato	Qué vale	Ejemplo
{{fecha_actual}}	La fecha	2026-10-05
{{dia}} · {{mes}} · {{anio}}	Día, mes y año, como números	5 · 10 · 2026
{{hora_actual}}	La hora	14:30
{{hora}}	La hora como número, de 0 a 23	14
{{dia_semana}}	El día, en minúsculas y sin tildes	miercoles