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, quién colgó primero, 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
Sección titulada «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 de cumplimiento 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
- Los pasos de cierre pueden descontarse en llamadas que el cliente cortó, porque la transcripción rara vez muestra quién colgó; vea Quién colgó primero
Aportar los metadatos resuelve todo esto de una vez.
Cómo subir un manifiesto (muchas llamadas)
Sección titulada «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

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
Sección titulada «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 |
agent_email | No | Correo del agente, que permite a un agente invitado ver sus propias llamadas; vea Correo del agente |
direction | No | inbound (entrante) o outbound (saliente) |
ended_by | No | Quién colgó primero: customer (el cliente) o agent (el agente); vea Quién colgó primero |
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,agent_email,direction,ended_by,caller_number,campaigncall_001.mp3,2026-06-15 09:12:00,A-06,Ana Diaz,ana.diaz@example.com,inbound,customer,+34600111222,Retencióncall_002.mp3,2026-06-15 09:41:00,A-10,Luis Gomez,luis.gomez@example.com,outbound,agent,+34600333444,Recuperacióncall_003.mp3,2026-06-15 10:02:00,A-06,Ana Diaz,ana.diaz@example.com,inbound,,+34600555666,RetenciónFormatos de fecha y hora aceptados:
2026-06-15T09:12:00(ISO 8601, con o sin zona horaria)2026-06-15 09:12:00o2026-06-15 09:1215/06/2026 09:12:00o15/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
Sección titulada «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.wavtambién coincide con uncall_001.mp3ya 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. Con el análisis automático, subirlo primero evita que una llamada aparezca con un nombre deducido.
- 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
Sección titulada «Filas que se omiten»Una fila se rechaza —y se informa en el diálogo— cuando:
filenameestá vacíocall_datetimefalta 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 o de ended_by que no sea uno de los aceptados se descarta, igual que un agent_email que no sea una dirección válida. El resto de la fila se aplica igualmente.
Quién colgó primero
Sección titulada «Quién colgó primero»La mayoría de los marcadores y ACD registran qué lado cortó primero, a menudo como motivo de terminación o de liberación. Envíelo en la columna ended_by:
| Valor | Significado |
|---|---|
customer | El cliente colgó primero |
agent | El agente colgó primero |
El manifiesto también acepta cliente, client y caller para el cliente, y agente, asesor y asesora para el agente, con cualquier combinación de mayúsculas, así que la mayoría de las exportaciones del marcador sirven tal cual. Deje la celda vacía cuando el marcador no lo registró.
Por qué enviarlo. Un cliente que dice “bueno, gracias” y cuelga mientras el agente todavía está cerrando se ve, en la transcripción, exactamente como una despedida normal. Con ended_by, los pasos del guion de cierre que usted marque en la rúbrica no se descuentan en esas llamadas; vea Pasos de cierre cuando el cliente cuelga.
Tres cosas que conviene saber:
- Es opcional. Las llamadas que no lo traen se califican exactamente igual que antes.
customeren una llamada normal es lo esperado. Muchos clientes cuelgan después de la despedida del agente. Esas llamadas se siguen calificando con normalidad: un paso solo se exime cuando el agente no llegó a despedirse.- Se lee al calificar la llamada. Agregarlo o cambiarlo en una llamada ya calificada no cambia nada hasta que vuelva a analizar esa llamada.
El valor también aparece como Colgó primero en el detalle de la llamada, y como columna Hung up first en la exportación a Excel de los resultados COPC.
Editar una sola llamada
Sección titulada «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.

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

El diálogo tiene un campo para cada columna del manifiesto, incluido Colgó primero. 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. Correo del agente es la excepción: permanece en el agente mientras la llamada conserve su ID o su nombre. Vea Correo del agente.
- 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. Eso incluye Colgó primero: para que un valor nuevo cuente en la puntuación, vuelva a analizar la llamada.
Identidad del agente
Sección titulada «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.
Correo del agente
Sección titulada «Correo del agente»agent_email vincula las llamadas de un agente con su acceso, para que pueda ver sus propios resultados. No tiene ningún efecto hasta que invite a esa dirección con el rol de Agente.
- Envíelo junto con el
agent_id. El correo pertenece al registro del agente, así que una fila con ambos basta para todas las llamadas que tengan eseagent_id, incluidas las subidas antes. - Un
agent_idque sea un correo también vale. Si sus sistemas identifican a los agentes por correo, no necesita la columna adicional: unagent_idque sea una dirección válida se interpreta también como el correo del agente. - Evite un correo sin ID. Una fila sin
agent_idse asocia por correo. Si ningún agente tiene ese correo todavía, se crea un registro de agente nuevo, aunque ya exista un agente con el mismo nombre, de modo que la misma persona puede aparecer como dos agentes. - Escribir otro correo lo reemplaza en el registro del agente, para todas sus llamadas. Quien fue invitado con la dirección anterior pierde el acceso a ellas. Vea Administrar agentes.
- Vaciar el campo no lo elimina. Para retirar el acceso a un agente, elimínelo del equipo.
Enviar metadatos por la API
Sección titulada «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.