CoroidにはSlack、Discord、Telegram、SMS向けのプラットフォームボットが用意されています。これらはこのセクションで設定できます：設定 → 接続 → チャネル。
各ボットの現在の機能は以下の通りです：
| プラットフォーム | メッセージがリクエストに変換される | 更新情報を受信する |
|---|---|---|
| Slack | はい、イベント自動化を通じて対応 | タスクの更新情報は受信ウェブフックを通じて送信される |
| Telegram | はい、イベント自動化を通じて対応 | いいえ |
| Discord | いいえ | いいえ |
| SMS | いいえ | いいえ |
DiscordやSMS用のボットは保存可能ですが、現時点では使用されていません。同じページにはチャンネルブリッジも記載されていますが、こちらもまだ動作しません。詳細はチャネルブリッジ。
プラットフォームボット
このボットはCoroidがプラットフォーム上で利用する識別子です。ワークスペースまたはサーバーごとに一度インストールし、読み取り対象のチャンネルへのアクセス権を付与します。SlackおよびTelegramでは、イベント自動化がメッセージを読み取るためにボットが必要です。
チャンネルからSlackボットが削除されると、Coroidがそのチャンネルを読み取れなくなりますが、その旨を示す通知はありません。Slackのメッセージがリクエストに変換されなくなった場合は、ボットが依然としてチャンネル内に存在するかを確認してください。
ボットの追加・変更・削除は所有者および管理者のみが行えます。各プラットフォームはイベントをAPIゲートウェイ上のウェブフックURLに送信し、Coroidは各ボットに対応するURLを表示します。ボットのシークレットで署名されていない配信はCoroidによって拒否されます。
チャンネルから作業を開始する
SlackまたはTelegramのメッセージは作業リクエストに変換可能ですが、DiscordやSMSのメッセージは変換できません。
メッセージはイベント自動化を通じてリクエストに変換されます。これは「誰か直してくれないか…」といった、通常は追跡されないリクエストに対応するのに役立ちます。
一致するメッセージはQualificationプロセスでリクエストとして処理されます。Qualificationでは重複を確認し、どのようなタスクにするかを決定します。承認を得るまで何も作成されません。詳細は作業を開始する方法。
CoroidはSlackやTelegramのアカウントをCoroidのアカウントにリンクしないため、該当チャットに投稿できるユーザーなら誰でもリクエストを提出できます。そのため、チャットからの作業は自動的には開始されません。適格なタスクが作成されてから作業開始を待ち、計画案は承認を待つことになります。
詳細はトリガーと送信先。
Slack
- このセクションでSlackボットを設定します：プラットフォームボット。ボットトークンとSlackアプリの署名シークレットが必要です。
- Slackアプリ内で、チャンネルメッセージやアプリのメンションを、Coroidが表示するWebhook URLに送信します：
https://api.coroid.ai/api/v1/webhooks/slack/events。 - 読み取り対象とする各チャンネルにボットを招待します。
- 「品質管理」でSlackを有効にします品質管理 → 組織デフォルト → 作業開始前 → リクエストの受信元。ソースを有効にできるのはオーナーと管理者のみで、ボットが接続されている場合に限られます。
Slackを有効にすると、メッセージをリクエストとして記録する自動化処理が追加されます。これはファクトリー → 自動化処理に記載されており、ここでフィルターを変更できます。Slackを無効にすると自動化処理が一時停止され、フィルターは保持されます。
自動化処理のフィルターが、どのメッセージをカウントするかを決定します。まずは次のメンションを含むメッセージに一致させることから始まります：@coroid。フィルターでは、特定のチャンネルに限定したり、アラートなどボットが投稿したメッセージに限定することも可能です。
Coroidは1つのチャンネルに対して1分間に最大10件のSlack自動化処理を実行します。
Telegram
- このセクションでTelegramボットを追加します：プラットフォームボット。CoroidはTelegramにWebhookを登録し、Webhookシークレットで保護します。シークレットを空欄にした場合、Coroidが自動で生成します。
- グループにボットを追加するか、チャンネルの管理者に設定します。
- 「品質管理」でTelegramを有効にします品質管理 → 組織デフォルト → 作業開始前 → リクエストの受信元。その自動化処理は ファクトリー → 自動化処理に記載されており、ここでフィルターを変更できます。
- チャット内でリクエストを開始するには、次のコマンドから入力します：
/coroid。
デフォルトで有効なTelegramのプライバシーモードでは、ボットはコマンドは認識できますが通常のメッセージは認識できません。フィルターで特定のチャットIDを持つチャットに自動化処理を限定することも可能です。フィルターで許可されていない限り、ボットはダイレクトメッセージを無視します。
誰でもあなたのボットを別のグループに追加してそこからリクエストを送信できます。これを防ぐには、自動化処理を自分のチャットに限定するか、BotFatherの次のコマンドでボットがグループに参加するのを禁止します：/setjoingroups。
Coroidは1つのチャットから1分間に最大10件の一致するメッセージのみを受け付けます。自動化処理が特定のプロジェクトに限定されている場合、そのリクエストはそのプロジェクトに送信されます。
チャネルブリッジ
ブリッジはチャンネルをチャットアシスタントとのセッションに接続します。
ブリッジを介したアシスタントとの対話は利用できません。ブリッジはメッセージをアシスタントに渡さないため、作業を開始したり指示したりすることはできません。
チャンネル内の更新情報
Slackは更新情報を受信する唯一のチャットプラットフォームです。タスクが完了、失敗、またはエスカレーションされた場合、およびマージコンフリクトの再試行や解決不能となった場合に、Coroidは指定のSlackチャンネルにメッセージを投稿します。これらのメッセージはSlackボット経由ではなく、貴社に接続されたSlack受信用Webhookを通じて送信されます。現時点ではWebhookを設定する画面はまだ実装されていません。
Discord、Telegram、SMSには更新情報は届きません。その他の通知はポータルに表示されます。詳細はこちらをご覧ください。通知。