> ## Documentation Index
> Fetch the complete documentation index at: https://docs.toolzz.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Buscar registro de chamada por ID

> Endpoint para retornar os detalhes do registro da chamada

## Token de Acesso

<ParamField header="Authorization" type="string">
  Token de acesso ("Bearer" deve estar antes do token)
</ParamField>

## Parâmetros

<ParamField path="callId" type="string">
  ID do registro da chamada
</ParamField>

## Descrição da Resposta

Abaixo você encontra a resposta retornada após a busca de visualização dos detalhes do registro de chamada

<ResponseField name="message" type="string" required>
  Mensagem de retorno da operação.
</ResponseField>

<ResponseField name="id" type="string" required>
  Identificador único do log de chamada.
</ResponseField>

<ResponseField name="callId" type="string" required>
  Identificador da chamada.
</ResponseField>

<ResponseField name="callName" type="string" required>
  Nome da chamada.
</ResponseField>

<ResponseField name="unityId" type="string" required>
  Identificador da unidade associada.
</ResponseField>

<ResponseField name="successEvaluation" type="boolean" required>
  Indica se a avaliação de sucesso da chamada foi positiva.
</ResponseField>

<ResponseField name="botId" type="string" required>
  Identificador do bot associado à chamada.
</ResponseField>

<ResponseField name="audioFileUrl" type="string">
  URL do arquivo de áudio completo da chamada.
</ResponseField>

<ResponseField name="agentRecordingUrl" type="string">
  URL da gravação de áudio do agente.
</ResponseField>

<ResponseField name="userRecordingUrl" type="string">
  URL da gravação de áudio do usuário.
</ResponseField>

<ResponseField name="endCallType" type="string" required>
  Tipo de encerramento da chamada.
</ResponseField>

<ResponseField name="callType" type="string" required>
  Tipo da chamada, como `WEB` ou `PHONE`.
</ResponseField>

<ResponseField name="dateFormatted" type="string">
  Data da chamada formatada.
</ResponseField>

<ResponseField name="costBreakdown" type="object">
  Detalhamento dos custos da chamada.

  <Expandable title="Cost breakdown properties">
    <ResponseField name="currency" type="string" required>
      Moeda utilizada no cálculo dos custos.
    </ResponseField>

    <ResponseField name="fxRateUsdBrl" type="number">
      Taxa de conversão de USD para BRL utilizada no cálculo.
    </ResponseField>

    <ResponseField name="llmCompletionTokens" type="number">
      Quantidade de tokens de resposta consumidos pelo modelo.
    </ResponseField>

    <ResponseField name="llmCost" type="number">
      Custo referente ao uso do modelo de linguagem.
    </ResponseField>

    <ResponseField name="llmPromptCachedTokens" type="number">
      Quantidade de tokens de prompt reutilizados em cache.
    </ResponseField>

    <ResponseField name="llmPromptTokens" type="number">
      Quantidade de tokens de prompt enviados ao modelo.
    </ResponseField>

    <ResponseField name="pricingVersion" type="string">
      Versão da tabela de preços utilizada.
    </ResponseField>

    <ResponseField name="sttAudioDurationMs" type="number">
      Duração do áudio processado pelo speech-to-text em milissegundos.
    </ResponseField>

    <ResponseField name="sttCost" type="number">
      Custo referente ao processamento de speech-to-text.
    </ResponseField>

    <ResponseField name="total" type="number" required>
      Valor total calculado para a chamada.
    </ResponseField>

    <ResponseField name="totalCost" type="number" required>
      Custo total final da chamada.
    </ResponseField>

    <ResponseField name="ttsCharactersCount" type="number">
      Quantidade de caracteres processados no text-to-speech.
    </ResponseField>

    <ResponseField name="ttsCost" type="number">
      Custo referente ao processamento de text-to-speech.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="duration" type="number" required>
  Duração da chamada em segundos.
</ResponseField>

<ResponseField name="phone" type="string">
  Telefone associado à chamada.
</ResponseField>

<ResponseField name="callDate" type="string" required>
  Data e hora da chamada.
</ResponseField>

<ResponseField name="dataStructure" type="object">
  Estrutura de dados adicional da chamada.
</ResponseField>

<ResponseField name="durationFormatted" type="string" required>
  Duração da chamada formatada.
</ResponseField>

<ResponseField name="transcription" type="array">
  Lista de mensagens transcritas da chamada.

  <Expandable title="Transcription properties">
    <ResponseField name="content" type="string" required>
      Conteúdo da mensagem transcrita.
    </ResponseField>

    <ResponseField name="createdAt" type="number" required>
      Data e hora de criação da mensagem em timestamp.
    </ResponseField>

    <ResponseField name="id" type="string" required>
      Identificador único do item da transcrição.
    </ResponseField>

    <ResponseField name="interrupted" type="boolean" required>
      Indica se a mensagem foi interrompida.
    </ResponseField>

    <ResponseField name="role" type="string" required>
      Papel de quem enviou a mensagem, como `assistant` ou `user`.
    </ResponseField>

    <ResponseField name="type" type="string" required>
      Tipo do item da transcrição.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="metadata" type="object">
  Metadados adicionais da chamada.

  <Expandable title="Metadata properties">
    <ResponseField name="bot" type="object">
      Informações do bot associado.

      <Expandable title="Bot properties">
        <ResponseField name="id" type="string" required>
          Identificador do bot.
        </ResponseField>

        <ResponseField name="name" type="string" required>
          Nome do bot.
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="callTime" type="string">
      Horário da chamada.
    </ResponseField>

    <ResponseField name="environment" type="string">
      Ambiente em que a chamada foi executada.
    </ResponseField>

    <ResponseField name="institution" type="object">
      Informações da instituição associada.

      <Expandable title="Institution properties">
        <ResponseField name="id" type="string" required>
          Identificador da instituição.
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="unit" type="object">
      Informações da unidade associada.

      <Expandable title="Unit properties">
        <ResponseField name="id" type="string" required>
          Identificador da unidade.
        </ResponseField>

        <ResponseField name="name" type="string" required>
          Nome da unidade.
        </ResponseField>
      </Expandable>
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="callTime" type="string" required>
  Horário da chamada.
</ResponseField>

<ResponseField name="totalCost" type="number" required>
  Custo total da chamada.
</ResponseField>

<ResponseField name="summary" type="string">
  Resumo da chamada.
</ResponseField>

<ResponseField name="createdAt" type="string" required>
  Data e hora de criação do registro.
</ResponseField>

<ResponseField name="updatedAt" type="string">
  Data e hora da última atualização do registro.
</ResponseField>

## Segurança

Para acessar este endpoint, é necessário enviar um **token de acesso** válido através do cabeçalho de autorização (Authorization) da requisição. Além disso, a API é protegida por outras medidas de segurança para proteger os dados dos usuários.
