---
articleId: 689ca29d-0079-4180-845c-f4cc80bbdf76
slug: connection-configuration-freshsales
title: 接続情報 - Freshsales
parentCategoryId: 4db89ef6-4431-4a1f-a7c6-6c3b8a1a224c
languageCode: ja
---
本ページでは、Freshsalesに接続するための設定（接続情報）について説明します。
転送に関する設定については、[転送元 - Freshsales](/docs/data-source-freshsales)を参照ください。
## 利用上の注意・制約
:::(Warning) (APIキーの取得)
FreshsalesのAPIキーは、各インスタンスの管理者権限を持つユーザーのみが取得できます。
APIキーの取得・管理については、適切な権限を持つユーザーにご確認ください。
:::
:::(Warning) (APIレート制限)
Freshsales APIには、APIキーの種類に応じたレート制限があります。
レート制限に達すると、HTTP 429エラーが発生し、データ転送が一時的に失敗する可能性があります。
:::
## 認証方式
- API Key
## 設定項目
|項目名|必須|説明|
|---|---|---|
|API Key|✓|Freshsalesから取得したAPIキーを入力します。
APIキーの取得方法については、[APIキーの取得](#apiキーの取得)を参照ください。|
|ホスト|✓|Freshsalesインスタンスのホスト名を入力します。
例：`https://.freshsales.io`|
## Freshsales側で必要な作業
### APIキーの取得
1. Freshsalesの管理画面にログインします。
2. 右上のプロフィールアイコンをクリックし、**Settings**を選択します。
3. 左側メニューから**API Settings**を選択します。
4. **Your API Key**欄に表示されているAPIキーをコピーします。
:::(Info) (APIキーの管理)
APIキーは機密情報です。第三者に漏洩しないよう、適切に管理してください。
また、APIキーが漏洩した場合は、Freshsalesの管理画面から新しいAPIキーを再生成できます。
:::
### 権限の確認
データ転送を実行するには、以下のデータに対する適切な権限が必要です。
- **Contacts（連絡先）**: 連絡先データの読み取り権限
- **Deals（商談）**: 商談データの読み取り権限
- **Accounts（アカウント）**: アカウントデータの読み取り権限
APIキーを取得したユーザーが、これらのデータに対する適切な権限を持っていることを確認してください。
## 困ったときには・トラブルシューティング
### APIキーが無効となっている
```text
Error: HTTP 401 Unauthorized
```
#### 考えられる原因
- APIキーが正しく入力されていない
- APIキーの取得元となったユーザーアカウントが無効になっている
- APIキーが再生成されて古いキーになっている
#### 対処方法
1. 接続情報の設定でAPIキーが正しく入力されているか確認してください。
2. Freshsalesの管理画面で、APIキーを再度確認し、必要に応じて再生成してください。
3. 新しいAPIキーを取得した場合は、接続情報の設定を更新してください。
### APIレート制限に達している
```text
Error: HTTP 429 Too Many Requests
```
#### 考えられる原因
- 短時間に多数のAPIリクエストを送信している
- 他のアプリケーションやサービスが同じAPIキーを使用している
- APIキーの種類に応じたレート制限に達している
#### 対処方法
1. しばらく時間を置いてから再度実行してください。
2. 転送頻度を調整し、APIリクエストの間隔を空けてください。
3. 他のアプリケーションでも同じAPIキーを使用している場合は、使用状況を確認し、必要に応じて専用のAPIキーを発行してください。
### ホスト名が間違っている
```text
Error: Connection failed
```
#### 考えられる原因
- ホスト名が正しく入力されていない
- HTTPSプロトコルが含まれていない
- Freshsalesインスタンスのドメインが間違っている
#### 対処方法
1. 接続情報の設定でホスト名が正しく入力されているか確認してください。
2. ホスト名には`https://`を含めて入力してください。
3. Freshsalesの管理画面のURLを確認し、正しいドメイン名を使用してください。