# インスタントメッセージング (/ja/docs/verdent-manager/core-features/instant-messaging)

> Telegram、Slack、Feishu から Manager に作業を割り当てる



Manager に作業を割り当てるのに、コンピューターの前にいる必要はありません。Telegram、Slack、Feishu を接続すれば、使い慣れたチャットツールを使って、いつでもどこでも Manager にメッセージを送れます。Manager はあなたのメッセージを構造化されたタスクに変換し、実行を開始します。スマートフォンでスクロールしながらアイデアを書き留め、後で戻って結果を確認しましょう。

## 対応するインスタントメッセージングプラットフォーム [#対応するインスタントメッセージングプラットフォーム]

| プラットフォーム | 種類          |
| -------- | ----------- |
| Telegram | パーソナルボット    |
| Slack    | ワークスペースボット  |
| Feishu   | エンタープライズボット |

各プラットフォームでは、開発者コンソールでボットを作成し、Verdent でペアリングを完了する必要があります。接続が完了すると、ボットに送信したメッセージはすべて直接 Manager に転送されます。

***

## 接続の流れ [#接続の流れ]

接続プロセスは 2 つの段階で構成されます。

1. **トークンを入力** — 認証情報の設定
2. **ペアリング用メッセージの送信** — ボットを Manager にリンク

すべての設定は Manager のサイドバーにあるチャンネル設定ページで行います。

### 設定画面へのアクセス方法 [#設定画面へのアクセス方法]

<Steps>
  <Step title="チャンネルの追加を開く">
    Manager の左サイドバー上部にある &#x2A;*+** ボタン（Add Channel）を選択します。
  </Step>

  <Step title="プラットフォームを選択">
    接続したいプラットフォーム（Telegram、Slack、Feishu）を選びます。
  </Step>

  <Step title="ガイドに沿って進める">
    サイドパネルで 2 段階の設定を完了します。
  </Step>
</Steps>

***

## Telegram の設定 [#telegram-の設定]

### 段階 1: ボットを作成してトークンを取得 [#段階-1-ボットを作成してトークンを取得]

<Steps>
  <Step title="BotFather にメッセージを送る">
    Telegram で [@BotFather](https://t.me/BotFather) を見つけ、`/newbot` を送信します。
  </Step>

  <Step title="ボットに名前を付ける">
    プロンプトに従って、表示名とユーザー名を指定します。
  </Step>

  <Step title="トークンをコピー">
    作成後、BotFather が `123456:ABC-DEF1234...` の形式でトークンを返します。
  </Step>

  <Step title="Verdent に貼り付け">
    Verdent の設定パネルの **Bot Token** フィールドにトークンを貼り付けて確定します。
  </Step>
</Steps>

### 段階 2: メッセージペアリング [#段階-2-メッセージペアリング]

<Steps>
  <Step title="メッセージを送信">
    Telegram で新しいボットを開き、任意のメッセージ（例: `hello`）を送信します。
  </Step>

  <Step title="ペアリングコードを受け取る">
    ボットが自動的にペアリングコードを返信します。
  </Step>

  <Step title="Verdent で確認">
    Verdent のパネルにコードを入力して確定します。これで接続が完了します。
  </Step>
</Steps>

***

## Slack の設定 [#slack-の設定]

### 段階 1: Slack アプリを作成してトークンを取得 [#段階-1-slack-アプリを作成してトークンを取得]

<Steps>
  <Step title="新しいアプリを作成">
    [api.slack.com/apps](https://api.slack.com/apps) にアクセスし、**Create New App** を選択します。
  </Step>

  <Step title="提供されたマニフェストを使用">
    **From an app manifest** を選び、Verdent が提供する JSON マニフェストを貼り付けます（UI にコピーボタンがあります）。
  </Step>

  <Step title="ワークスペースを選択">
    Slack ワークスペースを選択し、アプリを作成します。
  </Step>

  <Step title="両方のトークンをコピー">
    アプリ設定で **Bot Token**（`xoxb-`）と **App Token**（`xapp-`）を見つけ、両方を Verdent の設定パネルに貼り付けます。
  </Step>
</Steps>

<Note>
  **アプリ名の要件:** 名前は 80 文字未満で、中国語・日本語・韓国語の文字を含めることはできません。
</Note>

### 段階 2: メッセージペアリング [#段階-2-メッセージペアリング-1]

Telegram と同じです。ボットにメッセージを送信し、ペアリングコードを受け取り、それを Verdent に入力して接続を完了します。

***

## Feishu の設定 [#feishu-の設定]

Feishu は Telegram や Slack よりも手順が多くなります。権限は個別に設定し、イベントは手動でサブスクライブする必要があります。複雑ではありませんが、各ステップを正しく行わないと接続が進みません。順番に従ってください。

### ステップ 1: カスタムアプリを作成 [#ステップ-1-カスタムアプリを作成]

<Steps>
  <Step title="開発者コンソールを開く">
    [Feishu Open Platform](https://open.feishu.cn/app) にアクセスし、Feishu アカウントでサインインします。
  </Step>

  <Step title="カスタムアプリを作成">
    右上の **Create Custom App** を選択します。
  </Step>

  <Step title="基本情報を入力">
    アプリ名と説明を入力し、作成を完了します。
  </Step>
</Steps>

### ステップ 2: 権限を設定 [#ステップ-2-権限を設定]

新しいアプリを開き、左メニューの **Permissions & Scopes** に移動します。

Feishu はスコープの一括インポートに対応しているため、1 つずつチェックする必要はありません。ページ上の一括インポート/エクスポートの入口を見つけ、以下の JSON をそのまま貼り付けます。

```json
{
  "scopes": {
    "tenant": [
      "im:message:send_as_bot",
      "im:message",
      "im:resource",
      "im:chat",
      "im:chat:readonly",
      "im:message.p2p_msg:readonly",
      "im:message.group_at_msg:readonly",
      "contact:contact.base:readonly",
      "contact:user.base:readonly",
      "contact:user.employee_id:readonly",
      "docs:document.content:read",
      "wiki:wiki:readonly",
      "application:application:self_manage"
    ],
    "user": []
  }
}
```

インポートを確定すると、上記のすべてのスコープが権限リストで選択された状態で表示されます。

### ステップ 3: 認証情報を取得して Verdent に接続 [#ステップ-3-認証情報を取得して-verdent-に接続]

左メニューの **Credentials & Basic Info** を開きます。

<Steps>
  <Step title="App ID と App Secret をコピー">
    **App ID**（`cli_xxx...` の形式）と **App Secret** をコピーします。
  </Step>

  <Step title="Verdent に貼り付け">
    両方の値を Verdent の設定パネルの該当フィールドに貼り付けます。
  </Step>

  <Step title="接続">
    **Connect** を選択して最初の段階を完了します。
  </Step>
</Steps>

### ステップ 4: 常時接続を有効化 [#ステップ-4-常時接続を有効化]

接続が完了したら、Feishu Open Platform に戻り、**Events & Callbacks** を開きます。

**Use Long Connection to Receive Events** をオンにします。このスイッチは Feishu がボットにメッセージを配信する方法を制御します。常時接続では公開 URL を公開する必要がなく、代わりに永続的な接続を維持するため、より信頼性が高くなります。

### ステップ 5: メッセージイベントをサブスクライブして公開 [#ステップ-5-メッセージイベントをサブスクライブして公開]

引き続き **Events & Callbacks** ページで行います。

<Steps>
  <Step title="メッセージイベントを追加">
    **Add Event** を選択し、`im.message.receive_v1`（メッセージ受信イベント）を検索して追加します。
  </Step>

  <Step title="バージョンを作成して公開">
    右上の **Create and Publish Version** を選択し、バージョンの説明を入力して確定します。
  </Step>

  <Step title="Verdent とペアリング">
    公開後、Verdent に戻り、Feishu ボットにメッセージを送信してペアリングを完了します。
  </Step>
</Steps>

### 各権限の役割 [#各権限の役割]

| 権限                                                  | 用途                                                                    |
| --------------------------------------------------- | --------------------------------------------------------------------- |
| `im:message:*` 系                                    | ボットがダイレクトメッセージやグループでの @ メンションを含むメッセージを読み取り、送信できるようにします                |
| `im:chat:*`                                         | ボットが所属する会話のリストを読み取ります                                                 |
| `im:resource`                                       | メッセージに添付された画像、ファイル、その他のリソースを読み取ります                                    |
| `contact:*`                                         | 基本的な連絡先情報を読み取り、メッセージの送信者を識別します                                        |
| `docs:document.content:read` / `wiki:wiki:readonly` | Feishu Docs と Wiki のコンテンツを読み取り、ドキュメントリンクをコンテキストとして Manager に渡せるようにします |
| `application:application:self_manage`               | アプリ自身の設定を管理します。常時接続機能に必要です                                            |

***

## 接続成功後 [#接続成功後]

ペアリングが完了すると、チャンネルが Manager の左サイドバーのチャンネルリストに表示され、次の情報が示されます。

* プラットフォームのアイコンとチャンネル名
* 接続ステータス（**Connected** / **Disconnected** / **Needs attention**）
* 最新メッセージのプレビューとタイムスタンプ
* 未読メッセージインジケーター（緑のドット）

これ以降、ボットに送信したすべてのメッセージは、実行可能なタスクとして Manager によって直接処理されます。

***

## 接続済みチャンネルの管理 [#接続済みチャンネルの管理]

* **すべてのチャンネルを表示** — 接続済みの IM チャンネルがすべてサイドバーに一覧表示されます。
* **チャンネルを削除** — チャンネルにカーソルを合わせて削除を選択し、確定します。それがそのタイプの最後のチャンネルの場合、ボット設定もクリアされます。
* **再接続** — チャンネルが **Disconnected** または **Needs attention** を示している場合、上部に修復用のプロンプトが表示され、再設定できます。

***

## ユースケース [#ユースケース]

<CardGroup cols="3">
  <Card title="モバイル指令センター" icon="mobile">
    外出中に Telegram でボットに伝えます。「main ブランチの最新の変更を staging にデプロイして」。戻る頃には結果ができあがっています。
  </Card>

  <Card title="チームコラボレーション" icon="users">
    Slack チャンネルで Manager ボットをメンションして、今日の PR ステータスを要約します。応答はチャンネルに直接表示され、チーム全員が確認できます。
  </Card>

  <Card title="アイデアをすばやく記録" icon="lightbulb">
    寝る前にボットにアイデアを送り、Manager に翌日実行するタスクとしてまとめてもらいます。
  </Card>
</CardGroup>