> ## 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との連携方法です。マネーフォワードAdminaから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" />

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

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" />

**左側メニュータブの一番下に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の追加

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

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

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

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

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

<img src="https://mintcdn.com/moneyforwardi/y2OjA73vF7oOzEyJ/images/integrations/vh1g8tdfgn/1657244134375.png?fit=max&auto=format&n=y2OjA73vF7oOzEyJ&q=85&s=f615a159679bd164b57987496347fe46" 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` を選択します。

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

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

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

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

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

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

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

<img src="https://mintcdn.com/moneyforwardi/y2OjA73vF7oOzEyJ/images/integrations/vh1g8tdfgn/1657073978390.png?fit=max&auto=format&n=y2OjA73vF7oOzEyJ&q=85&s=9615b0bf1e46e9a17cad5578ad4685fb" alt="Admina検索画面" width="985" height="503" data-path="images/integrations/vh1g8tdfgn/1657073978390.png" />

以下の値をそれぞれ入力し、**連携する**をクリックします。

LINE WORKS Developersをログアウトしている場合、連携するをクリック後にログイン画面が出るので

**管理者アカウントのID・パスワード**を入力しログインすると連携が開始されます。

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

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

LINE WORKSとの連携に成功すると、アカウント一覧に登録済みのユーザー情報が表示されます。

正常に完了しない場合は、インテグレーション画面のステータスタブから**編集**し、再度連携をお試しください。

解決しない場合はチャットにてお問い合わせください。

LINE WORKSの連携概要については[連携ページ](http://admina.moneyforward.com/jp/integrations/line-works)をご覧ください。

## 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/y2OjA73vF7oOzEyJ/images/integrations/vh1g8tdfgn/1690250706896.png?fit=max&auto=format&n=y2OjA73vF7oOzEyJ&q=85&s=977c21b591b293419def681e5aeb0b5c" alt="OAuth Scopes設定" width="2626" height="1408" data-path="images/integrations/vh1g8tdfgn/1690250706896.png" />

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

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

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

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

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