Carga masiva

La Carga masiva sirve para entregar muchas gestiones de una vez: un archivo ZIP con los tickets y sus grabaciones. La crea el Admin en Configuración › Conexiones › Carga masiva. Es una por workspace.

Resumen

Armás un ZIP con una de estas dos formas, lo subís desde Ver entregas y Sniff! lo procesa en segundo plano:

• JSON: manifest.json, una carpeta ticket_details/ con un JSON ticket/1.0 por ticket y una carpeta assets/ con grabaciones y adjuntos.
• CSV: tickets.csv y los audios sueltos al lado. Columnas id, fecha, asignado, audio y opcionales direccion, asunto, duracion, tags; el resto va a los campos del ticket.

Cada ticket tiene que traer todos sus datos. La carga masiva crea tickets nuevos: no actualiza ni borra los que ya se importaron. Un problema del inventario (un archivo que falta, un tamaño que no coincide) rechaza la entrega entera; un ticket inválido se rechaza solo y el resto se importa.

1. Conectar

1. En Configuración › Conexiones, en la tarjeta Carga masiva, hacé clic en Conectar.
2. Decidí si marcás Transcribir audios. Dejala sin marcar si tus tickets ya traen la conversación en texto (en comments), aunque también incluyas el audio. Marcala si entregás grabaciones sin transcripción.
3. Hacé clic en Guardar conexión.

Antes de la primera entrega, confirmá que los operadores de los tickets existan en Configuración › Usuarios: cada ticket tiene que venir asignado a un usuario del workspace que pueda ser evaluado (ver Usuarios y grupos).

2. Preparar los archivos

Formato JSON

Dentro del ZIP (en la raíz o dentro de una carpeta):

manifest.json
ticket_details/
  gestion-48213.json
  gestion-48214.json
assets/
  llamadas/gestion-48213.mp3
  adjuntos/gestion-48214-captura.png

• Un JSON por ticket, en ticket_details/ y con extensión .json.
• Los archivos (grabaciones y adjuntos) en assets/. Cada ticket los referencia por su ruta relativa, con / como separador; sin rutas absolutas, . ni ...
• manifest.json es el inventario completo: lista cada ticket y cada archivo con su tamaño exacto en bytes y su SHA-256. El manifiesto, el ticket y el formato CSV están descriptos campo por campo en Formato del ticket.

Formato CSV

Para quien no puede armar JSON. Un tickets.csv (separado por comas, punto y coma o tabulaciones, en UTF-8) con una fila por llamada y los audios en el mismo ZIP:

id,fecha,asignado,audio,direccion,duracion,cartera
gestion-48213,16/10/2026 13:40,ana.perez@agencianorte.com,gestion-48213.mp3,saliente,390,Tarjeta
gestion-48214,16/10/2026 14:02,ana.perez@agencianorte.com,gestion-48214.mp3,entrante,215,Préstamo

Sniff! calcula el tamaño y el SHA-256 de cada audio por vos. Las columnas que no son del formato (como cartera) van a los campos del ticket.

3. Validar

Antes de subir, revisá que:

• El manifiesto declare schema_version ticket-delivery/1.0 y mode create_only, y que counts coincida con las listas.
• Cada ticket referenciado en el manifiesto exista, con el mismo source_ticket_id, tamaño y SHA-256 que el JSON real. Reformatear un JSON después de calcular el SHA-256 lo cambia.
• Cada archivo listado esté en el ZIP y no haya archivos de más.
• Las referencias a archivos dentro de cada ticket (path, bytes, sha256, content_type) repitan exactamente lo que dice el manifiesto.
• Todo usuario referenciado por el ticket esté en su lista users, y el asignado tenga rol agent o admin y el mail de un usuario del workspace que pueda ser evaluado.
• Las grabaciones y adjuntos usen un tipo de medio admitido y no superen los tamaños de Archivos y límites.

En el CSV, confirmá que cada fila tenga id, fecha, asignado y audio, que el audio esté en el ZIP y que la fecha tenga una forma reconocible (16/10/2026 13:40, 16/10/2026 13:40:00 o ISO 8601; sin zona se toma como hora de Argentina).

4. Subir

1. En la tarjeta Carga masiva, hacé clic en Ver entregas.
2. En Archivo elegí el ZIP. En Id de la entrega podés poner un identificador propio; con el formato JSON se usa el delivery_id del manifiesto (si escribís otro, la subida se rechaza) y con CSV es opcional (si lo dejás vacío, Sniff! arma uno con el nombre del archivo y la fecha).
3. Hacé clic en Subir entrega.

La entrega aparece en la tabla Entregas como Recibida y pasa a Procesando; la tabla se actualiza sola mientras tanto. Al terminar queda Importada, Importada con rechazos o Rechazada, con los conteos de Tickets, Creados y Rechazados y la lista de errores. Qué significa cada resultado y cómo corregirlo: Problemas.

Un id de entrega no se puede repetir dentro de la conexión: para corregir tickets rechazados, armá una entrega nueva con otro id y sólo con esos tickets (podés mantener sus source_ticket_id, porque nunca se importaron).

También por API

El mismo ZIP se puede subir con el token de la conexión de API, sin pasar por la pantalla. Ver API › Entregas por API.