Gravações

Acesso às gravações de chamadas de vídeo. As gravações são armazenadas em formato WebM e ficam disponíveis após a conclusão da chamada.

Endpoints

Método	Endpoint	Descrição	Role Mínimo
GET	/api/v1/calls/:call_id/recording	Obter gravação de uma chamada	attendant

---

Obter Gravação

Retorna os metadados e URL de download da gravação de uma chamada.

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

Path Parameters

Parâmetro	Tipo	Descrição
call_id	uuid	ID da chamada

Exemplo de Request

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"

Resposta de Sucesso (200)

{
  "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"
  }
}

Erros

Código	Descrição
404	Chamada não encontrada ou sem gravação
403	Sem permissão para acessar a gravação

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

---

Notas Técnicas

Formato de Gravação

As gravações são salvas em formato WebM (VP8/Opus) pelo SFU nativo em Elixir/Rust. O arquivo contém:

• Vídeo: Todos os participantes em layout composto
• Áudio: Mix de todos os participantes

Transcrição

Se a transcrição estiver habilitada nas configurações da empresa (transcription_enabled: true), o áudio é processado pelo módulo voki_ai para gerar transcrição automática via Whisper.

Armazenamento

• Gravações são armazenadas localmente no servidor
• O tempo de retenção depende do plano contratado
• Gravações não podem ser excluídas individualmente (política de auditabilidade)

Política de Auditabilidade

Departamentos que possuem chamadas com gravações não podem ser excluídos. Isso garante a rastreabilidade e conformidade regulatória das gravações.