Skip to main content

​
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 を参照)。 公式リファレンス: Basic authentication、API references。

​
前提条件

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

​
Aircall を Iru に接続する

Compliance でソースを接続する前に、このタブを完了してください。
1

Aircall にサインインする

Aircall Dashboard を開き、管理者 または 所有者 の権限を持つアカウントでサインインします(API キーを作成できるのはこれらのロールのみです)。
2

Integrations & API を開く

左側のサイドバーで Integrations & API を選択します(表記は Aircall の UI のバージョンによって多少異なる場合があります)。
3

API キーに移動する

ワークスペースでの表記に応じて、Aircall API セクションまたは APIキー タブを開きます。
4

新しい API キーを作成する

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

api_id と api_token をコピーする

Aircall には api_id と api_token が一緒に表示されます。両方を安全な場所にコピーしてください。Iru の Basic Authentication の手順で、api_id を ユーザー名 として、api_token を パスワード として使用します。api_token は 1 回のみ表示されます。紛失した場合は、Aircall でこのキーを削除して新しいキーを作成し、新しい値で Iru を更新してください。
Iru Compliance タブに進みます。

​
考慮事項

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

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

Iru サイトのポップアップブロッカーの設定を確認してから、再試行してください。
api_token が間違っているか、Aircall でキーが削除されている可能性があります。Aircall で新しい API キーを作成し、新しい api_id / api_token を Iru で送信してください。
Aircall のレート制限(デフォルトで 1 分あたり 60 リクエスト)に達しました。Iru は自動的にバックオフします。429 が続く場合は、制限の引き上げについて Aircall サポートにお問い合わせください。
キーを作成できるのは 管理者 または 所有者 のみです。Aircall の管理者にキーの作成を依頼するか、ロールを更新してもらってください。

​
関連記事

ソース管理

すべての Compliance ソースを参照して管理します。

コンプライアンスの開始

フレームワーク、アクション、アーティファクト。

Iru の概要

Endpoint、Compliance、Identity がどのように連携するか。

アーティファクト管理

ソースとアクションからの証跡のアップロード、確認、整理。