--- articleId: d2945dc2-3270-4228-b838-f13ee4a9d0f6 slug: connection-configuration-chatwork title: 接続情報 - Chatwork parentCategoryId: 4db89ef6-4431-4a1f-a7c6-6c3b8a1a224c languageCode: ja --- 本ページでは、Chatworkに接続するための設定(接続情報)について説明します。 転送に関する設定については、[転送元 - Chatwork](/docs/data-source-chatwork)を参照ください。 ## 認証方式 - APIトークン ## 利用上の注意・制約 :::(Warning) (APIトークンの必要性) Chatwork APIを利用するには、APIトークンが必要です。APIトークンは、Chatworkの**サービス連携**画面から取得できます。また、パーソナルプラン以外をご利用の場合は、組織管理者の承認が必要です。詳細は[Chatwork公式ドキュメント](https://developer.chatwork.com/docs)を参照ください。 ::: :::(Info) (API利用規約の確認) Chatwork APIを利用する前に、[Chatwork API利用規約](https://go.chatwork.com/ja/terms/api.html)を必ず確認してください。 ::: :::(Warning) (API利用制限) Chatwork APIには、1時間あたり300リクエストまでの利用制限があります。制限を超えると、HTTP 429エラーが返され、一時的にAPIが使用できなくなります。詳細は[Chatwork公式ドキュメント - APIの利用回数制限について](https://developer.chatwork.com/docs/endpoints#api%E3%81%AE%E5%88%A9%E7%94%A8%E5%9B%9E%E6%95%B0%E5%88%B6%E9%99%90%E3%81%AB%E3%81%A4%E3%81%84%E3%81%A6)を参照ください。 ::: ## 設定項目 |項目名|必須|説明| |---|---|---| |APIトークン|✓|ChatworkのAPIトークンを入力します。
APIトークンは、Chatworkの**サービス連携**画面から取得できます。| ## Chatwork側で必要な作業 ### APIトークンの取得 1. Chatworkにログインする。 2. 右上のアカウントアイコンから**サービス連携**を選択する。 3. **APIトークン**セクションで、**新しいトークンを作成**をクリックする。 4. 作成されたAPIトークンをコピーし、TROCCOの接続情報設定画面に貼り付ける。 ### 権限の付与 #### 転送元に利用する場合 Chatworkからデータを取得するには、認証したユーザーが以下のリソースにアクセスできる権限を持っている必要があります。 - コンタクト(連絡先) - チャットルーム 認証したユーザーが閲覧できるリソースのみが転送対象となります。必要に応じて、Chatwork上でユーザーに適切な権限を付与してください。 ## 困ったときには・トラブルシューティング ### 「認証に失敗しました」というエラーが表示される #### 考えられる原因 - APIトークンが無効または期限切れになっている - APIトークンの入力が間違っている - Chatwork側でAPIアクセスが制限されている #### 対処方法 1. Chatworkの**サービス連携**画面でAPIトークンが有効か確認する。 2. 必要に応じて、新しいAPIトークンを作成する。 3. TROCCOの接続情報設定画面で、正しいAPIトークンを入力する。 4. 組織管理者の承認が必要な場合は、承認を依頼する。 ### 「データが取得できません」というエラーが表示される #### 考えられる原因 - 認証したユーザーにデータへのアクセス権限がない - 取得対象のチャットルームやコンタクトが存在しない #### 対処方法 1. Chatwork上で、認証したユーザーが必要なチャットルームやコンタクトにアクセスできるか確認する。 2. 必要に応じて、Chatwork上でユーザーに適切な権限を付与する。 3. 転送設定で指定した取得対象が正しいか確認する。