> ## 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 unidade

## Token de Acesso

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

<ParamField path="unityId" type="uuid">
  ID da unidade
</ParamField>

<ParamField body="filters" type="object" required>
  Filtros aplicados na consulta.

  <Expandable title="Filters properties">
    <ParamField body="search" type="string">
      Texto utilizado para busca.
    </ParamField>

    <ParamField body="operator" type="string">
      Operador do filtro de período (ex: all\_time).
    </ParamField>

    <ParamField body="date" type="string">
      Data específica usada no filtro.
    </ParamField>

    <ParamField body="startDate" type="string">
      Data inicial do intervalo de filtro.
    </ParamField>

    <ParamField body="endDate" type="string">
      Data final do intervalo de filtro.
    </ParamField>

    <ParamField body="nDays" type="number">
      Quantidade de dias considerada no filtro.
    </ParamField>
  </Expandable>
</ParamField>

<ParamField body="pagination" type="object">
  Configurações de paginação da consulta.

  <Expandable title="Pagination properties">
    <ParamField body="page" type="number" required>
      Número da página atual.
    </ParamField>

    <ParamField body="pageSize" type="number" required>
      Quantidade de itens por página.
    </ParamField>
  </Expandable>
</ParamField>

<ParamField body="orderBy" type="object">
  Configurações de ordenação dos resultados.

  <Expandable title="OrderBy properties">
    <ParamField body="column" type="string" required>
      Nome da coluna usada para ordenação.
    </ParamField>

    <ParamField body="direction" type="string" required>
      Direção da ordenação (ex: ASC ou DESC).
    </ParamField>
  </Expandable>
</ParamField>

## Descrição da Resposta

Abaixo você verá a descrição da resposta da requisição com todos os registro existentes na unidade

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

<ResponseField name="items" type="array" required>
  Lista de logs de chamadas retornados na busca.

  <Expandable title="Call log properties">
    <ResponseField name="message" type="string" required>
      Mensagem de retorno do log de chamada.
    </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 da chamada.
    </ResponseField>

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

    <ResponseField name="userRecordingUrl" type="string">
      URL da gravação 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 formatada da chamada.
    </ResponseField>

    <ResponseField name="costBreakdown" type="object">
      Detalhamento dos custos da chamada.
    </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 transcrições da chamada.
    </ResponseField>

    <ResponseField name="metadata" type="object">
      Metadados adicionais da chamada.
    </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>
  </Expandable>
</ResponseField>

<ResponseField name="pagination" type="object" required>
  Informações de paginação da busca.

  <Expandable title="Pagination properties">
    <ResponseField name="currentPage" type="number" required>
      Página atual da listagem.
    </ResponseField>

    <ResponseField name="hasNextPage" type="boolean" required>
      Indica se existe próxima página.
    </ResponseField>

    <ResponseField name="hasPreviousPage" type="boolean" required>
      Indica se existe página anterior.
    </ResponseField>

    <ResponseField name="pageSize" type="number" required>
      Quantidade de itens por página.
    </ResponseField>

    <ResponseField name="totalItems" type="number" required>
      Total de itens encontrados.
    </ResponseField>

    <ResponseField name="totalPages" type="number" required>
      Total de páginas disponíveis.
    </ResponseField>
  </Expandable>
</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.