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

> HTTP Basic 認証(api_id と api_token)を使用して Aircall を Iru Compliance に接続し、通話アクティビティ、ユーザー、チームメンバーシップの証跡を収集します。

### Aircall について

Aircall は、クラウドベースのビジネス電話システムおよびコールセンタープラットフォームです。**Aircall** ソースは、**通話**、**ユーザー**、**チーム**のアクティビティを Iru に取り込み、コンプライアンスフレームワークに証跡を添付できるようにします。認証には、**Aircall Public API** に対する **HTTP Basic**(ユーザー名として `api_id`、パスワードとして `api_token`)を使用します。

### 仕組み

Iru は、**HTTP Basic** を使用して HTTPS 経由で **Aircall Public API** を呼び出します。**ユーザー名**として **`api_id`**、**パスワード**として **`api_token`** を使用します([Basic authentication](https://developer.aircall.io/tutorials/basic-authentication) を参照)。

| 項目 | 値 |
| - | - |
| **カテゴリ** | コミュニケーション |
| **認証** | HTTP Basic(**ユーザー名** = `api_id`、**パスワード** = `api_token`) |
| **ベンダーのプラン** | Aircall の任意の**有料**プラン(API アクセスを含む) |

公式リファレンス: [Basic authentication](https://developer.aircall.io/tutorials/basic-authentication)、[API references](https://developer.aircall.io/api-references/)。

### 前提条件

* Aircall アカウントの **管理者** または **所有者**(標準ユーザーは API キーを作成できません)。
* セットアップに約 **5 分**。
* Aircall API のトラフィック用の **HTTPS**。
* コネクタのウィザードを開けるように、ブラウザの**ポップアップ**が許可されていること。

### Aircall を Iru に接続する

<Tabs>
  <Tab title="Aircall">
    <Note>
      Compliance でソースを接続する前に、このタブを完了してください。
    </Note>

    <Steps>
      <Step title="Aircall にサインインする">
        [Aircall Dashboard](https://dashboard.aircall.io) を開き、**管理者** または **所有者** の権限を持つアカウントでサインインします(API キーを作成できるのはこれらのロールのみです)。
      </Step>

      <Step title="Integrations & API を開く">
        左側のサイドバーで **Integrations & API** を選択します(表記は Aircall の UI のバージョンによって多少異なる場合があります)。
      </Step>

      <Step title="API キーに移動する">
        ワークスペースでの表記に応じて、**Aircall API** セクションまたは **APIキー** タブを開きます。
      </Step>

      <Step title="新しい API キーを作成する">
        **Add a new API Key** または **Generate an API Key** を選択します。わかりやすい名前(例: **Iru Compliance**)を入力して確定し、Aircall にキーペアを作成させます。
      </Step>

      <Step title="api_id と api_token をコピーする">
        Aircall には **`api_id`** と **`api_token`** が一緒に表示されます。両方を安全な場所にコピーしてください。Iru の **Basic Authentication** の手順で、**`api_id`** を **ユーザー名** として、**`api_token`** を **パスワード** として使用します。

        **`api_token`** は **1 回のみ**表示されます。紛失した場合は、Aircall でこのキーを削除して新しいキーを作成し、新しい値で Iru を更新してください。
      </Step>
    </Steps>

    <Note>
      [**Iru Compliance**](#iru-compliance) タブに進みます。
    </Note>
  </Tab>

  <Tab title="Iru Compliance">
    <Note>
      先に [**Aircall**](#aircall) タブを完了してください。
    </Note>

    <Steps>
      <Step title="ソースを開く">
        Iru Compliance の左側のナビゲーションバーで **コンプライアンス** を展開し、**ソース** を選択します。

        <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="左側のナビゲーション: Compliance を展開し、Sources を選択した状態" width="410" height="1024" data-path="assets/media/images/iru-navigation-compliance-sources.png" />
        </Frame>
      </Step>

      <Step title="Aircall をオンにする">
        **Aircall** を探します(**カテゴリ** を **Communications** に設定するか、**名前または説明で検索** を使用します)。**Aircall** のカードで**トグル**をオンにします。ウィザード用に**新しいブラウザタブ**が開く場合があります。
      </Step>

      <Step title="Basic 認証の情報を入力する">
        **Enter Basic Authentication** で、**ユーザー名** に **`api_id`** を、**パスワード** に **`api_token`** を入力します。
      </Step>

      <Step title="接続を完了する">
        **資格情報を送信** を選択します。接続が成功すると、ウィザードに **接続が構成されました** と表示されます。
      </Step>

      <Step title="ソースが有効であることを確認する">
        **Iru が外部サービスへのアクセスをリクエストしています** のブラウザタブを閉じてから、**コンプライアンス** → **ソース** に戻り、**Aircall** のカードが **有効** であることを確認します。
      </Step>
    </Steps>
  </Tab>
</Tabs>

### 考慮事項

* **アカウント全体のキー:** API キーは単一のユーザーではなく**アカウント**に適用されます。チームが Aircall でキーをローテーションまたは削除しない限り、キーを作成した担当者が退職してもインテグレーションは引き続き機能します。
* **レート制限:** Aircall の Public API のデフォルトは **1 分あたり 60 リクエスト**です。制限に達すると、Iru は**バックオフ**を適用します。それでも、極端に頻繁な**手動**での証跡の更新によって **429** レスポンスが発生する可能性があります。トラブルシューティングを参照してください。
* **アクセスモード:** Iru はこの接続を**読み取り中心**のコンプライアンスの証跡に使用します。ただし、**`api_token`** は Aircall がそのキーに割り当てたアクセスレベルを付与します。**シークレットと同様に保管し、ローテーションしてください**。

### トラブルシューティング

<AccordionGroup>
  <Accordion title="ソースをオンにしても何も開かない">
    Iru サイトの**ポップアップブロッカー**の設定を確認してから、再試行してください。
  </Accordion>

  <Accordion title="401 Unauthorized">
    **`api_token`** が間違っているか、Aircall でキーが**削除**されている可能性があります。Aircall で新しい API キーを作成し、新しい **`api_id`** / **`api_token`** を Iru で送信してください。
  </Accordion>

  <Accordion title="429 Too Many Requests">
    Aircall のレート制限(デフォルトで **1 分あたり 60 リクエスト**)に達しました。Iru は自動的に**バックオフ**します。**429** が続く場合は、制限の引き上げについて **Aircall サポート**にお問い合わせください。
  </Accordion>

  <Accordion title="API キーの作成時に「You don’t have permission」と表示される">
    キーを作成できるのは **管理者** または **所有者** のみです。Aircall の管理者にキーの作成を依頼するか、ロールを更新してもらってください。
  </Accordion>
</AccordionGroup>

### 関連記事

<CardGroup cols={2}>
  <Card title="ソース管理" icon="plug" href="/ja/compliance/sources-management">
    すべての Compliance ソースを参照して管理します。
  </Card>

  <Card title="コンプライアンスの開始" icon="rocket" href="/ja/compliance/getting-started-with-compliance">
    フレームワーク、アクション、**アーティファクト**。
  </Card>

  <Card title="Iru の概要" icon="layer-group" href="/ja/iru/platform-overview/iru-overview">
    Endpoint、Compliance、Identity がどのように連携するか。
  </Card>

  <Card title="アーティファクト管理" icon="folder-open" href="/ja/compliance/artifacts-management">
    ソースとアクションからの証跡のアップロード、確認、整理。
  </Card>
</CardGroup>