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

# Intercom

> アクセストークンとワークスペースに対応するリージョンの API ホストを使用して Intercom を Iru Compliance に接続し、管理者、チーム、会話のエビデンスを収集します。

### Intercom について

Iru は Intercom REST API を通じて、**連絡先**、**会話のメタデータ**、**チーム**、**タグ**、**ワークスペース** の設定を読み取ります。**データレジデンシー** に対応する **リージョンのベース URL**（**US**、**EU**、または **Australia**）を選択し、**Developer Hub** から取得した **Bearer** トークン（アプリのアクセストークンまたは同等のもの）を指定する必要があります。

### 仕組み

```http theme={null}
Authorization: Bearer YOUR_ACCESS_TOKEN
```

| 項目 | 値 |
| - | - |
| **カテゴリ** | サポート |
| **認証** | Bearer トークン |

| リージョン | ベース URL |
| - | - |
| **US（デフォルト）** | `https://api.intercom.io` |
| **EU** | `https://api.eu.intercom.io` |
| **Australia** | `https://api.au.intercom.io` |

公式リファレンス: [認証](https://developers.intercom.com/docs/build-an-integration/learn-more/authentication)、[Developer Hub](https://app.intercom.com/a/developer-signup)、[REST API](https://developers.intercom.com/docs/)。

### 前提条件

* **Developer Hub** でアプリトークンを作成または表示するための **管理者** または十分な権限。

### Intercom を Iru に接続する

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

    <Steps>
      <Step title="Intercom Developer Hub を開く">
        開発者アプリを管理できるユーザーで Intercom にサインインし、**[Developer Hub](https://app.intercom.com/a/developer-signup)** を開きます。
      </Step>

      <Step title="Iru 用のアプリを選択する">
        Iru に使用させる **アプリ**（ワークスペースコネクタ）を開きます。まだ存在しない場合は、アプリを作成し、**Iru Compliance** などのわかりやすい名前を付けます。
      </Step>

      <Step title="認証設定を開く">
        アプリで **認証**（Intercom の UI によっては **構成** → **認証**）に移動します。
      </Step>

      <Step title="アクセストークンを作成または確認する">
        この連携用の **Access Token** がまだない場合は作成します。セキュリティポリシーで再利用が許可されている場合は、既存のトークンを開きます。
      </Step>

      <Step title="トークンをコピーして保管する">
        トークンをすぐに **コピー** します。ページを離れると、完全な値を再度確認できない場合があります。Iru に貼り付けるまでボールトに保管してください。
      </Step>
    </Steps>

    <Note>
      [**Iru Compliance**](#iru-compliance) タブに進んでください。
    </Note>
  </Tab>

  <Tab title="Iru Compliance">
    <Note>
      先に [**Intercom**](#intercom) タブの手順を完了してください。
    </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="Intercom をオンにする">
        **Intercom** を探します（**カテゴリ** または **名前または説明で検索** を使用します）。そのカードで **トグル** をオンにします。コネクタウィザード用のブラウザタブまたはウィンドウが開く場合があります。
      </Step>

      <Step title="API ホストを選択する">
        リージョン（**US**、**EU**、または **Australia**）に対応する **サーバー** エンドポイントを選択します。認証情報を入力する前に確認します。
      </Step>

      <Step title="アクセストークンを貼り付ける">
        求められたら、**Bearer** アクセストークンを貼り付けます。
      </Step>

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

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

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

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

  <Accordion title="401 Unauthorized">
    トークンが完全にコピーされていること、およびこのワークスペースのものであることを確認してください。
  </Accordion>

  <Accordion title="リージョンが間違っている">
    EU/AU のワークスペースでは、汎用の US ルートではなく、対応するホストを使用する **必要があります**。
  </Accordion>

  <Accordion title="データセットが表示されない">
    拡張スコープには Intercom の承認が必要な場合があります。Developer Hub でアプリの権限を確認してください。
  </Accordion>
</AccordionGroup>

### 考慮事項

<CardGroup cols={2}>
  <Card title="詳細な会話スコープには Intercom の…" icon="circle-info">
    詳細な会話スコープには、Intercom によるレビューが必要な場合があります（数営業日かかることがあります）。
  </Card>
</CardGroup>

### 関連記事

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

  <Card title="Compliance を使い始める" 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="Artifacts の管理" icon="folder-open" href="/ja/compliance/artifacts-management">
    ソースやアクションから得たエビデンスをアップロード、確認、整理します。
  </Card>
</CardGroup>