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