前提条件
- AI Helpdesk の 管理者(Admin) ロールが必要です
- LINE WORKS テナントの管理者権限が必要です
- LINE WORKS Developer Console でアプリを作成する権限が必要です
LINE WORKS 接続に必要な情報
LINE WORKS Developer Console でクライアントアプリとボットを作成し、以下の情報を用意してください。| 項目 | 取得元 |
|---|---|
| ドメイン 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 での設定
クライアントアプリの作成
- Console > Bot > Create Client App を開き、+ Add a new app をクリック
- アプリ名を入力し、Authentication App を選択して送信
-
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 - 送信後の画面で クライアント ID / クライアントシークレット / サービスアカウント / 秘密鍵(PEM) を控えます
ボットの作成
- Console > Bot > Create new Bot を開く
- ボット名、説明を入力する
-
Callback URL を有効化し、以下を設定します
- Callback URL で text / image / file を有効にする
- Bot Policy のチェックボックスを有効化する
- 保存後、詳細画面で Bot ID と Bot Secret を控えます
ワークスペースへのボット追加
LINE WORKS Admin Console で サービス > Bot > Add Bot から、作成したボットをワークスペースに追加します。 ポリシー・利用者範囲・公開設定はワークスペースの運用に合わせて構成してください。LINE WORKS を接続する
認証情報を入力する(ステップ 1)
以下の情報をすべて入力します。
- ドメイン ID
- クライアント ID
- クライアントシークレット
- サービスアカウント(形式:
serviceaccount@...) - 秘密鍵(Private Key)(PEM 形式の全文を貼り付けます)
- ボット ID
- ボットシークレット
- ワークスペース名(任意)
オブザーバーユーザーを選択する(ステップ 2)
AI Helpdesk のトークルームセッションには、メンバーが 3 人以上いる必要があります。
エンドユーザーとボットに加え、「オブザーバー」として参加するユーザーを一覧から選択してください。ユーザーを選択したら 接続 をクリックします。
認証情報の検証が成功すると、LINE WORKS テナントのユーザー一覧が表示されます。
オブザーバーは通常の運用では問い合わせ内容を閲覧しない専用アカウントを設定することを推奨します。
ボットを利用する
接続完了後、LINE WORKS ユーザーはボットとのトークルームで問い合わせができます。 ボットのトークルームにメッセージを送信すると、グループトークが自動的に作成されセッションが開始されます。LINE WORKS 接続を解除する
設定 > 連携 タブの メッセージング セクションで、切断するカードのゴミ箱アイコンをクリックしてください。トラブルシューティング
「認証情報が無効です」と表示される- ドメイン ID が数字のみであることを確認してください
- 秘密鍵が正しい PEM 形式(改行を含む全文)であることを確認してください
- LINE WORKS Developer Console でアプリが有効になっているか確認してください
- サービスアカウントに必要なスコープ(
user.readなど)が付与されているか確認してください - LINE WORKS API の利用制限に達していないか確認してください

