Skip to main content

​
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). Referencias oficiales: Basic authentication, 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

Completa esta pestaña antes de conectar la fuente en Compliance.
1

Iniciar sesión en Aircall

Abre el Aircall Dashboard e inicia sesión con una cuenta que tenga derechos de Administrador u Propietario (solo esos roles pueden crear claves de API).
2

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).
3

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.
4

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.
5

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.
Continúa en la pestaña Iru Compliance.

​
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

Revisa la configuración del bloqueador de ventanas emergentes para el sitio de Iru e inténtalo de nuevo.
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.
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.
Solo Administrador u Propietario pueden crear claves. Pide a un administrador de Aircall que cree la clave o que actualicen tu rol.

​
Artículos relacionados

Gestión de fuentes

Explora y gestiona todas las fuentes de Compliance.

Primeros pasos con Compliance

Marcos, acciones y Artefactos.

Descripción general de Iru

Cómo encajan Endpoint, Compliance e Identity.

Gestión de artefactos

Carga, revisa y organiza las evidencias de fuentes y acciones.