> ## Documentation Index
> Fetch the complete documentation index at: https://hc.saas-manager.biz.nuro.jp/llms.txt
> Use this file to discover all available pages before exploring further.

# LINE WORKS

> Instructions for integrating with LINE WORKS. This guide covers the complete process from administrator login to connecting LINE WORKS with MoneyForward Admina.

## Supported Features

<Badge color="blue">Account Deletion</Badge> <Badge color="blue">Account Deactivation</Badge> <Badge color="blue">Account Creation</Badge>

<Info>
  * Administrator account and developer privileges are required for LINE WORKS integration.
  * The procedure has been updated following the API upgrade to version 2.0. Customers who previously connected via API 1.0 should reconnect using this procedure.
  * For details on API usage, please also refer to the [LINE WORKS official documentation](https://developers.worksmobile.com/jp/reference/introduction?lang=ja). The steps for using LINE WORKS API 2.0 are as follows:
  * In the [LINE WORKS Admin Console](https://admin.worksmobile.com/), go to **Security > Administrator Permissions** to grant Developers permission to the app developer ([reference](https://guide.worksmobile.com/jp/admin/admin-guide/security/administrator-authorities/manage-administrator-authorities/)).
  * If you are unable to use the API even after granting permissions, please [contact LINE WORKS](https://line.worksmobile.com/jp/contactus/request/).
</Info>

## Prerequisites

### How to Log in to LINE WORKS Developers

Go to the [LINE WORKS Developers login page](https://developers.worksmobile.com/jp/), enter your ID and password, and log in.

<img src="https://mintcdn.com/admina-sbn/i0-ghOeF3nYQWacT/images/integrations/vh1g8tdfgn/1657071997440.png?fit=max&auto=format&n=i0-ghOeF3nYQWacT&q=85&s=f649d7c3b3a1cbbf0b826ec32a16e5cf" alt="LINE WORKS Developers login screen" width="778" height="688" data-path="images/integrations/vh1g8tdfgn/1657071997440.png" />

### How to Obtain the Workspace Key

After logging in to LINE WORKS Developers, click **Developer Console** in the upper right corner.

<img src="https://mintcdn.com/admina-sbn/i0-ghOeF3nYQWacT/images/integrations/vh1g8tdfgn/1657072392929.png?fit=max&auto=format&n=i0-ghOeF3nYQWacT&q=85&s=4a27a695151d0bfd97c206aadbd9fa45" alt="Developer Console button" width="1363" height="237" data-path="images/integrations/vh1g8tdfgn/1657072392929.png" />

The **Domain ID is displayed at the bottom of the left-side menu tab**. The **Domain ID is your workspace key** — save it.

<img src="https://mintcdn.com/admina-sbn/i0-ghOeF3nYQWacT/images/integrations/vh1g8tdfgn/1657072211044.png?fit=max&auto=format&n=i0-ghOeF3nYQWacT&q=85&s=d9bafd4a9c0cc215c38f7db47e1567eb" alt="Domain ID display" width="548" height="643" data-path="images/integrations/vh1g8tdfgn/1657072211044.png" />

### Adding an OAuth App

Click **API2.0 > Add client app** in the Developer Console.

<img src="https://mintcdn.com/admina-sbn/i0-ghOeF3nYQWacT/images/integrations/vh1g8tdfgn/1657201013447.png?fit=max&auto=format&n=i0-ghOeF3nYQWacT&q=85&s=c911efbbf73ed56e7ef15d2c109259ff" alt="Add client app button" width="2306" height="1142" data-path="images/integrations/vh1g8tdfgn/1657201013447.png" />

Enter a name for the Client app (up to 20 half-width characters) and click **Confirm**.

<img src="https://mintcdn.com/admina-sbn/i0-ghOeF3nYQWacT/images/integrations/vh1g8tdfgn/1657201158306.png?fit=max&auto=format&n=i0-ghOeF3nYQWacT&q=85&s=fc23357294e78c85028eb2cd0f6cb8a2" alt="Client app name input" width="872" height="590" data-path="images/integrations/vh1g8tdfgn/1657201158306.png" />

Enter the following values for the app client settings:

<img src="https://mintcdn.com/admina-sbn/i0-ghOeF3nYQWacT/images/integrations/vh1g8tdfgn/1657244134375.png?fit=max&auto=format&n=i0-ghOeF3nYQWacT&q=85&s=682661683b00ae8330163c7c1fb4c181" alt="App client settings screen" width="2866" height="1488" data-path="images/integrations/vh1g8tdfgn/1657244134375.png" />

* **Client app description**: Any text for description purposes.
* **Redirect URL**: Enter `https://itmc.i.moneyforward.com/oauth/callback` and click **Add**. (Be sure to click Add, or the URL will not be saved.)
* **OAuth Scopes**: Click the **Manage** button and select `user`.

After entering all values, click **Save**.

<Info>
  Depending on your plan (e.g., Free plan), the `user` scope may not be available. In that case, please refer to the Read Only integration procedure described below.
</Info>

### Obtaining the Client ID and Client Secret

Copy and save the **Client ID** and **Client Secret** for the application you created.

<img src="https://mintcdn.com/admina-sbn/i0-ghOeF3nYQWacT/images/integrations/vh1g8tdfgn/1657244897534.png?fit=max&auto=format&n=i0-ghOeF3nYQWacT&q=85&s=54175b921de097d32d1fadc2742fc8e2" alt="Client ID and Client Secret" width="2872" height="1572" data-path="images/integrations/vh1g8tdfgn/1657244897534.png" />

## Integration Setup

Search for **LINE WORKS** on the MoneyForward Admina integration screen.

<img src="https://mintcdn.com/admina-sbn/i0-ghOeF3nYQWacT/images/integrations/vh1g8tdfgn/1657073978390.png?fit=max&auto=format&n=i0-ghOeF3nYQWacT&q=85&s=657b5c45fa5fa5cb4345d3a6e996dfa3" alt="Admina search screen" width="985" height="503" data-path="images/integrations/vh1g8tdfgn/1657073978390.png" />

Enter the following values and click **Connect**.

If you are logged out of LINE WORKS Developers, a login screen will appear after clicking Connect. Enter your **administrator account ID and password** to log in and start the integration.

* **Workspace Name**: Any name (e.g., company name)
* **Workspace Key**: The **Domain ID** obtained in the previous steps
* **Client ID**: The **Client ID** obtained in the previous steps
* **Client Secret**: The **Client Secret** obtained in the previous steps

<img src="https://mintcdn.com/admina-sbn/i0-ghOeF3nYQWacT/images/integrations/vh1g8tdfgn/1690251069018.png?fit=max&auto=format&n=i0-ghOeF3nYQWacT&q=85&s=3d5ea3d0c2525961baa63197f2b15281" alt="Admina integration settings screen" width="479" height="750" data-path="images/integrations/vh1g8tdfgn/1690251069018.png" />

Once the LINE WORKS integration is successful, the registered user information will appear in the account list.

If the process does not complete successfully, click **Edit** from the Status tab on the integration screen and try connecting again.

If the issue persists, please contact us via chat.

For an overview of the LINE WORKS integration, see the [integration page](http://admina.moneyforward.com/en/integrations/line-works).

## Read Only Integration Procedure

If you are on the Free plan and the `user` scope is not available, or if you do not want to grant write or delete permissions to the OAuth app, you can use Read Only integration.

### OAuth Scope Settings

Set the OAuth Scopes to the following instead of `user`:

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

<Info>
  Read Only permissions cannot be used with scopes other than those listed above (e.g., `user`).
</Info>

<img src="https://mintcdn.com/admina-sbn/i0-ghOeF3nYQWacT/images/integrations/vh1g8tdfgn/1690250706896.png?fit=max&auto=format&n=i0-ghOeF3nYQWacT&q=85&s=8d27887a0a26254a95de4b11f48cdf82" alt="OAuth Scopes settings" width="2626" height="1408" data-path="images/integrations/vh1g8tdfgn/1690250706896.png" />

All other settings are the same as the OAuth App addition procedure described above.

### Integration Setup for Read Only

Select `Read Only` for the permission setting and click **Connect**.

<img src="https://mintcdn.com/admina-sbn/i0-ghOeF3nYQWacT/images/integrations/vh1g8tdfgn/1690250921693.png?fit=max&auto=format&n=i0-ghOeF3nYQWacT&q=85&s=82dcc38b1996a1346dbf13e5e59c73e6" alt="Read Only settings" width="950" height="1616" data-path="images/integrations/vh1g8tdfgn/1690250921693.png" />

<Info>
  With Read Only integration, account creation and deletion from Admina are not available.
</Info>
