> ## 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

> Verbinden Sie Aircall per HTTP-Basic-Authentifizierung (api_id und api_token) mit Iru Compliance, um Nachweise zu Anrufaktivitäten, Benutzern und Teammitgliedschaften zu erfassen.

### Ü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](https://developer.aircall.io/tutorials/basic-authentication)).

| Detail | Wert |
| - | - |
| **Kategorie** | Communications |
| **Authentifizierung** | HTTP Basic (**Benutzername** = `api_id`, **Kennwort** = `api_token`) |
| **Anbietertarif** | Jeder **kostenpflichtige** Aircall-Tarif (API-Zugriff inbegriffen) |

Offizielle Referenzen: [Basic authentication](https://developer.aircall.io/tutorials/basic-authentication), [API references](https://developer.aircall.io/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

<Tabs>
  <Tab title="Aircall">
    <Note>
      Schließen Sie diesen Tab ab, bevor Sie die Source in Compliance verbinden.
    </Note>

    <Steps>
      <Step title="Bei Aircall anmelden">
        Öffnen Sie das [Aircall Dashboard](https://dashboard.aircall.io) 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).
      </Step>

      <Step title="Integrations & API öffnen">
        Wählen Sie in der linken Seitenleiste **Integrations & API** (die Bezeichnung kann je nach Version der Aircall-Oberfläche leicht variieren).
      </Step>

      <Step title="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.
      </Step>

      <Step title="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.
      </Step>

      <Step title="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.
      </Step>
    </Steps>

    <Note>
      Fahren Sie mit dem Tab [**Iru Compliance**](#iru-compliance) fort.
    </Note>
  </Tab>

  <Tab title="Iru Compliance">
    <Note>
      Schließen Sie zuerst den Tab [**Aircall**](#aircall) ab.
    </Note>

    <Steps>
      <Step title="Quellen öffnen">
        Erweitern Sie in Iru Compliance in der linken Navigationsleiste **Compliance** und wählen Sie **Quellen**.

        <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="Linke Navigation: Compliance erweitert, Sources ausgewählt" width="410" height="1024" data-path="assets/media/images/iru-navigation-compliance-sources.png" />
        </Frame>
      </Step>

      <Step title="Aircall aktivieren">
        Suchen Sie **Aircall** (setzen Sie **Kategorie** auf **Communications** oder verwenden Sie **Nach Name oder Beschreibung suchen**). Aktivieren Sie auf der Karte **Aircall** den **Schalter**. Für den Assistenten kann sich ein **neuer Browser-Tab** öffnen.
      </Step>

      <Step title="Basic-Authentifizierung eingeben">
        Geben Sie unter **Enter Basic Authentication** die **`api_id`** in **Benutzername** und das **`api_token`** in **Kennwort** ein.
      </Step>

      <Step title="Verbindung abschließen">
        Wählen Sie **Anmeldedaten senden**. Wenn die Verbindung erfolgreich ist, zeigt der Assistent **Verbindung konfiguriert** an.
      </Step>

      <Step title="Bestätigen, dass die Source Active ist">
        Schließen Sie den Browser-Tab **Iru fordert Zugriff auf externe Dienste an**, kehren Sie dann zu **Compliance** → **Quellen** zurück und bestätigen Sie, dass die Karte **Aircall** **Aktiv** ist.
      </Step>
    </Steps>
  </Tab>
</Tabs>

### 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

<AccordionGroup>
  <Accordion title="Beim Aktivieren der Source öffnet sich nichts">
    Prüfen Sie die Einstellungen des **Pop-up-Blockers** für die Iru-Website und versuchen Sie es erneut.
  </Accordion>

  <Accordion title="401 Unauthorized">
    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.
  </Accordion>

  <Accordion title="429 Too Many Requests">
    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**.
  </Accordion>

  <Accordion title="„You don’t have permission“ beim Erstellen des API-Schlüssels">
    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.
  </Accordion>
</AccordionGroup>

### Verwandte Artikel

<CardGroup cols={2}>
  <Card title="Verwaltung von Sources" icon="plug" href="/de/compliance/sources-management">
    Alle Compliance-Sources durchsuchen und verwalten.
  </Card>

  <Card title="Erste Schritte mit Compliance" icon="rocket" href="/de/compliance/getting-started-with-compliance">
    Frameworks, Actions und **Artefakte**.
  </Card>

  <Card title="Iru-Übersicht" icon="layer-group" href="/de/iru/platform-overview/iru-overview">
    Wie Endpoint, Compliance und Identity zusammenwirken.
  </Card>

  <Card title="Verwaltung von Artefakten" icon="folder-open" href="/de/compliance/artifacts-management">
    Nachweise aus Sources und Actions hochladen, prüfen und organisieren.
  </Card>
</CardGroup>