> ## Documentation Index
> Fetch the complete documentation index at: https://support.i.moneyforward.com/llms.txt
> Use this file to discover all available pages before exploring further.

# チャネルトーク

> チャネルトークとの連携の手順です。

<Info>
  ご利用には有償プランの契約が必要になります。
</Info>

## 事前準備

### チャネルトークへのログイン方法

[チャネルトークログインページ](https://desk.channel.io/#/signin)にて、**メールアドレス・パスワード**を入力し、ログインします。

<img src="https://mintcdn.com/moneyforwardi/UxP4XsmkLgMFT8qv/images/integrations/p8eshern4d/1656321539422-image.png?fit=max&auto=format&n=UxP4XsmkLgMFT8qv&q=85&s=9c6bd254383600407265326810e54a64" alt="チャネルトークログイン画面" width="590" height="624" data-path="images/integrations/p8eshern4d/1656321539422-image.png" />

### ワークスペースキーの取得方法

チャネルトークにログイン後、URLの一部が**ワークスペースキー**となるので、保存しておきます。

[https://desk.channel.io/#/channels/\`\{ワークスペースキー}\`/team\_chats/groups/](https://desk.channel.io/#/channels/`\{ワークスペースキー}`/team_chats/groups/)...

### クライアントIDとクライアントシークレットの取得方法

1. 画面左側のサイドメニューより、チャネル設定 > セキュリティ・開発 > API管理 > \[＋新しい認証キーを作成]をクリックします。<br />
   詳細は[Authentication（外部サイト）](https://developers.channel.io/ja/articles/Authentication-20516f31)をご参照ください。

   <img src="https://mintcdn.com/moneyforwardi/QUeIGJt1APh3rJ9G/images/integrations/p8eshern4d/1784667165982-api-menu.png?fit=max&auto=format&n=QUeIGJt1APh3rJ9G&q=85&s=0e87197b3c0bc623ffb80b6b9a0d2f74" alt="API管理画面で新しい認証キーを作成する" width="1920" height="913" data-path="images/integrations/p8eshern4d/1784667165982-api-menu.png" />

2. **API認証キーを作成**の画面が表示されるので、認証キーの名前を入力し、確認をクリックします。

   <img src="https://mintcdn.com/moneyforwardi/UxP4XsmkLgMFT8qv/images/integrations/p8eshern4d/1640404963976-clean-shot-2021-10-14-at-1-48-132-x.png?fit=max&auto=format&n=UxP4XsmkLgMFT8qv&q=85&s=3971ef833bd2406853b87ee0eb680a89" alt="API認証キー作成画面" width="960" height="385" data-path="images/integrations/p8eshern4d/1640404963976-clean-shot-2021-10-14-at-1-48-132-x.png" />

3. API認証キーが作成されます。**Access Key と Access Secret** が**クライアントIDとクライアントシークレット**になるので、保存しておきます。

   <img src="https://mintcdn.com/moneyforwardi/UxP4XsmkLgMFT8qv/images/integrations/p8eshern4d/1640404983243-clean-shot-2021-10-14-at-1-48-302-x.png?fit=max&auto=format&n=UxP4XsmkLgMFT8qv&q=85&s=495f2363f240d0f9494bf6abfa3d5b3f" alt="Access KeyとAccess Secret" width="1060" height="654" data-path="images/integrations/p8eshern4d/1640404983243-clean-shot-2021-10-14-at-1-48-302-x.png" />

## インテグレーションのセットアップ

1. インテグレーション画面にて、**チャネルトーク**で検索します。

2. 前の手順で取得した**ワークスペースキー、クライアントIDとクライアントシークレット**を入力し、**連携する**をクリックします。

   <img src="https://mintcdn.com/moneyforwardi/UxP4XsmkLgMFT8qv/images/integrations/p8eshern4d/1646385581985-2022-03-04-181931.png?fit=max&auto=format&n=UxP4XsmkLgMFT8qv&q=85&s=0a13dabb0aa6ca07ff22bad8e026fe27" alt="連携情報入力画面" width="480" height="579" data-path="images/integrations/p8eshern4d/1646385581985-2022-03-04-181931.png" />

3. チャネルトークの連携が成功すると、アカウント一覧に登録済みのユーザー情報が表示されます。正常に完了しない場合は、まず [SaaSとの連携に失敗する場合の対処法](/it-management/saas-management/93nahw45is-trouble) に記載のステップをお試しください。それでも解決しない場合は、[ご提供いただきたい情報](/it-management/saas-management/93nahw45is-trouble#info-to-provide) をご確認のうえ、[サポート窓口](/contact-support)までお問い合わせください。

#### FAQ

##### Q. 連携時に使用するワークスペースキーを確認する方法はありますか？

A. 発行済みキーで以下を実行し、返る`channel.id`がワークスペースキーです。確認した値を「ワークスペースキー」欄に入力してください。

**Mac / Linux（Terminal / cURL）**

```bash theme={null}
curl -X GET https://api.channel.io/open/v5/channel \
 -H "x-access-key: YOUR_ACCESS_KEY" \
 -H "x-access-secret: YOUR_ACCESS_SECRET"
```

標準的なcURLコマンドです。改行には \（バックスラッシュ）を使用します。

**Windows（PowerShell）**

```powershell theme={null}
$headers = @{
 "x-access-key" = "YOUR_ACCESS_KEY"
 "x-access-secret" = "YOUR_ACCESS_SECRET"
}

Invoke-RestMethod -Uri "https://api.channel.io/open/v5/channel" -Method Get -Headers $headers
```

Windows標準のPowerShell環境に最も適した記法です。

**Windows（コマンドプロンプト / cmd）**

```cmd theme={null}
curl -X GET https://api.channel.io/open/v5/channel ^
 -H "x-access-key: YOUR_ACCESS_KEY" ^
 -H "x-access-secret: YOUR_ACCESS_SECRET"
```

従来型のコマンドプロンプトで実行する場合、改行には ^（キャレット）を使用します。

<Info>
  **パラメータの設定と注意事項**

  * `YOUR_ACCESS_KEY`：ご自身の**アクセスキー**（チャネルトークン）に置き換えてください。
  * `YOUR_ACCESS_SECRET`：ご自身の**シークレットキー**に置き換えてください。
  * APIキーなどの認証情報は安全に管理し、外部に公開しないようご注意ください。
</Info>