Metadatos de Llamadas

Uspeech analiza lo que ocurre dentro de la llamada. Todo lo que la rodea —cuándo ocurrió, qué agente la atendió, si fue entrante o saliente, a qué campaña pertenecía— proviene de sus propios sistemas. Hay tres formas de aportarlo:

Un manifiesto CSV para todo un proyecto — la forma más rápida de cubrir un lote de grabaciones
El diálogo Editar metadatos de la llamada sobre un archivo concreto — para corregir o completar una sola llamada
La API, al subir el archivo o después — consulte API de Metadatos de Llamadas

Las tres escriben en el mismo lugar, así que puede combinarlas sin problema.

Por qué importa

Sin metadatos, Uspeech utiliza la hora de subida del archivo y el nombre del agente que la IA escucha en la conversación. El informe se genera igualmente, pero:

La tendencia semanal y los filtros de fecha usan la fecha de subida en lugar de la fecha real de la llamada
La comparación de turnos no puede clasificar las llamadas (solo cuentan las que tienen fecha y hora reales)
El desempeño de agentes depende del nombre pronunciado en la llamada, que varía entre grabaciones
Dirección y campaña no están disponibles como filtros

Aportar los metadatos resuelve todo esto de una vez.

Cómo subir un manifiesto (muchas llamadas)

Haga clic en Conversaciones en la barra de navegación
Seleccione su proyecto de call center
En la pestaña Archivos, haga clic en Metadatos de llamadas (CSV)
Elija su archivo CSV y haga clic en Subir

Diálogo de subida de metadatos de llamadas

El diálogo informa cuántos archivos se asociaron, cuántas filas quedan pendientes (aún no existe el archivo correspondiente) y qué filas no se pudieron leer.

Formato del CSV

Una fila por llamada, con fila de encabezado:

Columna	Obligatoria	Descripción
`filename`	Sí	Nombre del archivo de audio o transcripción tal como se subió
`call_datetime`	Sí	Fecha y hora en que ocurrió la llamada
`agent_id`	No	Identificador del agente en sus propios sistemas
`agent_name`	No	Nombre visible del agente
`direction`	No	`inbound` (entrante) o `outbound` (saliente)
`caller_number`	No	Número telefónico del cliente
`campaign`	No	Nombre de la campaña o cola

Ejemplo:

filename,call_datetime,agent_id,agent_name,direction,caller_number,campaign
call_001.mp3,2026-06-15 09:12:00,A-06,Ana Diaz,inbound,+34600111222,Retención
call_002.mp3,2026-06-15 09:41:00,A-10,Luis Gomez,outbound,+34600333444,Recuperación
call_003.mp3,2026-06-15 10:02:00,A-06,Ana Diaz,inbound,+34600555666,Retención

Formatos de fecha y hora aceptados:

2026-06-15T09:12:00 (ISO 8601, con o sin zona horaria)
2026-06-15 09:12:00 o 2026-06-15 09:12
15/06/2026 09:12:00 o 15/06/2026 09:12

Los valores sin zona horaria se interpretan en la zona horaria del servidor.

Cómo se asocian las filas con los archivos

Coincidencia exacta del nombre de archivo (call_001.mp3 → call_001.mp3)
Nombre sin extensión, sin distinguir mayúsculas, como alternativa — así un manifiesto que indica call_001.wav también coincide con un call_001.mp3 ya subido

Dos consecuencias útiles:

El orden no importa. Las filas que todavía no coinciden con ningún archivo se guardan en el proyecto y se aplican automáticamente a los archivos subidos más tarde. Puede subir el manifiesto antes, durante o después de las grabaciones.
Las transcripciones también cuentan como llamadas. Los archivos SRT y VTT se asocian igual que los de audio.

Puede subir el manifiesto varias veces; las subidas posteriores agregan y actualizan las filas guardadas.

Filas que se omiten

Una fila se rechaza —y se informa en el diálogo— cuando:

filename está vacío
call_datetime falta o no tiene uno de los formatos aceptados

El resto es opcional: las columnas opcionales vacías o desconocidas simplemente se ignoran. Un valor de direction que no sea inbound u outbound se descarta y el resto de la fila se aplica igualmente.

Editar una sola llamada

En un proyecto de call center la tabla de archivos muestra dos columnas adicionales —Fecha y hora de la llamada y Agente— para que vea de un vistazo qué llamadas ya tienen metadatos. Una fecha y hora en gris es la hora de subida del archivo, usada como marcador porque todavía no se ha aportado la fecha real de la llamada.

Tabla de archivos con las columnas Fecha y hora de la llamada y Agente

Para modificar una llamada concreta, abra el menú ⋯ de su fila y elija Editar metadatos de la llamada.

Diálogo de edición de metadatos de la llamada

El diálogo está disponible para archivos de audio y para transcripciones SRT/VTT. Conviene tener presente:

Vacío borra. Si guarda un campo en blanco, se elimina el valor que hubiera. Es lo contrario del manifiesto CSV, donde una celda vacía simplemente deja el valor existente intacto.
La fecha y hora no se puede vaciar. Si la borra, la llamada vuelve a usar la hora de subida del archivo.
Un manifiesto posterior tiene prioridad. Si después sube un manifiesto CSV, sus filas sobrescriben lo que haya escrito aquí. Edite llamadas individuales después de la carga masiva, no antes.
Editar metadatos nunca vuelve a ejecutar el análisis. Las puntuaciones, los temas y el sentimiento quedan exactamente igual; solo cambian los campos descriptivos.

Identidad del agente

Uspeech mantiene un registro por agente y vincula cada llamada a él:

Si indica agent_id, esa es la clave — renombrar al agente más adelante conserva todo el histórico
Si indica solo agent_name, los agentes se asocian por nombre (se normalizan mayúsculas y espacios)
Si no indica ninguno, se usa como alternativa el nombre del agente que la IA extrajo de la conversación

Los metadatos siempre tienen prioridad. Un nombre extraído del audio nunca sobrescribe un agente aportado por el manifiesto o la API.

Enviar metadatos por la API

Si sube las grabaciones de forma programática, puede adjuntar los mismos campos a cada archivo al subirlo en lugar de mantener un CSV, modificarlos después y consultar los metadatos que tiene una llamada — consulte API de Metadatos de Llamadas.