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

# Call logs

> Find past calls, listen to the recording, read the summary and transcript, and place a new call from the dialer.

Every call a voice agent handles lands on the **Calls** page. The list sits on the left, the call
you've selected on the right. It's where you go to find out what an agent actually said.

<Frame caption="The Call Logs list and filters">
  <img src="https://mintcdn.com/haconsultancy/8RjuZKhX-P1FqHZb/images/voice-agents/call-logs.png?fit=max&auto=format&n=8RjuZKhX-P1FqHZb&q=85&s=9b59fd6b5fa1b985ef94a92679507f86" alt="The Call Logs list with status, direction and assistant filters" width="2880" height="1800" data-path="images/voice-agents/call-logs.png" />
</Frame>

## The list

Calls appear newest first and keep loading as you scroll. On a wide screen the first call is
selected for you; on a narrow one you get the list alone, with a **Calls** link to get back from a
call you opened.

### Filters

| Filter       | Options                                                                   |
| ------------ | ------------------------------------------------------------------------- |
| Phone search | Type a number into **Search by phone number**. It filters as you type.    |
| Status       | **All status**, **Completed**, **Failed**, **No answer**, **In progress** |
| Direction    | **All directions**, **Inbound**, **Outbound**                             |
| Assistant    | **All assistants**, or one voice agent by name                            |

A **Clear** button appears once any filter is set. If nothing matches, the list says so — which is
different from having no calls at all.

<Tip>
  Filtering by **No answer** on an outbound agent is the fastest way to see whether your calling
  window is wrong. Filtering by **Failed** tells you something is broken rather than unpopular.
</Tip>

## The call detail pane

The pane reads top to bottom:

1. **The header** — the phone number, then the direction and the local date and time, then
   **Agent ·** the voice agent that handled it, and a status pill. Completed calls are tinted with
   your brand colour; **Failed** and **No answer** are red; anything still running is amber.
2. **The stat strip** — **Direction**, **Duration** and **Date**.
3. **Recording** — an audio player you can scrub through. It reads "Loading recording…" while it
   fetches, and "Recording unavailable." if it can't be played. The whole card is missing when
   there's no recording — recording is off by default, and you turn it on with **Record calls** in
   [Advanced settings](/voice-agents/voices-and-tuning).
4. **✦ Summary** — a short written account of what happened on the call, produced automatically.
   Read this first; open the transcript only when the summary raises a question.
5. **Variables** — the structured fields your agent was told to extract, listed as label and value.
   You define these in **Post-call data schema** on the
   [agent editor](/voice-agents/creating-a-voice-agent).
6. **Evaluation** — how the call scored, when **Run post-call evaluation** is switched on for that
   agent.
7. **Conversation** — the full transcript, turn by turn.

If a call has been removed you'll see "This call is no longer available." Any other problem shows
the error with a **Retry** button.

<Note>
  **Variables** and **Evaluation** only appear when the agent was configured to produce them. An
  agent with an empty post-call schema gives you a summary and a transcript and nothing else.
</Note>

## Placing a call

The **Place a call** button at the top of the list opens the dialer — "Dial out with a voice
agent."

<Steps>
  <Step title="Pick an Agent">
    Choosing one pre-fills exactly the variables that agent declares, so you only have to supply
    the values.
  </Step>

  <Step title="Enter the Phone number">
    In full international form, for example `+14155550100`. It needs at least seven digits.
  </Step>

  <Step title="Fill in the variables">
    Click **Variables (optional)** to expand the list. These are what the agent knows before it
    dials — a customer name, an order reference, an appointment time. Click **Hide variables** to
    collapse it again.
  </Step>

  <Step title="Click Call">
    The button shows **Calling…**, then confirms that the number is being called and that you can
    close the dialog. Click **Done**. The call appears in the list as it progresses.
  </Step>
</Steps>

You can also reach the dialer from the **Test call** button in the voice agent editor — it opens
with that agent already selected, which is the quickest way to hear a change you just saved.

### If the call won't go through

| Message                                                                 | What it means                                                                                               |
| ----------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------- |
| "Agent is still configuring in the background — try again in a moment." | The agent was saved seconds ago and isn't ready yet. Wait and retry.                                        |
| "A phone number is required to place this call."                        | No number was entered, or the contact has none on file.                                                     |
| "This conversation's channel can't be dialed."                          | You started the dialer from a conversation that isn't on a channel that can be called.                      |
| "This call could not be placed."                                        | Something else went wrong. Check your [credit balance](/billing/running-low-and-running-out) and try again. |

When you open the dialer from inside a conversation, the phone number is filled in for you and
can't be edited — it comes from the contact.

<Warning>
  Outbound calls cost credits by the minute, and a call that connects to an answering machine still
  costs. See [How credits are spent](/billing/how-credits-are-spent).
</Warning>

## Next steps

<CardGroup cols={2}>
  <Card title="Voices and tuning" icon="sliders" href="/voice-agents/voices-and-tuning">
    Fix what you heard in the recording.
  </Card>

  <Card title="Automations" icon="bolt" href="/automations/overview">
    Trigger outbound calls without opening the dialer.
  </Card>
</CardGroup>
