# Extended call history

### Purpose

* Display call history
* Filter call history by groups or employees
* Export call history for a selected period to Excel
* Display the line through which the call was made

<figure><img src="https://835495363-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsZ8acWnNlSalIHQjMFu1%2Fuploads%2FIwo7yfTxTKtlxlHa1cLw%2Fimage-7.png?alt=media&#x26;token=ae7e0924-386a-4f96-a26e-3f84e90c53f4" alt=""><figcaption></figcaption></figure>

### Module setup

1. Install the module from the [Module management](https://docs.mikopbx.com/mikopbx/english/manual/modules/pbx-extension-modules) section.
2. Enable the module and go to its page.

<figure><img src="https://835495363-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsZ8acWnNlSalIHQjMFu1%2Fuploads%2F5GJtleY6jfMtNfdOc0Cd%2Fimage-8.png?alt=media&#x26;token=ee766a3a-500f-449e-bc23-f5aa16807388" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Once enabled, the module will create a new, optimized table in its own database and begin populating it based on the original call history table.

This new table allows for high-speed queries without overloading the original call history database.

This process takes some time—please wait until it completes.
{% endhint %}

### Licensing

To use the module, a license is required for the host where it will run.

You can purchase a license in our store.

The license key has the format **MIKOUPD-00000-00000-00000-00000** and must be activated in the **Marketplace** → **License Management section**.

### Using the module

Filter panel

<figure><img src="https://835495363-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsZ8acWnNlSalIHQjMFu1%2Fuploads%2FiagAmzHxjYhQPA4Rl2xJ%2Fimage-9.png?alt=media&#x26;token=a2c13e19-9627-43dc-9b07-ddf208278154" alt=""><figcaption></figcaption></figure>

* Allows you to set a date range for filtering
* Shows the total number of calls for the selected period
* Quick filter buttons: **Incoming**, **Missed**, and **Outgoing**
* The **Search** field allows manual entry of a phone number for filtering
* Export to Excel button downloads data matching the current filters
* Save button saves the current filter settings, restoring them next time you open the page

#### Additional filter

<figure><img src="https://835495363-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsZ8acWnNlSalIHQjMFu1%2Fuploads%2FdKu2QqmedgrxPDbpDXuL%2Fimage-10.png?alt=media&#x26;token=b1a9daf6-8e36-461c-9d32-c7c0a92bfd1b" alt=""><figcaption></figcaption></figure>

* Filter by employee groups (from the Phone Group Management module)
* Filter by specific employees

#### Call table

<figure><img src="https://835495363-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsZ8acWnNlSalIHQjMFu1%2Fuploads%2FW0MTdqoL2JKnK6YJDX5Y%2Fimage-11.png?alt=media&#x26;token=78513c8d-5c48-49bd-b802-bffe40ce250f" alt=""><figcaption></figcaption></figure>

Each **call row** provides general call details: direction, start time, caller, and callee.

Call status can be one of the following:

* **ok** – successful call
* **transfer** – forwarded call
* **missed** – unanswered incoming call
* **no answer** – unanswered outgoing call
* **client called back** – successful incoming call after a missed one
* **called back** – successful outgoing call to a client after a missed one
* **application** – call to a dialplan application or service number

Clicking a number in the **From** or **To** columns sets a filter in the **Search** field.

**Call Details** (**Transcript**) displays more detailed information:

* Who missed the call
* Who answered the call
* Link to listen or download the recording
* Ring time duration
* Talk time duration