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

# LINE WORKS

> LINE WORKSとの連携方法です。LINE WORKSへの、管理者のログインから、連携方法まで一連の手順を解説します。

## サポートする機能

<Badge color="blue">アカウント削除</Badge> <Badge color="blue">アカウント無効化</Badge> <Badge color="blue">アカウント作成</Badge>

<Info>
  * 連携には、LINE WORKSの管理者アカウントおよび開発者権限が必要です。
  * APIが2.0に更新されたことに伴い、手順を更新いたしました。以前API1.0で連携されたお客様は本手順で再度連携ください。
  * APIの利用詳細については[Lineworks社公式](https://developers.worksmobile.com/jp/reference/introduction?lang=ja)もご覧ください。LINE WORKS API 2.0 を利用する手順は、下記の通りです。
  * 「[LINE WORKS管理者画面](https://admin.worksmobile.com/) > セキュリティ > 管理者権限」でアプリ開発者にDevelopers権限を付与（[参考](https://guide.worksmobile.com/jp/admin/admin-guide/security/administrator-authorities/manage-administrator-authorities/)）
  * 権限を付与してもAPIを利用できない場合、[LINE WORKSへお問い合わせ](https://line.worksmobile.com/jp/contactus/request/)ください。
</Info>

## 事前準備

### LINE WORKS Developersへのログイン方法

[LINE WORKS Developersログインページ](https://developers.worksmobile.com/jp/)にて、ID・パスワードを入力し、ログインします。

<img src="https://mintcdn.com/moneyforwardi/y2OjA73vF7oOzEyJ/images/integrations/vh1g8tdfgn/1657071997440.png?fit=max&auto=format&n=y2OjA73vF7oOzEyJ&q=85&s=319273dedfee9f99b675a2c2ec226bf3" alt="LINE WORKS Developersログイン画面" width="778" height="688" data-path="images/integrations/vh1g8tdfgn/1657071997440.png" />

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

1. LINE WORKS Developersへログイン後、画面右上の**Developer Console**をクリックします。

   <img src="https://mintcdn.com/moneyforwardi/y2OjA73vF7oOzEyJ/images/integrations/vh1g8tdfgn/1657072392929.png?fit=max&auto=format&n=y2OjA73vF7oOzEyJ&q=85&s=9df95069faac14f716a1c60d5ead8be4" alt="Developer Consoleボタン" width="1363" height="237" data-path="images/integrations/vh1g8tdfgn/1657072392929.png" />

2. **左側メニュータブの一番下にDomain ID**が表示されています。**Domain IDがワークスペースキー**となるので、保存します。

   <img src="https://mintcdn.com/moneyforwardi/y2OjA73vF7oOzEyJ/images/integrations/vh1g8tdfgn/1657072211044.png?fit=max&auto=format&n=y2OjA73vF7oOzEyJ&q=85&s=d7dca57d475218be204eab0003016f23" alt="Domain ID表示" width="548" height="643" data-path="images/integrations/vh1g8tdfgn/1657072211044.png" />

### OAuth Appの追加

1. **Developer Console の API2.0 > Add client app を**クリックします。

   <img src="https://mintcdn.com/moneyforwardi/tMe7Ck7tZsW3yk90/images/integrations/vh1g8tdfgn/1657201013447.png?fit=max&auto=format&n=tMe7Ck7tZsW3yk90&q=85&s=76b2ccdc82c427ec1c8ca3a279b6dea7" alt="Add client appボタン" width="1920" height="951" data-path="images/integrations/vh1g8tdfgn/1657201013447.png" />

2. Client app の名前（半角20文字以内の任意の文字）を入力し、**Confirm**をクリックします。

   <img src="https://mintcdn.com/moneyforwardi/RdJaHJdvCZdlODVw/images/integrations/vh1g8tdfgn/1657201158306.png?fit=max&auto=format&n=RdJaHJdvCZdlODVw&q=85&s=a503ddc73ce2748bfc6028ed22c64f0b" alt="Client app名前入力" width="872" height="590" data-path="images/integrations/vh1g8tdfgn/1657201158306.png" />

3. app clientの次の値を、それぞれ以下のとおり入力します。

   <img src="https://mintcdn.com/moneyforwardi/RdJaHJdvCZdlODVw/images/integrations/vh1g8tdfgn/1657244134375.png?fit=max&auto=format&n=RdJaHJdvCZdlODVw&q=85&s=58a1ec8f2c5b3a8a2838dc92bfdb5c43" alt="app client設定画面" width="2866" height="1488" data-path="images/integrations/vh1g8tdfgn/1657244134375.png" />

   * \*\*Client app description：\*\*説明用の文章です。任意の文字を入力します。
   * Redirect URL：`https://itmc.i.moneyforward.com/oauth/callback`と入力し、**Add**をクリックします。（Addを押し忘れると入力されないためご注意ください）
   * OAuth Scopes：**Manage** ボタンをクリックし、`user` を選択します。

4. 入力後、Saveをクリックし、保存します。

   <Info>
     Freeプランなどご利用のプランによっては、`user`スコープがご利用できません。その場合、後述するRead Onlyでの連携手順をご覧ください。
   </Info>

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

作成したアプリケーションの**Client ID**および**Client Secret**をコピーして保存しておきます。

<img src="https://mintcdn.com/moneyforwardi/RdJaHJdvCZdlODVw/images/integrations/vh1g8tdfgn/1657244897534.png?fit=max&auto=format&n=RdJaHJdvCZdlODVw&q=85&s=6cc347d52e0f940ba039a39b99421e66" alt="Client IDとClient Secret" width="2872" height="1572" data-path="images/integrations/vh1g8tdfgn/1657244897534.png" />

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

1. インテグレーション画面にて、**LINE WORKS**で検索します。

2. 以下の値をそれぞれ入力し、**連携する**をクリックします。
   LINE WORKS Developersをログアウトしている場合、連携するをクリック後にログイン画面が出るので
   **管理者アカウントのID・パスワード**を入力しログインすると連携が開始されます。

   * ワークスペース名\*\*：任意の名称\*\*（会社名など）
   * ワークスペースキー：前の手順で取得した**Domain ID**
   * クライアントID：前の手順で取得した**Client ID**
   * クライアントシークレット：前の手順で取得した**Client Secret**

   <img src="https://mintcdn.com/moneyforwardi/RdJaHJdvCZdlODVw/images/integrations/vh1g8tdfgn/1690251069018.png?fit=max&auto=format&n=RdJaHJdvCZdlODVw&q=85&s=910dca8d9d6ffa383c0be09aafb342ac" alt="連携設定画面" width="479" height="750" data-path="images/integrations/vh1g8tdfgn/1690251069018.png" />

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

## Read Onlyでの連携手順

Freeプランをご利用の場合でUserスコープをご利用いただけない場合、または、書き込みや削除権限などをOAuthアプリへ付与したくない場合は、Read Onlyでの連携が可能です。

### OAuthスコープの設定

OAuth Scopesのスコープをuserの代わりに以下の通り設定します。

* `user.email.read`
* `user.profile.read`
* `user.read`

<Info>
  `user`など上記の以外のスコープを設定して、Read Only 権限は利用できません。
</Info>

<img src="https://mintcdn.com/moneyforwardi/RdJaHJdvCZdlODVw/images/integrations/vh1g8tdfgn/1690250706896.png?fit=max&auto=format&n=RdJaHJdvCZdlODVw&q=85&s=2111aaeb5ee248c15281b87806a2c02f" alt="OAuth Scopes設定" width="2626" height="1408" data-path="images/integrations/vh1g8tdfgn/1690250706896.png" />

その他は、前述のOAuthAppの追加と同様に設定します。

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

1. パーミッションを　`Read Only`を選択し、**連携する**をクリックします。

   <img src="https://mintcdn.com/moneyforwardi/RdJaHJdvCZdlODVw/images/integrations/vh1g8tdfgn/1690250921693.png?fit=max&auto=format&n=RdJaHJdvCZdlODVw&q=85&s=4bf208f2e0a9cdedc614c4cb1f6abd59" alt="Read Only設定" width="950" height="1616" data-path="images/integrations/vh1g8tdfgn/1690250921693.png" />

   <Info>
     Read Onlyでの連携の場合、アカウント追加・削除は行えません。
   </Info>
