# Aircall

## Integración de llamadas con Aircall

Salescaling permite importar automáticamente tus llamadas realizadas en Aircall, facilitando la gestión y análisis de tus interacciones comerciales. Para aprovechar esta integración, sigue los pasos y ten en cuenta los requisitos descritos a continuación.

### ¿Cómo obtener las credenciales de API en Aircall?

Antes de conectar Aircall con Salescaling, necesitas obtener tu **API ID** y **API Token** desde el panel de administración de Aircall:

1. Inicia sesión en tu cuenta de [**Aircall Dashboard**](https://dashboard.aircall.io/).
2. Dirígete a **Integraciones y API** en el menú lateral izquierdo.
3. Haz clic en la pestaña **Claves API**.
4. Haz clic en **Generar una clave API** para crear nuevas credenciales.
5. Asigna un nombre descriptivo a la clave (por ejemplo, "Salescaling") y confirma la creación.
6. Copia el **API ID** y el **API Token** que se muestran. **Importante**: El API Token solo se muestra una vez, así que asegúrate de guardarlo en un lugar seguro.

{% hint style="warning" %}
**Permisos necesarios:** El usuario que genere las claves API debe tener rol de **Administrador** en Aircall. Las claves API heredan los permisos del usuario que las crea, por lo que se recomienda que sea un administrador con acceso completo a las llamadas y grabaciones.
{% endhint %}

### ¿Cómo conectar tu cuenta de Aircall?

1. Accede a tu cuenta de **Salescaling**.
2. Dirígete a la sección de [**Integrations**](https://app.salescaling.com/settings/integrations) en **Settings**.
3. Localiza la integración de **Aircall** y haz clic en **Connect**. Se abrirá una ventana donde deberás introducir tus credenciales:

   * **API ID**: El identificador de tu clave API de Aircall.
   * **API Token**: El token secreto de tu clave API.

   <figure><img src="/files/lYdjgx8LQLhu8f6Cnx8h" alt="" width="375"><figcaption><p>Formulario de conexión de Aircall</p></figcaption></figure>
4. Haz clic en **Save** para completar la conexión.

### ¿Qué llamadas se importan desde Aircall?

Después de conectar tu cuenta, Salescaling importará automáticamente las llamadas de Aircall que cumplan con **todos** los siguientes requisitos:

* **Fecha de la llamada:** Solo se importarán las llamadas que hayan sido efectuadas en las **dos semanas previas** al momento de la importación.
* **Usuario coincidente:** La llamada debe haber sido realizada por un usuario de Aircall cuyo **correo electrónico coincida** con el de un usuario de pago en Salescaling.
* **Grabación disponible:** La llamada debe tener la **grabación almacenada** en Aircall. Si la llamada no tiene grabación, no será importada.
* **Tamaño de archivo:** Las grabaciones no pueden exceder los **200 MB**.

### ¿Qué información se sincroniza?

Para cada llamada importada, Salescaling recibe y procesa la siguiente información:

| Campo                      | Descripción                                                       |
| -------------------------- | ----------------------------------------------------------------- |
| **Identificador**          | ID único de la llamada en Aircall                                 |
| **Dirección**              | Si la llamada es entrante (inbound) o saliente (outbound)         |
| **Estado**                 | Estado de la llamada (contestada, perdida, buzón de voz, fallida) |
| **Fecha y hora de inicio** | Momento en que comenzó la llamada                                 |
| **Fecha y hora de fin**    | Momento en que terminó la llamada                                 |
| **Duración**               | Duración total de la llamada en segundos                          |
| **Grabación**              | Archivo de audio de la llamada                                    |
| **Usuario**                | Información del agente (nombre y email)                           |
| **Contacto**               | Información del contacto externo (nombre y teléfono)              |
| **Número interno**         | Número de Aircall utilizado                                       |
| **Número externo**         | Número del contacto externo                                       |

### Notas importantes

* **Frecuencia de sincronización:** Una vez conectada, la plataforma revisará si hay nuevas llamadas en Aircall cada **15 minutos**. Por lo tanto, una llamada recién terminada puede tardar unos minutos en aparecer en Salescaling.
* **Coincidencia de usuarios:** Asegúrate de que los usuarios de tu equipo en Aircall utilicen el **mismo correo electrónico** que en Salescaling para que sus llamadas sean reconocidas e importadas correctamente.
* **Grabaciones obligatorias:** Para que una llamada sea importada, debe tener la grabación habilitada en Aircall. Configura las políticas de grabación en tu cuenta de Aircall según las regulaciones aplicables.
* **Límite inicial:** En la primera importación, se importarán un máximo de **200 llamadas** para evitar sobrecargas. Las siguientes sincronizaciones importarán todas las llamadas nuevas desde la última importación.

### Resolución de problemas

<details>

<summary>No se importan mis llamadas</summary>

Verifica lo siguiente:

1. El correo electrónico del usuario en Aircall coincide exactamente con el correo en Salescaling.
2. Las llamadas tienen grabación habilitada en Aircall.
3. Las credenciales API son correctas y no han expirado.
4. El usuario que generó las claves API tiene permisos de administrador.

</details>

<details>

<summary>¿Dónde encuentro el API ID y API Token?</summary>

En el Dashboard de Aircall, ve a **Integraciones y API** → **Claves API** → **Generar una clave API**. Se mostrarán ambos valores. Recuerda que el API Token solo se muestra una vez al momento de la creación.

</details>

<details>

<summary>¿Puedo regenerar las credenciales de API?</summary>

Sí, puedes generar nuevas claves API en cualquier momento desde el Dashboard de Aircall. Si lo haces, recuerda actualizar las credenciales en Salescaling para que la integración siga funcionando.

</details>

Si tienes dudas o necesitas ayuda, contacta con el soporte de Salescaling.


---

# 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/configuraciones-de-la-plataforma/integraciones/conectar-plataformas-de-llamadas/aircall.md?ask=<question>
```

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.
