> ## Documentation Index
> Fetch the complete documentation index at: https://cogno.studio/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# LINE WORKSをCognoに連携する

> LINE WORKS Botを接続し、会話をProjectに割り当てて、ルームやDMでCognoから返信します。

![LINE WORKS](https://mintcdn.com/genaxis/zRS5HyVJ0PpwYnLV/images/integrations/lineworks.svg?fit=max\&auto=format\&n=zRS5HyVJ0PpwYnLV\&q=85\&s=f1b7a0644d8f1dd4e2fcfa81fd2ef649)

## 概要

| | |
| - | - |
| **方向** | Projectに接続したルームとDMで双方向に連携します。 |
| **接続方法** | LINE WORKSのClientAppのClient IDとClient Secretを使います。 |
| **設定できる人** | セキュリティ管理権限を持つWorkspace管理者。 |
| **必要なもの** | LINE WORKS Developer Consoleへのアクセス。 |

LINE WORKSのテナントにCogno Botを接続します。会話をどのProjectに割り当てるか、DMのLINE WORKSユーザーをどのCognoメンバーに対応させるかを選びます。有効化した会話の新しいメッセージをCognoが読み取り、返信できます。

## 事前確認

* Developer Consoleでアプリを作成できる管理者がいるLINE WORKSテナントを使います。
* BotはCognoが作成・設定します。Bot、Service Account、Private Keyの作成は不要です。

## LINE WORKSをCognoに接続する

**1. ClientAppを作成する**

Cognoで**連携 → LINE WORKS**を開きます。LINE WORKS Developer Consoleで**API
→ ClientApp →
アプリの新規追加**を開いてアプリを作成します。Cognoに表示されたRedirect
URLを追加し、**OAuth Scopes**で`bot`と`user.read`を選びます。

**2. 接続する**

作成したアプリのClient IDとClient SecretをCognoに入力し、**LINE
WORKSで接続**を選びます。LINE
WORKSの管理者アカウントで許可すると、CognoがドメインにCogno
Botを作成してCallback URLを設定し、連携画面に戻ります。

**3. Cognoを招待して会話を割り当てる**

LINE
WORKSのルームにCognoを招待するか、CognoとのDMを開始します。連携画面には、Cognoが参加しているルームとDMが、最新の発言と読んでいるProjectとともに表示されます。各Projectの設定で**LINE
WORKS**を開き、そのProjectが読む会話を選びます。DMは、送信者が**メンバーの対応づけ**でCognoメンバーに対応付いているときだけ読まれます。

**4. Cognoの送信方法を選ぶ**

**LINE WORKS Agentツール**の**LINE
WORKSに送信**をすぐに返信する場合は**許可**にします。この権限はProjectを選んだ会話にだけ適用されます。

接続を確認するには、有効化したDMまたはルームでテキストを送ります。LINE WORKSからイベントが届くと、接続カードの**最終受信**時刻が更新されます。

## 会話とメンバーの対応付け

| 会話 | Cognoの設定 |
| - | - |
| ルーム | 新しいメッセージを取り込むProjectを選びます。 |
| DM | Projectの設定で選び、送信者をメンバーの対応づけで対応付けます。 |
| 切断中 | Client IDとClient Secretを入力して再接続します。同じBotを使い続けます。 |

Cognoは会話をProjectで有効化した後の新しいメッセージを取り込みます。Botを招待しただけではProjectのコンテキストに追加されません。

**メンバーの対応づけ**には、LINE WORKSドメインのユーザーが表示され、メールアドレスが同じCognoメンバーに自動で対応付けられます。自動で対応付けられなかったユーザーは手動でメンバーを選びます。**メンバーを同期**を選ぶとユーザー一覧を読み直します。対応付けたユーザーがルームで依頼すると、Cognoはその人の依頼として扱い、本人のカレンダーなどのツールを使えます。ユーザー一覧の読み取りには、LINE WORKSのアプリに`user.read`権限が必要です。

## よくある状態

| 状態 | 意味 | 次の操作 |
| - | - | - |
| **接続中** | CognoがBotからCallbackを受信できます。 | Cognoをルームに招待するかDMを送り、**更新**を選びます。 |
| **切断済み** | Cognoはメッセージの送受信を停止しています。 | **LINE WORKSに再接続**でClient IDとClient Secretを入力し、**LINE WORKSで接続**を選びます。 |
| 会話がありません | ルームやDMがまだ見つかっていません。 | Cognoをルームに招待するかDMを送り、**更新**を選びます。 |
| 最終受信が空欄 | LINE WORKSからイベントを受信していません。 | Cognoを招待したルームかDMでメッセージを送ります。 |

## 参照URL

* [LINE WORKS Botの設定](https://developers.worksmobile.com/jp/docs/bot)
* [LINE WORKS Callback](https://developers.worksmobile.com/jp/docs/bot-callback)
* [LINE WORKS User Account認証（OAuth）](https://developers.worksmobile.com/jp/docs/auth-oauth)

## 関連docs

* [連携](https://cogno.studio/docs/ja/integrations.md)
* [Projects](https://cogno.studio/docs/ja/projects.md)
* [トラブルシューティング](https://cogno.studio/docs/ja/troubleshooting.md)


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