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

# How to Use CloudTalk with Plecto

> Integrate call history with your Plecto: Business dashboard

> [!NOTE]
>
> Here is an overview of setting up a data integration with Plecto: Business, and which data can be synchronized.

**User level**: Admin

***

## Plecto: Business + CloudTalk

### What is Plecto?

Plecto is a business performance platform which tracks various performance metrics in the form of visually illustrative dashboards. By integrating your CloudTalk call data into Plecto, you can make the most out of your data with Plecto’s visualization tools.

### Data Integration Setup

1. To start your integration flow, follow this link:

   [https://app.plecto.com/admin/data-sources/add/cloudtalk/new/](https://app.plecto.com/admin/data-sources/add/cloudtalk/new/)

2. In a separate browser tab, log in to your CloudTalk dashboard and navigate to **Settings > API Keys** and click **`+Add API Key`**.

   1. Under **Key** for the key-pair you just generated, select **show**. You will need to copy the API `ID` and `Key` values in the next step.

      ![](https://mintcdn.com/cloudtalk/xe2f6HmqhdjOgyCe/images/help-center/articles/9173595/64f0952007cc-screenshot-2024-04-10-at-11-45-33.png?fit=max\&auto=format\&n=xe2f6HmqhdjOgyCe\&q=85\&s=a229d9343f9ac88c23c38cd2e5fcf794)

3. In the *Configure data* flow within your Plecto browser tab, you will copy/paste the CloudTalk API `ID` into the **Username** field with the API `Key` as the **Password**.

   ![](https://mintcdn.com/cloudtalk/xe2f6HmqhdjOgyCe/images/help-center/articles/9173595/29de423bd273-id-key-plecto.png?fit=max\&auto=format\&n=xe2f6HmqhdjOgyCe\&q=85\&s=4839de808af65f3eb012f048d53b5daa)

4. Select to import **Inbound**, **Outbound**, or **Inbound Outbound and Internal** call history.

   1. CloudTalk calls will be sorted into these three categories in Plecto.

5. Keep checked the data types you want imported. Choose how you want data from CloudTalk to be mapped to Plecto fields such as **Default date** and **Employee**.

   ![](https://mintcdn.com/cloudtalk/xe2f6HmqhdjOgyCe/images/help-center/articles/9173595/0d6a2340376b-screenshot-2024-01-11-at-11-25-05.png?fit=max\&auto=format\&n=xe2f6HmqhdjOgyCe\&q=85\&s=c0cd269ecabeec2b5b1b0ca32696702e)

6. Set your **Import from** date and select a **Retention period** to finish the flow.

   1. The **Import from** date should be in the format `YYYY-MM-DD`.

   2. The **Retention period** is how long you want Plecto to store your CloudTalk data.

      ![](https://mintcdn.com/cloudtalk/xe2f6HmqhdjOgyCe/images/help-center/articles/9173595/b3816f74e9fd-screenshot-2024-04-10-at-11-55-12.png?fit=max\&auto=format\&n=xe2f6HmqhdjOgyCe\&q=85\&s=4769a7f94c13d147fb887327b8bdd496)

> [!WARNING]
>
> **If you're experiencing problems** with this integration, please contact representatives from Plecto.

### Call Categories

Calls can be found within **Data management > Data sources >** *CloudTalk*. Depending on what call history categories you chose during configuration, calls will be separated in up to three categories:

* **Inbound**

  * Voicemails are denoted as an inbound call when **Is voicemail** is set to `True`.

* **Outbound**

* **Inbound, Outbound and Internal** (all calls)

![](https://mintcdn.com/cloudtalk/xe2f6HmqhdjOgyCe/images/help-center/articles/9173595/77e5b6152d24-inbound-outbound-external-call-list.png?fit=max\&auto=format\&n=xe2f6HmqhdjOgyCe\&q=85\&s=a2dd88039b0cddd5c9e1ed654f32e694)

### Collected Data

Plecto gathers information about CloudTalk calls using CloudTalk’s API. You can edit the update frequency of your data synchronization within **Data management > Data Sources >** *CloudTalk* \{call category} > **Settings**.

![](https://mintcdn.com/cloudtalk/xe2f6HmqhdjOgyCe/images/help-center/articles/9173595/3d7e6a31ea07-call-detail-example-plecto.png?fit=max\&auto=format\&n=xe2f6HmqhdjOgyCe\&q=85\&s=b49b1041eafa99d5ac6671749714b77e)

#### Call Data

The following call data attributes are collected:

* **Wrap-up time**

* **Waiting time**

* **Talking time**

* **User ID**

* **Direction** (e.g., “Inbound”)

* **Started at**

* **Is voicemail**

* **Is redirected**

* **Call ID**

* **Ended at**

* **Answered at**

* **Internal name** (of the phone number)

* **Country code** (of the internal phone number)

* **Area code** (of the internal phone number)

* **Price**

* **Agent status** (of agent on the call)

  * If unknown, “none” in Plecto

* **Agent role** (of agent on the call)

  * If unknown, “none” in Plecto

* **Agent ID** (of agent on the call)

  * If unknown, “none” in Plecto

* **Agent name** (of agent on the call)

  * If unknown, “none” in Plecto

#### Contact Data

The following contact data attributes are collected:

* **Type**

* **Title**

* **Name**

* **Industry**

* **ID**

* **Favorite agent ID**

* **Favorite agent name**

* **Favorite agent status** during the call

* **Company**

***

*Need help or have a question?* Just reach out through our [Support portal](https://support.cloudtalk.io/hc/en-us/requests/new?ticket_form_id=26305535257884) — we’re here for you.


## Related topics

- [How to Use WhatsApp with CloudTalk](https://help.cloudtalk.io/en/articles/6811232-how-to-use-whatsapp-with-cloudtalk.md)
- [How to Use CSipSimple with CloudTalk](https://help.cloudtalk.io/en/articles/5373598-how-to-use-csipsimple-with-cloudtalk.md)
- [How to Paginate CloudTalk API Collection Responses](https://help.cloudtalk.io/guides/pagination.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.