Pular para conteúdo

Listar Gravações e Transcrições de uma Chamada

O endpoint /api/calls/{id}/recordings permite listar as gravações de uma chamada utilizando seu Token de API.

Requisição

Lista as gravações de uma chamada específica do projeto.

Cabeçalhos:

{
  "Authorization": "Bearer {API_TOKEN}"
}

Parâmetros de consulta

  • page: (number) página de paginação. Padrão: 1
  • limit: (number) Quantidade de itens a serem retornados (10-100). Padrão: 10

Exemplos de Implementação

curl -X GET "https://api.videochamada.com.br/api/calls/{id}/recordings?page=1&limit=20" \
  -H "Authorization: Bearer {API_TOKEN}"

import requests

response = requests.get(
    "https://api.videochamada.com.br/api/calls/{id}/recordings",
    headers={"Authorization": "Bearer {API_TOKEN}"},
    params={"page": 1, "limit": 20}
)

const response = await fetch('https://api.videochamada.com.br/api/calls/{id}/recordings?page=1&limit=20', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer {API_TOKEN}'
  }
});

var client = new HttpClient();
client.DefaultRequestHeaders.Add("Authorization", "Bearer {API_TOKEN}");
var response = await client.GetAsync("https://api.videochamada.com.br/api/calls/{id}/recordings?page=1&limit=20");

Resposta

Exemplo de Resposta:

{
  "data": [
    {
      "id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
      "created": "2025-06-11T10:30:00Z",
      "url": "https://neft-asset.s3.sa-east-1.amazonaws.com/recordings/abc123.webm",
      "sessionId": "session_xyz789",
      "fileType": "webm",
      "duration": 1800,
      "username": "João Silva",
      "transcription": "Texto da transcrição completa...",
      "summary": "Resumo da conversa gerado por IA..."
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 5,
    "totalPages": 1
  }
}

Explicação dos Campos:

Objeto de Gravação:

  • id: Identificador único do arquivo de gravação (UUID)
  • created: Data e hora de criação da gravação (ISO 8601)
  • url: URL para download do arquivo de gravação no S3
  • sessionId: Identificador da sessão do participante que fez a gravação
  • fileType: Formato do arquivo (ex: "webm", "mp4")
  • duration: Duração da gravação em segundos (opcional)
  • username: Nome do participante que fez a gravação (opcional)
  • transcription: Texto da transcrição, se disponível (opcional)
  • summary: Resumo gerado por IA, se disponível (opcional)

Objeto de Paginação:

  • page: Número da página atual
  • limit: Quantidade de itens por página
  • total: Total de gravações disponíveis
  • totalPages: Total de páginas

Boas Práticas

  • Paginação: Para grandes volumes de gravações, utilize os parâmetros de paginação para otimizar o desempenho.
  • Monitoramento de Status: Verifique o status das gravações antes de tentar baixá-las ou processá-las.
  • Limites: Respeite os limites de requisições por minuto definidos pela API.
  • Transcrições: Use o endpoint de transcrições quando precisar apenas de arquivos com texto transcrito, economizando banda e processamento.