***

title: Conversation Logs
sidebarTitle: Conversation Logs
description: Review transcripts and debug agent behavior.
---------------------------------------------------------

Conversation Logs are your window into every call. See exactly what was said, when events occurred, and how metrics were captured — everything you need to understand and improve your agent.

**Location:** Top right → **Convo Logs** button

***

## Call Logs List

<Frame caption="Call Logs landing page">
  ![Call logs list](https://files.buildwithfern.com/smallest-ai.docs.buildwithfern.com/732baf5ae41ac79de668af298d2c2150d76cabea94c3586762ff40ccb4f6b5b7/products/atoms/pages/platform/building-agents/images/convo-logs-list.png)
</Frame>

The main view shows all calls with key information at a glance:

| Column           | Description                       |
| ---------------- | --------------------------------- |
| **Call Date**    | When the call occurred            |
| **Call ID**      | Unique identifier (click to copy) |
| **From / To**    | Phone numbers or sources          |
| **Duration**     | How long the call lasted          |
| **Hangup Cause** | Why the call ended                |
| **Status**       | Current state of the call         |
| **Retries**      | Number of retry attempts          |
| **Details**      | Click to view full conversation   |

***

## Filtering

Click **Filter By** to narrow down your logs:

| Filter                | Options                                                                                     |
| --------------------- | ------------------------------------------------------------------------------------------- |
| **Conversation Type** | Inbound Calls, Outbound Calls, Web Calls, Chat                                              |
| **Status**            | Pending, In Queue, In Progress, Active, Completed, Failed, Cancelled, No Answer, Processing |
| **End Reason**        | Dial No Answer, User Hangup, Agent Hangup, Busy, Timeout, Error, Voicemail                  |
| **Call Type**         | All Attempts, Retry Attempts, Initial Attempts                                              |
| **Call Duration**     | 0-30 seconds, 30-60 seconds, 1-5 minutes, 5+ minutes                                        |

Use **Search Logs** to find specific calls by ID or content.

***

## Call Details

Click **Details** on any call to open the full conversation view. You'll see tabs for different types of information:

<Tabs>
  <Tab title="Overview">
    <Frame caption="Overview tab">
      ![Overview tab](https://files.buildwithfern.com/smallest-ai.docs.buildwithfern.com/b9b5d6bcfb08d19d56580ca7d08c862759d1205cb1562f5770eb0d7d19209007/products/atoms/pages/platform/building-agents/images/convo-logs-overview.png)
    </Frame>

    High-level summary of the call:

    | Field                    | Description                           |
    | ------------------------ | ------------------------------------- |
    | **Call Summary**         | AI-generated summary of what happened |
    | **Agent**                | Which agent handled the call          |
    | **Call ID**              | Unique identifier                     |
    | **Model**                | AI model used                         |
    | **Voice**                | Voice used                            |
    | **Date & Time**          | When the call occurred                |
    | **Cost (Credits)**       | Credit usage                          |
    | **Disconnection Reason** | Why the call ended                    |

    Play the audio recording using the waveform player at the top.
  </Tab>

  <Tab title="Transcript">
    <Frame caption="Transcript tab">
      ![Transcript tab](https://files.buildwithfern.com/smallest-ai.docs.buildwithfern.com/16e6aa28d041792233af04ba05742a27a91113936be0fb46d49d6520536cedff/products/atoms/pages/platform/building-agents/images/convo-logs-transcript.png)
    </Frame>

    The full conversation, word for word. Each message shows:

    * Who spoke (Agent or User)
    * What was said
    * Timestamp

    Use this to understand exactly how the conversation flowed.
  </Tab>

  <Tab title="Events">
    <Frame caption="Events tab">
      ![Events tab](https://files.buildwithfern.com/smallest-ai.docs.buildwithfern.com/094fe705c4a5755ea521646c874bbb102f3079ce2ed71ae00b6ac8aa04a8d957/products/atoms/pages/platform/building-agents/images/convo-logs-events.png)
    </Frame>

    Timeline of everything that happened:

    * Agent responses
    * Call End triggers
    * Transfers
    * API calls
    * Other system events

    Each event shows the timestamp and what occurred.
  </Tab>

  <Tab title="Metrics">
    <Frame caption="Metrics tab">
      ![Metrics tab](https://files.buildwithfern.com/smallest-ai.docs.buildwithfern.com/811741bc9ac5760fa5e645ecb8e55c103ed55207896c79fca515fa0f36921840/products/atoms/pages/platform/building-agents/images/convo-logs-metrics.png)
    </Frame>

    Post-call metrics you've configured, with their values:

    Each metric shows:

    * Name
    * Data type (Integer, String, Boolean, etc.)
    * Value extracted from this call

    Click the dropdown on any metric to see details.
  </Tab>
</Tabs>

***

## Exporting

Click the **Export** button to download your logs:

| Format   | Best for                          |
| -------- | --------------------------------- |
| **JSON** | Developers, programmatic analysis |
| **CSV**  | Spreadsheets, reporting           |

***

## Related

<CardGroup cols={2}>
  <Card title="Post-Call Metrics" icon="chart-bar" href="/atoms/atoms-platform/features/post-call-metrics">
    Define what to track from each call
  </Card>

  <Card title="Testing" icon="flask" href="/atoms/atoms-platform/analytics-and-logs/testing">
    Test your agent
  </Card>
</CardGroup>