Skip to main content

​
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 の記事を参照してください。

​
仕組み

Freshsales は Basic 認証や Bearer プレフィックスを 使用しません。キーは Authorization ヘッダーに Token token=YOUR_API_KEY という形式のまま指定します。API には バージョンがありません。バージョンヘッダーや日付付きのリビジョンはありません。 バンドルエイリアス は、Freshworks 組織に複数の CRM アカウントがある場合に、どのアカウントを読み取るかを指定します。このため、このフィールドは必須です。API キーは ユーザーごと に発行され、エンドポイントごとのスコープはなく、そのユーザーのロールをそのまま 継承します。 公式リファレンス: Freshworks CRM API。

​
前提条件

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

​
Freshsales を Iru に接続する

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

Freshsales にサインインする

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

Profile Settings を開く

右上の プロフィール画像 を選択し、Profile Settings を選択します。
3

API Settings を開く

API Settings タブを選択します。
4

API キーとバンドルエイリアスをコピーする

Your API key の下に表示されている値をコピーします。同じタブの API キーのすぐ下に表示されている Bundle alias もコピーします。組織の CRM アカウントが 1 つだけの場合でも、これは必須です。
Iru Compliance タブに進んでください。

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

Iru サイトの ポップアップブロッカー の設定を確認して、もう一度お試しください。
API キーが完全であること、および バンドルエイリアス がキーの属する CRM アカウントと一致していることを確認してください。有効なキーでも誤ったバンドルホストに対して使用すると、無効なキーと同じように失敗します。
2 つの製品は異なる認証情報を発行し、認証方法も異なります。Freshservice のキーはここでは機能しません。
キーの所有ユーザー自身のロールでは、それらを参照できません。管理者レベルのユーザーでキーを再生成してください。
バンドルエイリアスはサブドメインのみです。https:// や .myfreshworks.com は含めないでください。

​
関連記事

Sources の管理

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

Freshservice

ITSM のエビデンスを得るために Freshservice を接続します。

Compliance を使い始める

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

Artifacts の管理

ソースやアクションから得たエビデンスをアップロード、確認、整理します。