Buscar registro de chamada por ID

Endpoint para retornar os detalhes do registro da chamada

GET /api/v1/voice/call-logs/id/{callId}

Buscar registro de chamada por ID

cURL

curl --request GET \
  --url https://chat.api.toolzz.com.br/api/v1/voice/call-logs/id/{callId}

200

{
  "message": "<string>",
  "id": "<string>",
  "callId": "<string>",
  "callName": "<string>",
  "unityId": "<string>",
  "successEvaluation": true,
  "botId": "<string>",
  "audioFileUrl": "<string>",
  "agentRecordingUrl": "<string>",
  "userRecordingUrl": "<string>",
  "endCallType": "<string>",
  "callType": "<string>",
  "dateFormatted": "<string>",
  "costBreakdown": {
    "currency": "<string>",
    "fxRateUsdBrl": 123,
    "llmCompletionTokens": 123,
    "llmCost": 123,
    "llmPromptCachedTokens": 123,
    "llmPromptTokens": 123,
    "pricingVersion": "<string>",
    "sttAudioDurationMs": 123,
    "sttCost": 123,
    "total": 123,
    "totalCost": 123,
    "ttsCharactersCount": 123,
    "ttsCost": 123
  },
  "duration": 123,
  "phone": "<string>",
  "callDate": "<string>",
  "dataStructure": {},
  "durationFormatted": "<string>",
  "transcription": [
    {
      "content": "<string>",
      "createdAt": 123,
      "id": "<string>",
      "interrupted": true,
      "role": "<string>",
      "type": "<string>"
    }
  ],
  "metadata": {
    "bot": {
      "id": "<string>",
      "name": "<string>"
    },
    "callTime": "<string>",
    "environment": "<string>",
    "institution": {
      "id": "<string>"
    },
    "unit": {
      "id": "<string>",
      "name": "<string>"
    }
  },
  "callTime": "<string>",
  "totalCost": 123,
  "summary": "<string>",
  "createdAt": "<string>",
  "updatedAt": "<string>"
}

Token de Acesso

Authorization · string

Token de acesso (“Bearer” deve estar antes do token)

Parâmetros

callId · string

ID do registro da chamada

Descrição da Resposta

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

message · string · required

Mensagem de retorno da operação.

id · string · required

Identificador único do log de chamada.

callId · string · required

Identificador da chamada.

callName · string · required

Nome da chamada.

unityId · string · required

Identificador da unidade associada.

successEvaluation · boolean · required

Indica se a avaliação de sucesso da chamada foi positiva.

botId · string · required

Identificador do bot associado à chamada.

audioFileUrl · string

URL do arquivo de áudio completo da chamada.

agentRecordingUrl · string

URL da gravação de áudio do agente.

userRecordingUrl · string

URL da gravação de áudio do usuário.

endCallType · string · required

Tipo de encerramento da chamada.

callType · string · required

Tipo da chamada, como WEB ou PHONE.

dateFormatted · string

Data da chamada formatada.

costBreakdown · object

Detalhamento dos custos da chamada.

Show Cost breakdown properties

currency · string · required

Moeda utilizada no cálculo dos custos.

fxRateUsdBrl · number

Taxa de conversão de USD para BRL utilizada no cálculo.

llmCompletionTokens · number

Quantidade de tokens de resposta consumidos pelo modelo.

llmCost · number

Custo referente ao uso do modelo de linguagem.

llmPromptCachedTokens · number

Quantidade de tokens de prompt reutilizados em cache.

llmPromptTokens · number

Quantidade de tokens de prompt enviados ao modelo.

pricingVersion · string

Versão da tabela de preços utilizada.

sttAudioDurationMs · number

Duração do áudio processado pelo speech-to-text em milissegundos.

sttCost · number

Custo referente ao processamento de speech-to-text.

total · number · required

Valor total calculado para a chamada.

totalCost · number · required

Custo total final da chamada.

ttsCharactersCount · number

Quantidade de caracteres processados no text-to-speech.

ttsCost · number

Custo referente ao processamento de text-to-speech.

duration · number · required

Duração da chamada em segundos.

phone · string

Telefone associado à chamada.

callDate · string · required

Data e hora da chamada.

dataStructure · object

Estrutura de dados adicional da chamada.

durationFormatted · string · required

Duração da chamada formatada.

transcription · array

Lista de mensagens transcritas da chamada.

Show Transcription properties

content · string · required

Conteúdo da mensagem transcrita.

createdAt · number · required

Data e hora de criação da mensagem em timestamp.

id · string · required

Identificador único do item da transcrição.

interrupted · boolean · required

Indica se a mensagem foi interrompida.

role · string · required

Papel de quem enviou a mensagem, como assistant ou user.

type · string · required

Tipo do item da transcrição.

metadata · object

Metadados adicionais da chamada.

Show Metadata properties

bot · object

Informações do bot associado.

Show Bot properties

id · string · required

Identificador do bot.

name · string · required

Nome do bot.

callTime · string

Horário da chamada.

environment · string

Ambiente em que a chamada foi executada.

institution · object

Informações da instituição associada.

Show Institution properties

id · string · required

Identificador da instituição.

unit · object

Informações da unidade associada.

Show Unit properties

id · string · required

Identificador da unidade.

name · string · required

Nome da unidade.

callTime · string · required

Horário da chamada.

totalCost · number · required

Custo total da chamada.

summary · string

Resumo da chamada.

createdAt · string · required

Data e hora de criação do registro.

updatedAt · string

Data e hora da última atualização do registro.

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.