# Aircall
## Call integration with Aircall
Salescaling allows you to automatically import your calls made in Aircall, making it easier to manage and analyze your sales interactions. To use this integration, follow the steps and consider the requirements described below.
### How to get the API credentials in Aircall?
Before connecting Aircall with Salescaling, you need to obtain your **API ID** and **API Token** from the Aircall administration panel:
1. Log in to your [**Aircall Dashboard**](https://dashboard.aircall.io/).
2. Go to **Integrations and API** in the left side menu.
3. Click on the **API Keys**.
4. Click **Generate an API key** tab to create new credentials.
5. Give the key a descriptive name (for example, "Salescaling") and confirm the creation.
6. Copy the **API ID** and the **API Token** that are shown. **Important**: The API Token is shown only once, so make sure to store it in a safe place.
{% hint style="warning" %}
**Required permissions:** The user who generates the API keys must have the role of **Administrator** in Aircall. API keys inherit the permissions of the user who creates them, so it is recommended that it be an administrator with full access to calls and recordings.
{% endhint %}
### How to connect your Aircall account?
1. Log in to your **Salescaling**.
2. Go to the [**Integrations**](https://app.salescaling.com/settings/integrations) section in **Settings**.
3. Find the **Aircall** integration and click **Connect**. A window will open where you must enter your credentials:
* **API ID**: The identifier of your Aircall API key.
* **API Token**: The secret token of your API key.
Aircall connection form
4. Click **Save** to complete the connection.
### Which calls are imported from Aircall?
After connecting your account, Salescaling will automatically import Aircall calls that meet **all** of the following requirements:
* **Call date:** Only calls that were made in the **two previous weeks** prior to the time of import will be imported.
* **Matching user:** The call must have been made by an Aircall user whose **email matches** that of a paying user in Salescaling.
* **Recording available:** The call must have the **recording stored** in Aircall. If the call does not have a recording, it will not be imported.
* **File size:** Recordings cannot exceed **200 MB**.
### What information is synchronized?
For each imported call, Salescaling receives and processes the following information:
| Field | Description |
| ----------------------- | ------------------------------------------------------------- |
| **Identifier** | Unique ID of the call in Aircall |
| **Direction** | Whether the call is incoming (inbound) or outgoing (outbound) |
| **Status** | Call status (answered, missed, voicemail, failed) |
| **Start date and time** | Moment when the call began |
| **End date and time** | Moment when the call ended |
| **Duration** | Total duration of the call in seconds |
| **Recording** | Audio file of the call |
| **User** | Agent information (name and email) |
| **Contact** | External contact information (name and phone) |
| **Internal number** | Aircall number used |
| **External number** | External contact's number |
### Important notes
* **Sync frequency:** Once connected, the platform will check for new calls in Aircall every **15 minutes**. Therefore, a just-ended call may take a few minutes to appear in Salescaling.
* **User matching:** Make sure your team members in Aircall use the **same email address** as in Salescaling so that their calls are recognized and imported correctly.
* **Recordings required:** For a call to be imported, it must have recording enabled in Aircall. Configure recording policies in your Aircall account according to applicable regulations.
* **Initial limit:** On the first import, a maximum of **200 calls** will be imported to avoid overload. Subsequent synchronizations will import all new calls since the last import.
### Troubleshooting
My calls are not being imported
Check the following:
1. The user's email in Aircall exactly matches the email in Salescaling.
2. Calls have recording enabled in Aircall.
3. The API credentials are correct and have not expired.
4. The user who generated the API keys has administrator permissions.
Where do I find the API ID and API Token?
In the Aircall Dashboard, go to **Integrations and API** → **API Keys** → **Generate an API key**. Both values will be displayed. Remember that the API Token is shown only once at the moment of creation.
Can I regenerate the API credentials?
Yes, you can generate new API keys at any time from the Aircall Dashboard. If you do, remember to update the credentials in Salescaling so the integration continues to work.
If you have questions or need help, contact Salescaling support.
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://docs.salescaling.com/en/platform-settings/integraciones/conectar-plataformas-de-llamadas/aircall.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.