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

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

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

## 前提条件

> [!NOTE]
>
> * AIヘルプデスクの **管理者（Admin）** ロールが必要です
> * LINE WORKS テナントの管理者権限が必要です
> * LINE WORKS Developer Console でアプリを作成する権限が必要です

## 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ヘルプデスク上での表示名 |

## 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 を接続する

**1. 連携設定を開く**

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

**2. 認証情報を入力する（ステップ 1）**

以下の情報をすべて入力します。

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

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

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

**3. オブザーバーユーザーを選択する（ステップ 2）**

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

> [!NOTE]
>
> 認証情報の検証が成功すると、入力したドメイン ID のドメインに所属するユーザーの一覧が表示されます。
> オブザーバーは通常の運用では問い合わせ内容を閲覧しない専用アカウントを設定することを推奨します。
> オブザーバーに設定したアカウントから送ったメッセージには、ボットは応答しません。オブザーバーはすべてのトークルームに固定で参加するメンバーであり、問い合わせの依頼者にはならないためです。問い合わせをするユーザーとは別の専用アカウントを設定してください。

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

**4. 接続完了を確認する**

接続が成功すると、**メッセージング** セクションに LINE WORKS の行が表示されます。
行にはドメイン ID と接続済みのステータスが表示されます。

## ボットを利用する

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

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

セッションやチケットの依頼者名には、LINE WORKS のディレクトリに登録されている氏名が表示されます。氏名を取得できない場合（`user.read` スコープを付与していない場合など）は、LINE WORKS のユーザーIDが表示されます。

## LINE WORKS 接続を解除する

**設定 > 連携** タブの **メッセージング** セクションで、切断する接続の行のメニュー（**…**）から **切断** をクリックします。
確認ダイアログで **切断** をクリックしてください。

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

## 添付できる画像・ファイル

従業員は問い合わせに画像やファイルを添付して、内容を見て回答してもらえます。

| 種類 | 対応形式 | 上限 |
| - | - | - |
| 画像 | PNG・JPEG・GIF・WebP | 1枚あたり 10MB、1メッセージ 10枚 |
| ファイル | TXT・MD・CSV・JSON・XML・YAML・LOG・INI・SH などのテキストファイルやコードファイル、PDF | テキストファイル 1MB、PDF 5MB、1メッセージ 3ファイル |

AI が内容を読む画像は、会話全体で新しいものから 20 枚までです。1 枚 3.75MB を超える画像は、保存はされますが AI は読めません。

対応していない形式（DOCX・XLSX・PPTX などの Office ファイルや ZIP などのバイナリファイル）やサイズを超過したファイルは読み取れません。その場合は、どのファイルを処理できなかったかを AI が回答の中で案内します。

ナレッジに画像が含まれる場合、Bot は画像を回答に添付します（1メッセージにつき画像1枚）。画像を添付できるのは、ネイティブ（Admina に登録したナレッジ）と Notion 連携のドキュメントだけです。

オペレーターが Web の返信欄から添付した画像・ファイルは、返信とは別のメッセージで、1 件ずつファイルとして届きます（[返信欄からの添付](https://support.i.moneyforward.com/ai-helpdesk/operations/tickets.md#reply-attachments)）。

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

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

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

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

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

**オブザーバーにしたいユーザーが一覧に表示されない**

ユーザー一覧には、ステップ 1 で入力したドメイン ID のドメインに所属するユーザーだけが表示されます。別のドメインに所属するユーザーは表示されません。また、一覧に表示できるのは一度に 100 人までです。

* 対象のユーザーが、入力したドメイン ID のドメインに所属しているか確認してください
* 一覧の上の検索欄に名前またはメールアドレスを入力して、ユーザーを絞り込んでください

**オブザーバーに設定したアカウントで問い合わせてもボットが応答しない**

オブザーバーに設定したアカウントから送ったメッセージには、ボットは応答しません。オブザーバーはすべてのトークルームに固定で参加するメンバーであり、問い合わせの依頼者にはならないためです。

* 問い合わせは、オブザーバー以外のアカウントから送ってください
* 問い合わせに使っているアカウントをオブザーバーにしている場合は、**設定 > 連携** タブの **メッセージング** セクションで、接続の行のメニュー（**…**）からオブザーバーを別のユーザーに設定し直してください

**接続済みになっているのにボットが反応しない**

* AIヘルプデスクに入力した **ボットシークレット** が、LINE WORKS Developer Console のボットの Bot Secret と一致しているか確認してください。一致しない場合、LINE WORKS からのメッセージは受け付けられません
* Callback URL の設定、**text** / **image** / **file** の有効化、Admin Console でのワークスペースへのボット追加が、上の「LINE WORKS Developer Console での設定」のとおりになっているか確認してください
* 複数人のグループトークでは、ボットをメンションしたメッセージにだけ応答します
* 作成済みのトークルームからボットが削除されている場合や、トークルームが存在しない場合、ボットはそのトークルームに投稿できません。ボットとのトークルームから、新しく問い合わせてください


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.