チャネル
チャネルとは？
チャネルとは、Neotask のエージェントがメッセージを送受信するために使用するコミュニケーションプラットフォームです。チャネルを接続することで、エージェントはそのプラットフォーム上の受信メッセージをリッスンし、リアルタイムで応答する機能を持ちます。
主要な概念：
- エージェントごとの設定 -- 各チャネル接続はエージェントレベルで設定されます。一方のエージェントが Slack に接続し、別のエージェントが Discord を処理することも、単一のエージェントが複数のチャネルに同時に接続することも可能です。
- 双方向 -- チャネルはメッセージの送信と受信の両方をサポートします。エージェントは受信メッセージに応答したり、送信メッセージを開始したり、その両方を行ったりできます。
- マルチアカウント -- 同じチャネルタイプに対して複数のアカウントを接続できます（例：2つの異なる Slack ワークスペースや複数のメールアドレス）。
サポートされるチャネル
| チャネル | 認証方法 | 機能 |
|---|---|---|
| Slack | OAuth | フルメッセージング、チャネル、スレッド、リアクション、ファイルアップロード |
| Discord | Bot トークン | サーバーメッセージング、チャネル、DM、埋め込み、リアクション |
| QR コード | テキストメッセージ、メディアメッセージ、グループチャット | |
| Telegram | Bot トークン | テキストメッセージ、グループ、チャネル、インラインキーボード、ファイル共有 |
| Signal | ローカルアプリ | エンドツーエンド暗号化メッセージング、グループチャット |
| Microsoft Teams | OAuth | Teams、チャネル、チャット、アダプティブカード、ファイル共有 |
| Google Chat | OAuth | Spaces、ダイレクトメッセージ、カード、スレッド会話 |
| 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
- 各プラットフォームで bot を作成します：
- Discord -- Discord Developer Portal でアプリケーションを作成し、bot トークンを生成します。
- Telegram -- Telegram で @BotFather にメッセージを送り、bot を作成してトークンを受け取ります。
- エージェントのチャネルタブを開き、チャネルの横にある接続をクリックします。
- トークンフィールドに bot トークンを貼り付けます。
- 保存をクリックして接続を確立します。
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 トークンはプロバイダー側で取り消されます）。
- チャネルはエージェントのアクティブチャネルリストから削除されます。
切断後に再接続するには、元の接続手順を再度実行してください。