Skip to main content

​
Über Aircall

Aircall ist ein cloudbasiertes Geschäftstelefonsystem und eine Callcenter-Plattform. Die Aircall-Source überträgt Anruf-, Benutzer- und Team-Aktivitäten in Iru, damit Sie Nachweise an Compliance-Frameworks anhängen können. Die Authentifizierung erfolgt per HTTP Basic gegenüber der Aircall Public API (api_id als Benutzername, api_token als Passwort).

​
Funktionsweise

Iru ruft die Aircall Public API über HTTPS mit HTTP Basic auf: api_id als Benutzername und api_token als Passwort (siehe Basic authentication). Offizielle Referenzen: Basic authentication, API references.

​
Voraussetzungen

  • Administrator oder Besitzer im Aircall-Konto (Standardbenutzer können keine API-Schlüssel erstellen).
  • Etwa 5 Minuten für die Einrichtung.
  • HTTPS für den Aircall-API-Datenverkehr.
  • Im Browser zugelassene Pop-ups, damit sich der Connector-Assistent öffnen kann.

​
Aircall mit Iru verbinden

Schließen Sie diesen Tab ab, bevor Sie die Source in Compliance verbinden.
1

Bei Aircall anmelden

Öffnen Sie das Aircall Dashboard und melden Sie sich mit einem Konto an, das über Administrator- oder Besitzer-Rechte verfügt (nur diese Rollen können API-Schlüssel erstellen).
2

Integrations & API öffnen

Wählen Sie in der linken Seitenleiste Integrations & API (die Bezeichnung kann je nach Version der Aircall-Oberfläche leicht variieren).
3

Zu den API-Schlüsseln wechseln

Öffnen Sie den Abschnitt Aircall API oder den Tab API-Schlüssel, je nachdem, wie Ihr Workspace ihn bezeichnet.
4

Neuen API-Schlüssel erstellen

Wählen Sie Add a new API Key oder Generate an API Key. Geben Sie einen eindeutigen Namen ein (zum Beispiel Iru Compliance) und bestätigen Sie, damit Aircall das Schlüsselpaar erstellt.
5

api_id und api_token kopieren

Aircall zeigt api_id und api_token zusammen an. Kopieren Sie beide an einen sicheren Ort: Sie verwenden api_id als Benutzername und api_token als Kennwort im Schritt Basic Authentication in Iru.api_token wird nur einmal angezeigt. Wenn Sie es verlieren, löschen Sie diesen Schlüssel in Aircall, erstellen Sie einen neuen und aktualisieren Sie Iru mit den neuen Werten.
Fahren Sie mit dem Tab Iru Compliance fort.

​
Hinweise

  • Kontoweite Schlüssel: API-Schlüssel gelten für das Konto, nicht für einen einzelnen Benutzer. Die Integration kann weiter funktionieren, wenn die Person, die den Schlüssel erstellt hat, das Unternehmen verlässt – es sei denn, Ihr Team rotiert oder löscht den Schlüssel in Aircall.
  • Ratenbegrenzungen: Der Standard der Aircall Public API liegt bei 60 Anfragen pro Minute. Iru wendet ein Backoff an, wenn Limits erreicht werden. Ungewöhnlich häufige manuelle Aktualisierungen von Nachweisen können dennoch 429-Antworten auslösen. Siehe Fehlerbehebung.
  • Zugriffsmodus: Iru verwendet diese Verbindung für lesende Compliance-Nachweise. Das api_token gewährt dennoch die Zugriffsebene, die Aircall diesem Schlüssel zuweist. Speichern und rotieren Sie es wie ein Secret.

​
Fehlerbehebung

Prüfen Sie die Einstellungen des Pop-up-Blockers für die Iru-Website und versuchen Sie es erneut.
Das api_token ist möglicherweise falsch, oder der Schlüssel wurde in Aircall gelöscht. Erstellen Sie in Aircall einen neuen API-Schlüssel und übermitteln Sie die neue api_id / das neue api_token in Iru.
Sie haben die Ratenbegrenzung von Aircall erreicht (standardmäßig 60 Anfragen pro Minute). Iru reduziert die Anfragen automatisch. Wenn 429 weiterhin auftritt, wenden Sie sich wegen eines höheren Limits an den Aircall-Support.
Nur Administrator oder Besitzer können Schlüssel erstellen. Bitten Sie einen Aircall-Administrator, den Schlüssel zu erstellen, oder lassen Sie Ihre Rolle aktualisieren.

​
Verwandte Artikel

Verwaltung von Sources

Alle Compliance-Sources durchsuchen und verwalten.

Erste Schritte mit Compliance

Frameworks, Actions und Artefakte.

Iru-Übersicht

Wie Endpoint, Compliance und Identity zusammenwirken.

Verwaltung von Artefakten

Nachweise aus Sources und Actions hochladen, prüfen und organisieren.