Pular para conteúdo

Listar Transcrições de uma Chamada

O endpoint /recordings/{id}/transcriptions permite listar as transcrições de uma chamada específica.

Info

Nota importante: Este endpoint não requer autenticação. O parâmetro {id} se refere ao ID da chamada.

Requisição

Lista as transcrições de uma chamada específica.

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/recordings/{callId}/transcriptions?page=1&limit=20"

import requests

response = requests.get(
    "https://api.videochamada.com.br/recordings/{callId}/transcriptions",
    params={"page": 1, "limit": 20}
)
print(response.json())

const response = await fetch('https://api.videochamada.com.br/recordings/{callId}/transcriptions?page=1&limit=20', {
  method: 'GET'
});

const data = await response.json();
console.log(data);

var client = new HttpClient();
var response = await client.GetAsync("https://api.videochamada.com.br/recordings/{callId}/transcriptions?page=1&limit=20");
var content = await response.Content.ReadAsStringAsync();

Console.WriteLine(content);

Resposta

Exemplo de Resposta:

{
  "data": [
    {
      "id": "trans_123",
      "recordingId": "rec_456",
      "content": "Transcrição do áudio da chamada...",
      "language": "pt-BR",
      "confidence": 0.95,
      "created": "2025-06-11T10:45:00Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 3,
    "totalPages": 1
  }
}

Explicação dos Campos:

Objeto de Transcrição:

  • id: Identificador único da transcrição
  • recordingId: Identificador da gravação associada
  • content: Conteúdo completo da transcrição
  • language: Idioma detectado ou configurado para a transcrição
  • confidence: Nível de confiança da transcrição (0.0 a 1.0)
  • created: Data e hora de criação da transcrição

Objeto de Paginação:

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

Boas Práticas

  • Processamento Assíncrono: As transcrições podem levar algum tempo para serem processadas após o término da gravação. Implemente verificações periódicas se necessário.
  • Idiomas Suportados: Verifique a documentação para os idiomas suportados. O padrão é pt-BR.
  • Nível de Confiança: Use o campo confidence para avaliar a qualidade da transcrição e implementar validações quando necessário.