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

# Aircall

> Conecta Aircall con Iru Compliance mediante autenticación HTTP Basic (api_id y api_token) para recopilar evidencias de actividad de llamadas, usuarios y pertenencia a equipos.

### Acerca de Aircall

Aircall es un sistema telefónico empresarial y una plataforma de centro de llamadas basados en la nube. La fuente **Aircall** incorpora a Iru la actividad de **llamadas**, **usuarios** y **equipos** para que puedas adjuntar evidencias a los marcos de cumplimiento. La autenticación usa **HTTP Basic** con la **Aircall Public API** (`api_id` como nombre de usuario y `api_token` como contraseña).

### Cómo funciona

Iru llama a la **Aircall Public API** mediante HTTPS usando **HTTP Basic**: **`api_id`** como **nombre de usuario** y **`api_token`** como **contraseña** (consulta [Basic authentication](https://developer.aircall.io/tutorials/basic-authentication)).

| Detalle | Valor |
| - | - |
| **Categoría** | Communications |
| **Autenticación** | HTTP Basic (**Nombre de usuario** = `api_id`, **Contraseña** = `api_token`) |
| **Plan del proveedor** | Cualquier plan **de pago** de Aircall (incluye acceso a la API) |

Referencias oficiales: [Basic authentication](https://developer.aircall.io/tutorials/basic-authentication), [API references](https://developer.aircall.io/api-references/).

### Requisitos previos

* Rol de **Administrador** u **Propietario** en la cuenta de Aircall (los usuarios estándar no pueden crear claves de API).
* Unos **5 minutos** para la configuración.
* **HTTPS** para el tráfico de la API de Aircall.
* **Ventanas emergentes** permitidas en el navegador para que se pueda abrir el asistente del conector.

### Conectar Aircall con Iru

<Tabs>
  <Tab title="Aircall">
    <Note>
      Completa esta pestaña antes de conectar la fuente en Compliance.
    </Note>

    <Steps>
      <Step title="Iniciar sesión en Aircall">
        Abre el [Aircall Dashboard](https://dashboard.aircall.io) e inicia sesión con una cuenta que tenga derechos de **Administrador** u **Propietario** (solo esos roles pueden crear claves de API).
      </Step>

      <Step title="Abrir Integrations & API">
        En la barra lateral izquierda, selecciona **Integrations & API** (la redacción puede variar ligeramente según la versión de la interfaz de Aircall).
      </Step>

      <Step title="Ir a las claves de API">
        Abre la sección **Aircall API** o la pestaña **Claves de API**, según cómo se etiquete en tu espacio de trabajo.
      </Step>

      <Step title="Crear una nueva clave de API">
        Elige **Add a new API Key** o **Generate an API Key**. Introduce un nombre claro (por ejemplo, **Iru Compliance**) y confirma para que Aircall cree el par de claves.
      </Step>

      <Step title="Copiar api_id y api_token">
        Aircall muestra **`api_id`** y **`api_token`** juntos. Copia ambos en un lugar seguro: usarás **`api_id`** como **Nombre de usuario** y **`api_token`** como **Contraseña** en el paso **Basic Authentication** de Iru.

        **`api_token`** aparece **una sola vez**. Si lo pierdes, elimina esta clave en Aircall y crea una nueva; después, actualiza Iru con los nuevos valores.
      </Step>
    </Steps>

    <Note>
      Continúa en la pestaña [**Iru Compliance**](#iru-compliance).
    </Note>
  </Tab>

  <Tab title="Iru Compliance">
    <Note>
      Termina primero la pestaña [**Aircall**](#aircall).
    </Note>

    <Steps>
      <Step title="Abrir Sources">
        En Iru Compliance, en la barra de navegación izquierda, expande **Cumplimiento** y selecciona **Fuentes**.

        <Frame>
          <img src="https://mintcdn.com/iru/tI0HDLDwHj8r9Ile/assets/media/images/iru-navigation-compliance-sources.png?fit=max&auto=format&n=tI0HDLDwHj8r9Ile&q=85&s=87dcef15fc17d2fb9a6e53f454e41710" alt="Navegación izquierda: Compliance expandido, Sources seleccionado" width="410" height="1024" data-path="assets/media/images/iru-navigation-compliance-sources.png" />
        </Frame>
      </Step>

      <Step title="Activar Aircall">
        Busca **Aircall** (establece **Categoría** en **Communications** o usa **Buscar por nombre o descripción**). En la tarjeta de **Aircall**, activa el **interruptor**. Es posible que se abra una **nueva pestaña del navegador** con el asistente.
      </Step>

      <Step title="Introducir la autenticación Basic">
        En **Enter Basic Authentication**, introduce **`api_id`** en **Nombre de usuario** y **`api_token`** en **Contraseña**.
      </Step>

      <Step title="Finalizar la conexión">
        Selecciona **Enviar credenciales**. Cuando la conexión se realiza correctamente, el asistente muestra **Conexión configurada**.
      </Step>

      <Step title="Confirmar que la fuente está activa">
        Cierra la pestaña del navegador **Iru está solicitando acceso a servicios externos** y, a continuación, vuelve a **Cumplimiento** → **Fuentes** y confirma que la tarjeta de **Aircall** está **Activo**.
      </Step>
    </Steps>
  </Tab>
</Tabs>

### Consideraciones

* **Claves para toda la cuenta:** las claves de API se aplican a la **cuenta**, no a un único usuario. La integración puede seguir funcionando si la persona que creó la clave se marcha, salvo que tu equipo rote o elimine la clave en Aircall.
* **Límites de frecuencia:** el valor predeterminado de la Public API de Aircall es de **60 solicitudes por minuto**. Iru aplica **espera exponencial** cuando se alcanzan los límites. Las actualizaciones **manuales** de evidencias excesivamente frecuentes aún podrían provocar respuestas **429**. Consulta la solución de problemas.
* **Modo de acceso:** Iru usa esta conexión para evidencias de cumplimiento **orientadas a la lectura**. El **`api_token`** sigue concediendo el nivel de acceso que Aircall asigna a esa clave. **Guárdalo y rótalo como un secreto**.

### Solución de problemas

<AccordionGroup>
  <Accordion title="No se abre nada al activar la fuente">
    Revisa la configuración del **bloqueador de ventanas emergentes** para el sitio de Iru e inténtalo de nuevo.
  </Accordion>

  <Accordion title="401 Unauthorized">
    Es posible que el **`api_token`** sea incorrecto o que la clave se haya **eliminado** en Aircall. Crea una nueva clave de API en Aircall y envía los nuevos **`api_id`** / **`api_token`** en Iru.
  </Accordion>

  <Accordion title="429 Too Many Requests">
    Has alcanzado el límite de frecuencia de Aircall (**60 solicitudes por minuto** de forma predeterminada). Iru aplica **espera exponencial** automáticamente. Si el **429** persiste, contacta con el **soporte de Aircall** para solicitar un límite mayor.
  </Accordion>

  <Accordion title="“You don’t have permission” al crear la clave de API">
    Solo **Administrador** u **Propietario** pueden crear claves. Pide a un administrador de Aircall que cree la clave o que actualicen tu rol.
  </Accordion>
</AccordionGroup>

### Artículos relacionados

<CardGroup cols={2}>
  <Card title="Gestión de fuentes" icon="plug" href="/es/compliance/sources-management">
    Explora y gestiona todas las fuentes de Compliance.
  </Card>

  <Card title="Primeros pasos con Compliance" icon="rocket" href="/es/compliance/getting-started-with-compliance">
    Marcos, acciones y **Artefactos**.
  </Card>

  <Card title="Descripción general de Iru" icon="layer-group" href="/es/iru/platform-overview/iru-overview">
    Cómo encajan Endpoint, Compliance e Identity.
  </Card>

  <Card title="Gestión de artefactos" icon="folder-open" href="/es/compliance/artifacts-management">
    Carga, revisa y organiza las evidencias de fuentes y acciones.
  </Card>
</CardGroup>