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

# Freshsales

> API キーとバンドルエイリアスを使用して Freshsales を Iru Compliance に接続し、ユーザーロール、権限マトリクス、テリトリーベースのアクセス制御を収集します。

### Freshsales について

Iru は Freshsales（Freshworks CRM）API から、**ユーザーとそのロール**、**ロールとその権限**、**テリトリー**、および **機密データに対するフィールドレベルの権限** を読み取ります。認証には **API キー** と **バンドルエイリアス** を使用します。どちらも **Profile Settings** → **API Settings** にあります。リクエストの送信先は `https://YOUR_BUNDLE_ALIAS.myfreshworks.com/crm/sales/api` です。コネクタウィザードでは、最初に **API キー**、次に **バンドルエイリアス** を入力します。

Freshsales と **Freshservice** は異なる製品であり、**認証方式も異なります**。IT サービス管理のデータを接続する場合は、代わりに [Freshservice](/ja/compliance/sources/freshservice-source) の記事を参照してください。

### 仕組み

```http theme={null}
Authorization: Token token=YOUR_API_KEY
```

Freshsales は Basic 認証や Bearer プレフィックスを **使用しません**。キーは `Authorization` ヘッダーに `Token token=YOUR_API_KEY` という形式のまま指定します。API には **バージョンがありません**。バージョンヘッダーや日付付きのリビジョンはありません。

**バンドルエイリアス** は、Freshworks 組織に複数の CRM アカウントがある場合に、どのアカウントを読み取るかを指定します。このため、このフィールドは必須です。API キーは **ユーザーごと** に発行され、エンドポイントごとのスコープはなく、**そのユーザーのロールをそのまま** 継承します。

| 項目 | 値 |
| - | - |
| **カテゴリ** | CRM |
| **認証** | トークン（API キー + バンドルエイリアス） |

公式リファレンス: [Freshworks CRM API](https://developers.freshworks.com/crm/api/)。

### 前提条件

* **バンドルエイリアス** と **API キー**。どちらも同じ **API Settings** ページにあります。
* キーを生成するための **管理者レベルの専用 CRM ユーザー**。キーはそのユーザーのロールを継承し、スコープを持たないため、テリトリー制限のある営業ユーザーのキーでは不完全な権限情報しか返されません。

### Freshsales を Iru に接続する

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

    <Steps>
      <Step title="Freshsales にサインインする">
        連携に継承させるアクセス権を持つ **管理者レベルのユーザー** として、Freshsales アカウントにサインインします。
      </Step>

      <Step title="Profile Settings を開く">
        右上の **プロフィール画像** を選択し、**Profile Settings** を選択します。
      </Step>

      <Step title="API Settings を開く">
        **API Settings** タブを選択します。
      </Step>

      <Step title="API キーとバンドルエイリアスをコピーする">
        **Your API key** の下に表示されている値をコピーします。同じタブの API キーのすぐ下に表示されている **Bundle alias** もコピーします。組織の CRM アカウントが 1 つだけの場合でも、これは必須です。
      </Step>
    </Steps>

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

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

      <Step title="API キーを入力する">
        ウィザードの最初のステップは **Enter API Key (Authorization)** です。**Authorization** フィールドに API キーを貼り付けます。ウィザードにはヘッダー形式 `Token token=<api_key>` が表示されます。
      </Step>

      <Step title="API キーを送信する">
        **APIキーを送信** を選択します。
      </Step>

      <Step title="バンドルエイリアスを入力する">
        **バンドルエイリアス** のみを入力します（例: `acme`。完全な `myfreshworks.com` の URL ではありません）。ウィザードにプレビュー URL が表示された場合は確認します。接続に成功すると、ウィザードに **接続が構成されました** と表示されます。
      </Step>

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

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

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

  <Accordion title="401 Authentication Failure">
    API キーが完全であること、および **バンドルエイリアス** がキーの属する CRM アカウントと一致していることを確認してください。有効なキーでも誤ったバンドルホストに対して使用すると、無効なキーと同じように失敗します。
  </Accordion>

  <Accordion title="誤って Freshservice のキーをコピーした">
    2 つの製品は異なる認証情報を発行し、認証方法も異なります。Freshservice のキーはここでは機能しません。
  </Accordion>

  <Accordion title="ユーザーは表示されるが、ロールやテリトリーが不完全">
    キーの所有ユーザー自身のロールでは、それらを参照できません。管理者レベルのユーザーでキーを再生成してください。
  </Accordion>

  <Accordion title="ウィザードでホストに到達できないと表示される">
    バンドルエイリアスはサブドメインのみです。`https://` や `.myfreshworks.com` は含めないでください。
  </Accordion>
</AccordionGroup>

### 関連記事

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

  <Card title="Freshservice" icon="headset" href="/ja/compliance/sources/freshservice-source">
    ITSM のエビデンスを得るために Freshservice を接続します。
  </Card>

  <Card title="Compliance を使い始める" icon="rocket" href="/ja/compliance/getting-started-with-compliance">
    フレームワーク、アクション、**アーティファクト**。
  </Card>

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