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

# Calls

> Review your WhatsApp voice call history — who called, when, and who handled it.

## What is this?

**Calls** (beta) shows the history of WhatsApp voice calls for your active channel — inbound and outbound, missed and attended — so you can review who called, when, how long the call lasted, and who on your team handled it.

\[SCREENSHOT: calls-history — Full WhatsApp Calls page showing the status tiles (Total Calls, Missed Calls, Attended Calls) and the call history table]

<Info>
  Calls carries a **beta** badge in the sidebar and requires both a permission (`inbox:view`) and a plan that includes WhatsApp Calling. If either is missing, you won't see this page, or you'll see an upgrade prompt instead of call history.
</Info>

## What can I do here?

* View the call history table for the active WhatsApp channel, with **Contact**, **Direction**, **Status**, **Duration**, **Time**, and **Handled By** columns.
* See summary counts: **Total Calls** (all inbound and outbound call records), **Missed Calls** (calls that ended before being answered), **Attended Calls** (answered conversations with duration).
* Filter calls using the tiles or the **All / Missed / Attended / Incoming / Outgoing** filter buttons.
* Search by contact, phone number, direction, or handler using the search box.
* Click **Refresh** to reload call history.
* The list updates automatically in real time as calls happen (live call status and call-ended events refresh the table).

\[NEEDS VERIFICATION] No controls to place an outbound call or configure WhatsApp Calling settings were found on this page — it is a read-only call history/log view in the current Nova code.

## How to use it

1. Go to **WhatsApp** → **Calls**.

2. Review the status tiles at the top for a quick summary of total, missed, and attended calls.

   \[SCREENSHOT: calls-status-tiles — Close-up of the Total Calls, Missed Calls, and Attended Calls tiles]

3. Use the filter buttons (**All**, **Missed**, **Attended**, **Incoming**, **Outgoing**) to narrow the list to a specific type of call.

4. Use the search box to find calls by contact name, phone number, direction, or the teammate who handled the call.

5. Scan the table for call details:

   * The **Status** column shows **Missed** or **Attended** as a colored pill.
   * The **Duration** column shows call length (e.g. `2:15`), or **Missed** if the call was never answered.
   * The **Handled By** column shows which teammate attended the call, or **Unknown** if unattended.

   \[SCREENSHOT: calls-table-row — Close-up of a single call row showing the contact, direction icon, status pill, duration, time, and handled-by columns]

6. Click **Refresh** at any time to pull the latest call records.

<Info>
  If your active channel isn't a connected WhatsApp channel, or your plan doesn't include WhatsApp Calling, you'll see a setup or upgrade prompt (with a **View Plans** link) instead of the call history table.
</Info>