Signals

Un Signal convierte conversaciones grabadas en una tabla. Describes quién participa, qué tipos de conversación esperar y qué quieres saber; Tavnit transcribe el audio, identifica quién dijo qué, separa la grabación en conversaciones distintas y llena tus columnas turno por turno.

El Signal es la configuración. Cada archivo de audio que pasas por él produce un Wave: una ejecución con su propia transcripción, reproductor y tabla de resultados. La grabación de todo un turno en una tienda puede contener decenas de conversaciones de venta; un Wave encuentra cada una y la estructura por separado.

• Verificar si los vendedores mencionan una promoción y qué productos preguntan los clientes
• Evaluar llamadas de soporte o de admisión contra un checklist de cosas que deberían ocurrir
• Convertir entrevistas en filas que puedes filtrar, graficar y guardar en un Bucket

Solo se requieren un nombre y al menos un tipo de miembro. Todo lo demás es opcional y agrega columnas o filtros al resultado.

Las descripciones importan: la IA las lee para decidir quién es quién y cuándo aplica una regla o una categoría. Los nombres deben ser únicos dentro de cada lista y no pueden repetir el nombre de una columna integrada.

1. 1Abre “Signals” en la barra lateral y haz clic en “Crear Signal”.
2. 2Elige cómo empezar: “Preset de conversación” (una base de ventas, soporte o entrevista), “Desde un signal existente” (duplica toda su configuración) o “Desde cero”.
3. 3Escribe el Nombre del Signal (mínimo 3 caracteres) y define al menos un tipo de miembro.
4. 4Si quieres, agrega tipos de interacción, reglas, campos de extracción y categorías de contenido por turno, y luego reglas y grupos de categorías a nivel de conversación.
5. 5En Opciones, decide si excluir las interacciones sin coincidencia, agregar una columna Wave ID o enviar los resultados a un webhook.
6. 6Haz clic en “Crear Signal”. Los grabadores, la exportación a Bucket y el ID del Signal para la API se configuran en la página del Signal una vez creado.

Para cambiar la configuración más adelante, abre el Signal y haz clic en “Editar” en cualquier sección de configuración, y luego en “Guardar”. Los cambios aplican a los Waves nuevos; cada Wave conserva una copia de la configuración con la que se ejecutó.

1. 1Haz clic en “Ejecutar Wave” en la página del Signal (o en la lista de Signals, y luego selecciona el Signal).
2. 2En “Subir Audio”, elige la grabación.
3. 3El Wave queda en cola y se procesa en segundo plano. Su página se actualiza automáticamente.

Los silencios largos se recortan antes de cualquier procesamiento, así que una grabación de un turno completo con largos ratos en silencio no es problema. El idioma hablado se detecta automáticamente. Un Signal desactivado no puede ejecutar Waves hasta que lo actives de nuevo.

Un Wave pasa de En cola a En ejecución(“Estructurando audio…”) y termina como Completado o Fallido. Todos los Waves de un Signal aparecen en su sección “Waves”, con un filtro por estado.

Un Wave completado muestra la duración (y cuánto fue voz), el número de interacciones (y cuántas se excluyeron) y los turnos.

• Audio: un reproductor de la grabación, con “Descargar original”.
• Conversación: la transcripción por hablante y tipo de miembro. Búscala, muestra “Solo extracciones”, usa “Reproducir desde aquí” en cualquier turno y “Exportar transcripción”.
• Interacciones: un perfil de cada conversación detectada: duración, turnos, el turno más largo, la participación de cada hablante y sus categorías, cada valor extraído (haz clic en uno para saltar a ese turno) y los veredictos a nivel de conversación. Las interacciones excluidas aparecen marcadas.
• Resultados: la tabla de resultados, filtrable por interacción, con “Exportar CSV”, “Exportar JSON” y “Exportar a bucket”.

La tabla de resultados siempre empieza con estas columnas, seguidas de tus campos de extracción y las columnas a nivel de conversación:

Los grabadores son miembros de la organización que capturan sesiones con la app Android Tavnit Recorder y las envían a un Signal, donde cada una se convierte automáticamente en un Wave.

1. 1Abre el Signal y ve a “Grabadores”.
2. 2Haz clic en “Agregar grabador” y elige el miembro.
3. 3Escribe un ID de referencia (un identificador libre, como un número de empleado, que se estampa en cada Wave que sube ese grabador) y elige el tipo de miembro con el que graba.

Un grabador puede estar Activo o Deshabilitado, editarse o quitarse. Al quitarlo se conservan los Waves que ya subió. Los Waves que llegan desde la app muestran cuándo se grabaron, el ID de referencia y el tipo de miembro.

Copia el ID desde “ID del Signal” en la página del Signal y envía el audio como multipart file (o como JSON con file_base64 y filename):

curl -X POST https://run.tavnit.io/api/signals/SIGNAL_ID/run \
  -H "X-API-Key: $TAVNIT_API_KEY" \
  -F "file=@call.mp3"

{
  "success": true,
  "wave_id": "…",
  "signal_id": "…",
  "status": "queued",
  "audio_seconds": 754,
  "message": "Wave queued for processing."
}

Errores: 400 si el archivo falta, está vacío, no es compatible o es demasiado largo; 402 si tu organización no puede iniciar trabajo nuevo en este momento (contacta al equipo de Tavnit); 403/404 si el Signal no está en tu organización. Sigue el Wave en la app. Consulta la página de la API REST para la autenticación.

Consulta Roles de usuario.