Grabaciones

Acceso a las grabaciones de videollamadas. Las grabaciones se almacenan en formato WebM y están disponibles después de la finalización de la llamada.

Endpoints

Método	Endpoint	Descripción	Rol Mínimo
`GET`	`/api/v1/calls/:call_id/recording`	Obtener grabación de una llamada	`attendant`

Obtener Grabación

Devuelve los metadatos y URL de descarga de la grabación de una llamada.

GET /api/v1/calls/:call_id/recording

Path Parameters

Parámetro	Tipo	Descripción
`call_id`	`uuid`	ID de la llamada

Ejemplo de Request

bash

curl -X GET https://voki.avanter.com.br/api/v1/calls/1a2b3c4d-5e6f-7890-abcd-ef1234567890/recording \
  -H "Authorization: Bearer eyJhbGci..." \
  -H "X-Tenant: avanter"

Respuesta Exitosa (200)

json

{
  "data": {
    "id": "r1a2b3c4-d5e6-7890-abcd-ef1234567890",
    "call_id": "1a2b3c4d-5e6f-7890-abcd-ef1234567890",
    "format": "webm",
    "duration": 345,
    "file_size": 15234567,
    "download_url": "/api/v1/calls/1a2b3c4d-5e6f-7890-abcd-ef1234567890/recording/download",
    "transcription": {
      "status": "completed",
      "text": "Texto transcrito da chamada...",
      "language": "pt-BR"
    },
    "created_at": "2026-02-15T14:36:00Z"
  }
}

Errores

Código	Descripción
`404`	Llamada no encontrada o sin grabación
`403`	Sin permiso para acceder a la grabación

json

{
  "errors": {
    "detail": "Gravação não encontrada"
  }
}

Notas Técnicas

Formato de Grabación

Las grabaciones se guardan en formato WebM (VP8/Opus) por el SFU nativo en Elixir/Rust. El archivo contiene:

Video: Todos los participantes en layout compuesto
Audio: Mezcla de todos los participantes

Transcripción

Si la transcripción está habilitada en las configuraciones de la empresa (transcription_enabled: true), el audio es procesado por el módulo voki_ai para generar transcripción automática vía Whisper.

Almacenamiento

Las grabaciones se almacenan localmente en el servidor
El tiempo de retención depende del plan contratado
Las grabaciones no pueden eliminarse individualmente (política de auditabilidad)

Política de Auditabilidad

Los departamentos que poseen llamadas con grabaciones no pueden eliminarse. Esto garantiza la trazabilidad y el cumplimiento normativo de las grabaciones.

Grabaciones ​

Endpoints ​

Obtener Grabación ​

Path Parameters ​

Ejemplo de Request ​

Respuesta Exitosa (200) ​

Errores ​

Notas Técnicas ​

Formato de Grabación ​

Transcripción ​

Almacenamiento ​