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

# Call history

The **Call History** screen gives you one-click access to every conversation handled by your AI agents. Quickly locate a call, export records for offline analysis, and drill-down into a full summary & transcript – all without leaving SquawkVoice Studio.

## Getting There

<Steps>
  <Step>In the left navigation expand **Optimize**.</Step>
  <Step>Select **Call History**.</Step>
</Steps>

## Search & Filters

<Columns cols={3}>
  <Card title="Search" icon="magnifying-glass">
    Query by **Caller ID**, **Agent name**, or **Call SID**. Typing fires a new server-side search and cancels the previous request so the table stays responsive.
  </Card>

  <Card title="Time Range" icon="calendar">
    Choose **Today**, **Last 7 Days**, or **Last 30 Days** to limit results.
  </Card>

  <Card title="Pinned Only" icon="bookmark">
    Switch on **Pinned only** when you want to focus on the calls you saved for later review.
  </Card>
</Columns>

## Table Reference

<ResponseField name="Caller ID" type="string">Identifier of the caller.</ResponseField>
<ResponseField name="Date & Time" type="timestamp">Call start time shown.</ResponseField>
<ResponseField name="Duration" type="duration">Total length (m s).</ResponseField>
<ResponseField name="Call Status" type="status">Completed, In Progress, or Missed. Color-coded for quick scanning.</ResponseField>
<ResponseField name="Agent" type="string">AI agent that handled the call.</ResponseField>
<ResponseField name="Call SID" type="string">Unique Call Identifier. Click the copy icon to copy to clipboard.</ResponseField>
<ResponseField name="Disposition" type="string">Outcome label (e.g. Hangup, Caller-Hungup).</ResponseField>
<ResponseField name="Actions" type="button">Click **View** to open the Call Details drawer.</ResponseField>

<Info>
  Click anywhere on a row to open the drawer. Pinned calls display a colored bar on the left edge so you can spot them quickly.
</Info>

### Infinite Scrolling

Scroll to the bottom of the list and older calls load automatically – no paging controls needed.

## Pin Calls for Easy Follow-up

<Steps>
  <Step>Hover any row and click the pin button on the left edge. You can also pin from inside the Call Details drawer.</Step>
  <Step>Toggle **Pinned only** beside the filters to review just the calls you saved.</Step>
</Steps>

<Info>
  Pins are personal to your user account within the current account; teammates manage their own pinned lists.
</Info>

### Export

Click **Export** to download all currently visible rows as a CSV file. The export respects any search or date filter that you have applied.

Once ready, exported files are available for download under **Manage → Data Exports**.

## Call Details Drawer

Selecting **View** opens a side drawer with two sections:

<Columns cols={2}>
  <Card title="Summary" icon="sparkles">AI-generated synopsis of the conversation.</Card>
  <Card title="Transcript" icon="file">Full chat-style transcript, clearly separating **AI** and **User** turns.  </Card>
</Columns>

Additional information such as call duration, status, and disposition is also shown at the top of the drawer.

## Advanced Transcript Viewer

The transcript viewer can show a richer, time-aligned view that combines messages with system actions executed during the call.

### Turn it on

1. Open a call in the Call Details drawer.
2. In the Transcript section, toggle "Advanced" on. When enabled, the app loads a merged transcript for that call.

### What you will see

* AI and User messages as separate bubbles, with precise elapsed time badges.
* System entries for actions that ran during the call, including:
  * Pre-Call actions (executed before the first utterance)
  * During-Call actions, flow API requests, and Transfer actions
  * Post-Call actions

System actions expand inline to show:

* Method and URL
* Request details: headers, query params, and body (when present)
* Response details: status, latency, and response body
* Updated variables written back to the interaction context

Hover over the elapsed time badge to see the absolute timestamp including milliseconds.

<Info>
  The merged transcript is fetched only when Advanced is toggled on. If no advanced data exists for a call, the viewer falls back to the regular transcript.
</Info>

### Tips

* Use Advanced mode to debug why an action was called and what data was returned.
* Collapse request sections you do not need to reduce visual noise.
* Sensitive values may be masked by your backend for security.

### Troubleshooting

* If Advanced shows no entries, logs may take a short time to appear. Wait a few seconds and try again.
* Some older calls may not include merged transcript data; in that case, the basic transcript will be shown.

## Tips & Best Practices

1. **Copy the Call SID** when you need to reference a specific call in support tickets.
2. **Apply filters first, then Export** to avoid large CSV files.
3. Use the **Call Details** summary to quickly understand whether the customer’s query was resolved.

## Related Pages

<Columns cols={2}>
  <Card title="Call Analytics" icon="bar-chart" href="/analyze/call-analytics">Deep-dive into aggregated performance metrics.</Card>
  <Card title="Prompt Templates" icon="file-text" href="/library/prompt-templates">Tweak prompts based on real conversations.</Card>
</Columns>