対話プラットフォーム連携：LINE WORKS
LINE WORKS は LINE の法人向けコミュニケーションツールです。連携すると、従業員は普段使っている LINE WORKS 上で AI アシスタントと直接対話でき、別のシステムを開く必要がありません。1対1のダイレクトメッセージとグループ会話の両方に対応しています。
連携前の確認事項
MaiAgent プラットフォームで「AI アシスタント」を作成済みであること
LINE WORKS の管理者権限を持っていること（Admin コンソールにログインできること）
LINE WORKS Developer Console にアクセスできること
この連携には 6 つの認証情報が必要であり、チャンネル作成後に認証情報を変更することはできません。ステップ 1 とステップ 2 を先に完了し、6 つの認証情報をすべて揃えてから、ステップ 3 に進んでください。
ステップ 1：Client App を作成して Service Account を取得する
1. Developer Console の ClientApp ページに移動する
LINE WORKS Developer Console にログインし、左側メニューで API → ClientApp をクリックしてから、Add client app をクリックして App を作成します。
2. 4 つの認証情報を取得する
App の詳細ページに移動し、以下の 4 つの情報を取得します：
Client ID
Client ID フィールド
Client Secret
Client Secret フィールド
Service Account
Service Account フィールド、形式は xxxxx.serviceaccount@お客様のドメイン
Private Key
Private Key セクション、作成時に .key ファイルとしてダウンロード可能
3. OAuth Scopes を設定する
同じページの OAuth Scopes セクションで、以下の権限を付与する必要があります。これらがないと、AI アシスタントはメッセージの送受信やメンバー名の検索ができません：
bot
Bot の管理
bot.message
メッセージの送信
bot.read
Bot 設定の読み取り
user.read
メンバー情報の読み取り（会話中に発言者の名前を表示するために使用）
Private Key は一度しかダウンロードできません。 Service Account 作成時に .key ファイルがダウンロード用に提供されます。ページを離れると再取得できません。安全に保管してください。紛失した場合は再生成するしかありませんが、再生成すると既存の連携がただちに無効になります。
秘密鍵は暗号化されていない PEM 形式である必要があります：最初の行は BEGIN PRIVATE KEY または BEGIN RSA PRIVATE KEY マーカー（前後にハイフンが 5 つずつ）、最後の行は対応する END マーカーです。秘密鍵がパスワードで保護されている場合、MaiAgent では使用できませんので、暗号化されていない鍵を再生成してください。
ステップ 2：Bot を作成して Bot ID と Bot Secret を取得する
Developer Console の左側メニューで Bot をクリックし、Bot を作成して以下を取得します：
Bot ID
Bot ID フィールド
Bot Secret
Bot Secret フィールド、LINE WORKS から送られたメッセージが確かにお客様の Bot からのものであることを検証するために使用
グループ会話に必要な設定
Bot の 修正 ページで Bot ポリシー → チャットルームへの参加 を見つけ、チーム/グループ、1:N チャットルームへの招待を許可する にチェックを入れます。
チェックを入れていない場合、Bot は 1 対 1 のダイレクトメッセージのみに対応し、グループに招待することはできません。
Bot 詳細ページの Bot ポリシー のサマリーテキストが、修正フォームの実際のチェック状態と一致しない場合があることが確認されています。2 つの表示が異なる場合は、修正 フォームのチェック状態を正としてください。
Bot 名もこのページで設定します。この名前はグループ内でユーザーが Bot を @ メンションする際に入力する名前になりますので、入力しやすい名前を付けてください。
ステップ 3：MaiAgent で LINE WORKS チャンネルを作成する
1. 対話プラットフォーム連携ページに移動する
MaiAgent の左側メニューで 対話プラットフォーム をクリックし、右上の 対話プラットフォーム連携 をクリックして、LINE WORKS を選択します。
2. 基本設定を入力する
名前
この連携に名前を付けます（必須）。これは MaiAgent 側のラベルにすぎず、LINE WORKS に表示される Bot 名とは関係ありません。
AI アシスタント
バインドする AI アシスタントを選択
Bot ID
ステップ 2 で取得（必須）
Bot Secret
ステップ 2 で取得（必須）
Client ID
ステップ 1 で取得（必須）
Client Secret
ステップ 1 で取得（必須）
Service Account
ステップ 1 で取得（必須）
Private Key
ステップ 1 でダウンロードした .key ファイルの全内容を、開始行と終了行を含めて貼り付けます（必須）
フォームは上下 2 つのセクションに分かれています。上部セクションには名前、AI アシスタント、およびステップ 2 で取得した Bot ID と Bot Secret が含まれます：
下にスクロールすると、ステップ 1 で取得した Client App の 3 つの認証情報と秘密鍵があります：
3. チャットルーム設定
グループで @Bot が必要
有効にすると、Bot はグループ会話で @ メンションされた場合のみ返信します。グループで使用する場合はオンにすることを推奨します。オフの場合、グループ内のすべてのメッセージが AI アシスタントの返信をトリガーします。
リセットコマンドを有効にする
有効にすると、キーワードをカスタマイズでき、ユーザーがそのキーワードを入力すると会話メモリがクリアされ、最初からやり直すことができます。
4. 連携テスト
連携テスト をクリックします。MaiAgent が実際に LINE WORKS からアクセストークンを取得し、認証情報の組み合わせが正しいことを確認します。
失敗時は画面に具体的な理由が表示されます。よくある 2 つのケース：
認証情報の検証に失敗しました — 次の点を順に確認してください：Private Key が完全に貼り付けられているか（開始行と終了行を含み、途中の改行が欠落していないか）、暗号化されていない形式か、Service Account が完全か（
.serviceaccount@ドメインの後半部分を含む）、Client ID と Client Secret が同じ App のものか、App にステップ 1 で示した 4 つの Scope が付与されているかこの Bot ID はすでに他の受信トレイにバインドされています — 同じ Bot を 2 つのチャンネルに同時に接続することはできません。別の Bot を使用するか、既存のチャンネルを先に削除してください
失敗メッセージはボタンの左側に表示されます：
5. Webhook URL を作成してコピーする
対話プラットフォーム連携 をクリックして作成を完了します。システムが Webhook URL を生成しますので、コピーしておいてください。次のステップで Developer Console に貼り付けます。
チャンネルの設定ページにいつでも戻り、API 連携 フィールドからこの URL をコピーすることもできます。
ステップ 4：Developer Console に戻って Callback URL を設定する
ステップ 2 で作成した Bot に戻り、修正 ページを開きます：
Callback URL を On に設定し、MaiAgent が生成した Webhook URL を入力します
Callback Event Settings で受信するイベントにチェックを入れます。AI アシスタントがあらゆる種類のメッセージを処理できるように、Message Event 配下のすべてにチェックを入れることを推奨します：
TEXT
テキストメッセージの送信
写真
画像の送信
ファイル
ファイルの送信
音声
音声メッセージの送信
動画
動画の送信
位置共有
位置情報の共有
スタンプ
スタンプの送信
グループで使用する場合は、Join Event と Joined Event にもチェックを入れることを推奨します
設定を保存します
チェックを入れていないイベントタイプは LINE WORKS から MaiAgent に送信されません。該当するメッセージは発生しなかったかのように扱われ、AI アシスタントは返信せず、会話にも記録が残りません。
ステップ 5：Admin コンソールで Bot を有効化する
LINE WORKS Admin コンソールにログインし、左側の サービス → Bot で右上の Bot を追加 をクリックして、ステップ 2 で作成した Bot を追加します。
追加後、このページに Bot が一覧表示され、使用権限 列でどのメンバーに Bot を表示するかを設定できます（全員 に設定すると全メンバーが使用可能）。
このステップは見落としやすいです。Developer Console で Bot を作成しただけでは、従業員の LINE WORKS にはまだ表示されません。テナント管理者が Admin コンソールで追加して初めて、従業員が Bot を検索できるようになります。
使い方
1 対 1 ダイレクトメッセージ
LINE WORKS で Bot 名を検索して会話を開始します。AI アシスタントが自動的に返信します。
グループ会話
Bot をグループに招待します。「グループで @Bot が必要」が有効な場合、@Bot名 質問内容 と入力すると返信がトリガーされます。
MaiAgent のすべての対話では、同じグループが1 つの会話として表示され、発言者の名前がメッセージに表示されます。グループ内で複数のユーザーが発言しても、複数の並列会話に分かれることはありません。
対応メッセージタイプ
テキスト
直接返信
画像
画像の内容を認識可能
ファイル（PDF、Excel、Word など）
内容を読み取り、関連する質問に回答
音声メッセージ
テキストに変換してから処理
動画
添付ファイルとして保存し、会話に記録
位置情報
「📍 位置情報を共有しました」と表示
スタンプ
「🏷 スタンプ」と表示
AI アシスタントの返信ではテキストと添付ファイルに対応しています。1 件のテキストメッセージが LINE WORKS の 1,000 文字制限を超えた場合、システムが自動的に分割して送信します。メッセージが途中で切れることはありません。
よくある質問
AI アシスタントが突然返信しなくなった
まず、チャンネルの設定ページで認証情報が無効になりましたの警告が表示されていないか確認してください。
認証情報の無効化の最も一般的な原因は、Developer Console で秘密鍵または Service Account を再生成したことです。古い認証情報が置き換えられると、MaiAgent はアクセストークンを取得できなくなります。
認証情報はその場で変更できないため、新しい LINE WORKS チャンネルを作成し、新しい認証情報を入力してください。
なぜ認証情報を変更できないのですか？
認証情報は機密データです。MaiAgent は保存後にフロントエンドに返送することはなく、設定ページでも変更を受け付けません。これは、送信時や画面上での認証情報の繰り返しの露出を避けるためです。Bot ID、Client ID、Service Account は読み取り専用で表示されるため、現在接続されている Bot を確認できます。
認証情報のいずれかを変更する必要がある場合は、このチャンネルを削除して新しく作成してください。
グループで Bot を @ メンションしたが反応がない
@ の名前が MaiAgent の受信トレイ名ではなく、Developer Console の Bot 名 と一致していることを確認してください
Bot の修正ページの Bot ポリシー → チャットルームへの参加 で チーム/グループ、1:N チャットルームへの招待を許可する にチェックが入っていることを確認してください
Callback Event Settings で TEXT にチェックが入っていることを確認してください
定期的にトークンを更新する必要がありますか？
必要ありません。MaiAgent は Service Account 方式で認証を行い、アクセストークンはシステムによって自動的に発行・更新されます。時間の経過によって期限切れになることはありません。Developer Console の認証情報が再生成されていない限り、連携は有効なままです。
最終更新
役に立ちましたか？