Skip to main content

​
¿Qué son las Variables?

Las variables son los criterios específicos que el sistema evalúa durante el análisis de una llamada. Cada variable representa un aspecto medible del desempeño del agente o un dato a extraer de la conversación. Existen dos tipos principales de variables:

Variables de Puntuación

Evalúan el desempeño del agente con un valor numérico que contribuye al NeuraScore

Variables de Extracción

Capturan información específica mencionada durante la llamada

​
Tipos de Datos Soportados

TipoDescripciónEjemplo de Uso
INTEGERNúmeros enterosPuntuación 0-10, cantidad de productos
DECIMALNúmeros con decimalesPorcentaje de cumplimiento, monto en dólares
BOOLEANVerdadero/Falso¿Mencionó promoción?, ¿Cliente satisfecho?
STRINGTexto libreNombre del producto, motivo de llamada
DATEFechaFecha de próximo contacto
TIMEHoraHora preferida de contacto
DATETIMEFecha y horaMomento del compromiso de pago

​
Variables de Puntuación

Las variables de puntuación miden aspectos cualitativos del desempeño y contribuyen al NeuraScore final de la llamada.

​
Estructura de una Variable de Puntuación

CampoTipoDescripciónRequerido
keystringIdentificador único (snake_case)Sí
readable_namestringNombre legible para reportesSí
descriptionstringInstrucciones para el evaluador IASí
typestringTipo de dato (INTEGER, DECIMAL, BOOLEAN)Sí
weightdecimalPeso en el cálculo del NeuraScoreSí
category_iduuidCategoría a la que perteneceSí
requiredbooleanSi debe evaluarse siempreNo

​
Ejemplo: Variables de Apertura

Categoría: Apertura
saludo_corporativo (peso: 2.0)
identificacion_agente (peso: 1.5)
deteccion_necesidad (peso: 2.5)
tono_amable (peso: 1.0)

​
El Campo description

La descripción es crucial porque instruye a la IA sobre cómo evaluar. Debe ser:
1

Observable

Basada en comportamientos que se pueden escuchar en la llamada.
2

Específica

Clara sobre qué constituye cumplimiento total, parcial o nulo.
3

Medible

Con criterios objetivos que no dependan de interpretación subjetiva.
Ejemplo de buena descripción: 
Evalúa si el agente utilizó el saludo corporativo completo.
- Puntuación 10: Dijo "Bienvenido a [Empresa], mi nombre es [Nombre], ¿en qué puedo ayudarle?"
- Puntuación 5: Saludó pero omitió algún elemento del script
- Puntuación 0: No realizó saludo o fue informal

​
Variables de Extracción

Las variables de extracción capturan datos específicos mencionados durante la conversación. No contribuyen al NeuraScore pero son valiosas para análisis y reportes.

​
Casos de Uso

Intención del Cliente

Capturar el motivo principal de la llamada

Productos Mencionados

Registrar productos o servicios discutidos

Compromisos

Extraer fechas de seguimiento o pagos prometidos

Datos de Contacto

Capturar información actualizada del cliente

​
Ejemplo: Variables de Extracción para Cobranza

Modelo: Cobranza
motivo_no_pago (STRING)
fecha_compromiso_pago (DATE)
monto_prometido (DECIMAL)
cliente_confirmo_datos (BOOLEAN)

​
Gestión vía API

​
Listar Variables de un Modelo

GET /v1/models/{model_id}/variables
Authorization: Bearer <token>

​
Crear una Variable de Puntuación

POST /v1/models/{model_id}/variables
Authorization: Bearer <token>
Content-Type: application/json

{
  "key": "saludo_corporativo",
  "readable_name": "Saludo Corporativo",
  "description": "Evalúa si el agente utilizó el saludo corporativo completo según el script establecido. Puntuación 10 si es completo, 5 si es parcial, 0 si no lo realiza.",
  "type": "INTEGER",
  "weight": 2.0,
  "category_id": "uuid-de-categoria-apertura",
  "required": true
}

​
Crear una Variable de Extracción

POST /v1/models/{model_id}/variables
Authorization: Bearer <token>
Content-Type: application/json

{
  "key": "fecha_compromiso_pago",
  "readable_name": "Fecha de Compromiso de Pago",
  "description": "Extrae la fecha en que el cliente se comprometió a realizar el pago, si la mencionó durante la llamada.",
  "type": "DATE",
  "weight": 0,
  "category_id": "uuid-de-categoria-cierre",
  "required": false
}
Las variables de extracción típicamente tienen weight: 0 ya que no contribuyen al NeuraScore.

​
Actualizar una Variable

PUT /v1/models/{model_id}/variables/{variable_id}
Authorization: Bearer <token>
Content-Type: application/json

{
  "key": "saludo_corporativo",
  "readable_name": "Saludo Corporativo Completo",
  "description": "Descripción actualizada con nuevos criterios...",
  "type": "INTEGER",
  "weight": 2.5,
  "category_id": "uuid-de-categoria-apertura",
  "required": true
}

​
Restricciones Importantes

No se puede modificar ni eliminar una variable si el modelo tiene análisis existentes.Esta restricción garantiza la integridad de los datos históricos. Los análisis completados mantienen su estructura original para que los reportes comparativos sean consistentes.

​
¿Qué hacer si necesitas modificar variables?

  1. Crear un nuevo modelo: Duplica el modelo con las variables actualizadas
  2. Agregar variables: Puedes agregar nuevas variables a modelos existentes
  3. Desactivar el modelo: Desactiva el modelo actual y crea uno nuevo con la estructura deseada

​
Distribución de Pesos

El weight determina cuánto impacta cada variable en el NeuraScore final. Considera:
1

Identifica variables críticas

¿Cuáles son los comportamientos más importantes para el éxito de la llamada?
2

Asigna pesos proporcionales

Variables críticas: peso 2.0-3.0. Variables importantes: peso 1.0-2.0. Variables secundarias: peso 0.5-1.0.
3

Valida el balance

Ninguna variable debería dominar completamente el score. Revisa que la suma total refleje tus prioridades.
4

Ajusta por categoría

Considera si el peso total de cada categoría refleja su importancia relativa en la llamada.

​
Mejores Prácticas

Usa keys descriptivos

verifico_identidad es mejor que var_001

Descripciones detalladas

Incluye ejemplos concretos de qué constituye cada nivel de puntuación

Agrupa lógicamente

Asigna cada variable a la categoría que corresponde a esa fase de la llamada

Limita la cantidad

5-15 variables por modelo es ideal. Demasiadas dificultan el análisis

​
Relación con Otros Recursos

Categorías de Modelo

Agrupaciones que contienen las variables

API de Variables

Referencia completa de endpoints