> ## 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 連携

> AI Helpdesk と LINE WORKS を接続し、LINE WORKS からボットに問い合わせを送信する手順を説明します。

AI Helpdesk の LINE WORKS 連携を設定すると、LINE WORKS のトークルームから AI ボットに問い合わせを送信できるようになります。

## 前提条件

<Info>
  * AI Helpdesk の **管理者（Admin）** ロールが必要です
  * LINE WORKS テナントの管理者権限が必要です
  * LINE WORKS Developer Console でアプリを作成する権限が必要です
</Info>

## LINE WORKS 接続に必要な情報

[LINE WORKS Developer Console](https://dev.worksmobile.com/jp/console/openapi/v2/app/list/view) でクライアントアプリとボットを作成し、以下の情報を用意してください。

| 項目                   | 取得元                                                     |
| -------------------- | ------------------------------------------------------- |
| **ドメイン ID**          | LINE WORKS Developer Console のホーム画面に表示されるドメイン ID（数字）    |
| **クライアント ID**        | クライアントアプリの **App Information**                          |
| **クライアントシークレット**     | クライアントアプリの **App Information**                          |
| **サービスアカウント**        | クライアントアプリの **App Information**（`serviceaccount@...` 形式） |
| **秘密鍵（Private Key）** | クライアントアプリの **App Information**（PEM 形式の RSA 秘密鍵）         |
| **ボット ID**           | LINE WORKS Developers に登録したボットの Bot ID（数字）              |
| **ボットシークレット**        | ボットの Bot Secret                                         |
| **ワークスペース名**（任意）     | AI Helpdesk 上での表示名                                      |

## LINE WORKS Developer Console での設定

### クライアントアプリの作成

1. **Console > Bot > Create Client App** を開き、**+ Add a new app** をクリック

2. アプリ名を入力し、**Authentication App** を選択して送信

3. **App Information** で以下を設定します

   | 項目                               | 値                                             |
   | -------------------------------- | --------------------------------------------- |
   | **App access permissions**       | All members                                   |
   | **Access Token expiration date** | 1 hour                                        |
   | **Refresh Token Rotation**       | On                                            |
   | **OAuth Scopes**                 | `bot`, `bot.message`, `bot.read`, `user.read` |

4. 送信後の画面で **クライアント ID** / **クライアントシークレット** / **サービスアカウント** / **秘密鍵（PEM）** を控えます

### ボットの作成

1. **Console > Bot > Create new Bot** を開く

2. ボット名、説明を入力する

3. **Callback URL** を有効化し、以下を設定します

   ```text theme={null}
   https://assist.i.moneyforward.com/chat/lineworks
   ```

4. Callback URL で **text** / **image** / **file** を有効にする

5. **Bot Policy** のチェックボックスを有効化する

6. 保存後、詳細画面で **Bot ID** と **Bot Secret** を控えます

### ワークスペースへのボット追加

[LINE WORKS Admin Console](https://admin.worksmobile.com/) で **サービス > Bot > Add Bot** から、作成したボットをワークスペースに追加します。
ポリシー・利用者範囲・公開設定はワークスペースの運用に合わせて構成してください。

## LINE WORKS を接続する

<Steps>
  <Step title="連携設定を開く">
    左のナビゲーションから **設定** を選択し、**連携** タブを開きます。
    **メッセージング** セクションで **接続を追加** ボタンをクリックし、**LINE WORKS — カスタムボット** を選択します。

    {/* TODO(image): ![スクリーンショット: 設定 > 連携 > LINE WORKS 選択](/images/ai-helpdesk/placeholder.png) */}
  </Step>

  <Step title="認証情報を入力する（ステップ 1）">
    以下の情報をすべて入力します。

    * **ドメイン ID**
    * **クライアント ID**
    * **クライアントシークレット**
    * **サービスアカウント**（形式: `serviceaccount@...`）
    * **秘密鍵（Private Key）**（PEM 形式の全文を貼り付けます）
    * **ボット ID**
    * **ボットシークレット**
    * **ワークスペース名**（任意）

    <Warning>
      秘密鍵は `-----BEGIN RSA PRIVATE KEY-----` から `-----END RSA PRIVATE KEY-----` まで改行を含めて全文を貼り付けてください。
    </Warning>

    すべて入力したら **次へ** をクリックします。
    入力された認証情報を検証するため、LINE WORKS API への確認が行われます。

    {/* TODO(image): ![スクリーンショット: LINE WORKS 接続ダイアログ（認証情報入力）](/images/ai-helpdesk/placeholder.png) */}
  </Step>

  <Step title="オブザーバーユーザーを選択する（ステップ 2）">
    AI Helpdesk のトークルームセッションには、メンバーが 3 人以上いる必要があります。
    エンドユーザーとボットに加え、「オブザーバー」として参加するユーザーを一覧から選択してください。

    <Note>
      認証情報の検証が成功すると、LINE WORKS テナントのユーザー一覧が表示されます。
      オブザーバーは通常の運用では問い合わせ内容を閲覧しない専用アカウントを設定することを推奨します。
    </Note>

    ユーザーを選択したら **接続** をクリックします。

    {/* TODO(image): ![スクリーンショット: LINE WORKS 接続ダイアログ（オブザーバー選択）](/images/ai-helpdesk/placeholder.png) */}
  </Step>

  <Step title="接続完了を確認する">
    接続が成功すると、**メッセージング** セクションに LINE WORKS のカードが表示されます。
    カードにはドメイン ID と接続済みのステータスが表示されます。

    {/* TODO(image): ![スクリーンショット: 接続済み LINE WORKS カード](/images/ai-helpdesk/placeholder.png) */}
  </Step>
</Steps>

## ボットを利用する

接続完了後、LINE WORKS ユーザーはボットとのトークルームで問い合わせができます。

ボットのトークルームにメッセージを送信すると、グループトークが自動的に作成されセッションが開始されます。

## LINE WORKS 接続を解除する

**設定 > 連携** タブの **メッセージング** セクションで、切断するカードのゴミ箱アイコンをクリックしてください。

<Warning>
  接続を解除すると、その LINE WORKS テナントからの問い合わせは受け付けられなくなります。
</Warning>

## トラブルシューティング

**「認証情報が無効です」と表示される**

* ドメイン ID が数字のみであることを確認してください
* 秘密鍵が正しい PEM 形式（改行を含む全文）であることを確認してください
* LINE WORKS Developer Console でアプリが有効になっているか確認してください

**ユーザー一覧が表示されない**

* サービスアカウントに必要なスコープ（`user.read` など）が付与されているか確認してください
* LINE WORKS API の利用制限に達していないか確認してください