チャンネル
チャンネルとは？
チャンネルとは、Neotaskのエージェントがメッセージの送受信に使用するコミュニケーションプラットフォームです。チャンネルを接続することで、エージェントはそのプラットフォームで受信メッセージをリッスンし、リアルタイムで応答する機能を得ます。
主要な概念：
- エージェントごとの設定 -- 各チャンネル接続はエージェントレベルで設定されます。1つのエージェントがSlackに接続し、別のエージェントがDiscordを処理できます。また、1つのエージェントが複数のチャンネルに同時に接続することも可能です。
- 双方向 -- チャンネルはメッセージの送受信の両方をサポートします。エージェントは受信メッセージへの応答、アウトバウンドメッセージの送信、またはその両方が可能です。
- マルチアカウント -- 同じチャンネルタイプで複数のアカウントを接続できます（例：2つの異なるSlackワークスペースや複数のメールアドレス）。
サポートされるチャンネル
| チャンネル | 認証方法 | 機能 |
|---|---|---|
| Slack | OAuth | フルメッセージング、チャンネル、スレッド、リアクション、ファイルアップロード |
| Discord | Botトークン | サーバーメッセージング、チャンネル、DM、埋め込み、リアクション |
| QRコード | テキストメッセージ、メディアメッセージ、グループチャット | |
| Telegram | Botトークン | テキストメッセージ、グループ、チャンネル、インラインキーボード、ファイル共有 |
| Signal | ローカルアプリ | エンドツーエンド暗号化メッセージング、グループチャット |
| Microsoft Teams | OAuth | チーム、チャンネル、チャット、アダプティブカード、ファイル共有 |
| Google Chat | OAuth | スペース、ダイレクトメッセージ、カード、スレッド付き会話 |
| SMS | APIキー | サポートされるプロバイダーを通じたアウトバウンドおよびインバウンドテキストメッセージング |
| Email / Gmail | OAuth | 送信、受信、下書き、返信、添付ファイル、ラベル管理 |
| Matrix | トークン | フェデレーテッドメッセージング、ルーム、エンドツーエンド暗号化 |
| Line | トークン | テキストメッセージ、スタンプ、グループチャット、リッチメニュー |
| Zalo | トークン | テキストメッセージ、メディア共有 |
| IRC | 設定 | サーバー接続、チャンネル、プライベートメッセージ |
| iMessage | ローカル | macOSネイティブメッセージング（macOSホストが必要） |
チャンネルの接続
接続プロセスはチャンネルの認証方法によって異なります。
OAuthフロー
使用：Slack、Microsoft Teams、Google Chat、Email / Gmail
- エージェントのチャンネルタブを開きます。
- 追加したいチャンネルの横の接続をクリックします。
- サービスの認証ページにリダイレクトされます。
- アカウントでサインインし、Neotaskに要求されたアクセス許可を付与します。
- 認証後、ダッシュボードにリダイレクトされ、チャンネルが接続済みとして表示されます。
モバイルプラットフォームでは、QRコードオプションが利用可能です。携帯電話からQRコードをスキャンして、デスクトップブラウザでサインインせずに認証を完了できます。
Botトークン
使用：Discord、Telegram
- 各プラットフォームでボットを作成します：
- Discord -- Discord Developer Portalでアプリケーションを作成し、ボットトークンを生成します。
- Telegram -- Telegramで@BotFatherにメッセージを送り、ボットを作成してトークンを受け取ります。
- エージェントのチャンネルタブを開き、チャンネルの横の接続をクリックします。
- トークンフィールドにボットトークンを貼り付けます。
- 保存をクリックして接続を確立します。
QRコード
使用：WhatsApp
- エージェントのチャンネルタブを開き、WhatsAppの横の接続をクリックします。
- 画面にQRコードが表示されます。
- 携帯電話でWhatsAppを開き、リンクされたデバイスに移動して、QRコードをスキャンします。
- 携帯電話がリンクを確認すると接続が確立されます。
APIキー
使用：SMS
- SMSプロバイダー（例：Twilio、Vonage）からAPIキーを取得します。
- エージェントのチャンネルタブを開き、SMSの横の接続をクリックします。
- APIキーと必要な追加フィールド（例：電話番号、アカウントSID）を入力します。
- 保存をクリックしてチャンネルを有効にします。
トークン
使用：Matrix、Line、Zalo
- 各プラットフォームの開発者設定または管理パネルからアクセストークンを生成します。
- エージェントのチャンネルタブを開き、チャンネルの横の接続をクリックします。
- トークンフィールドにトークンを貼り付けます。
- 保存をクリックして接続を確立します。
サーバー設定
使用：IRC
- エージェントのチャンネルタブを開き、IRCの横の接続をクリックします。
- サーバーアドレス、ポート、ニックネーム、および（オプションで）パスワードを入力します。
- 接続時に参加するチャンネルを指定します。
- 保存をクリックして接続します。
ローカルアプリケーション
使用：Signal、iMessage
- ホストマシンに必要なアプリケーションがインストールされ、実行されていることを確認します：
- Signal -- Signal Desktopがインストールされ、Signalアカウントにリンクされている必要があります。
- iMessage -- Messages.appが設定されたmacOSホストが必要です。
- エージェントのチャンネルタブを開き、チャンネルの横の接続をクリックします。
- Neotaskがローカルアプリケーションを検出し、接続を確立します。
- アプリケーションが検出されない場合、インストールまたは設定を求められます。
接続テスト
チャンネルを接続した後、Neotaskは接続を検証するために自動的にレイテンシプローブを実行します：
- テストメッセージがチャンネルのAPIを通じて送受信されます。
- ラウンドトリップレイテンシが測定・表示されます。
- テストが失敗した場合、エラーメッセージが問題を説明します（例：無効なトークン、期限切れのOAuth付与、到達不能なサーバー）。
チャンネルの設定からいつでも接続テストを再実行できます。
チャンネル操作
チャンネルが接続されると、エージェントのチャンネルタブから管理できます。
有効化 / 無効化
切断せずにチャンネルのオン/オフを切り替えます。無効にすると：
- エージェントはそのチャンネルのメッセージリスニングを停止します。
- そのチャンネルを通じたアウトバウンドメッセージは送信されません。
- 接続認証情報は保持されるため、再設定せずにいつでも再有効化できます。
接続性テスト
チャンネルが到達可能で応答性があることを確認するために、オンデマンドの接続性テストを実行します。テストは：
- チャンネルのサービスに軽量なAPIリクエストを送信します。
- ミリ秒単位のラウンドトリップレイテンシを測定します。
- 結果を接続済み（レイテンシ付き）または失敗（エラー詳細付き）として報告します。
レイテンシの表示
接続された各チャンネルは、チャンネルタブに最新のレイテンシ値を表示します。これにより、一目で遅いまたは劣化した接続を特定できます。レイテンシは以下の場合に更新されます：
- 各接続テスト後に自動的に。
- チャンネルがアクティブな間、バックグラウンドで定期的に。
切断 / ログアウト
チャンネル接続を完全に削除するには：
- チャンネルの横の切断をクリックします。
- ダイアログでアクションを確認します。
- Neotaskは保存された認証情報を取り消しまたは破棄します（OAuthトークンはサポートされている場合、プロバイダー側で取り消されます）。
- チャンネルはエージェントのアクティブチャンネルリストから削除されます。
切断後に再接続するには、元の接続手順に再度従ってください。