電報統合

前提条件

Telegram 統合を使用するには、Telegram アカウントを登録する必要があります。

Telegram で YouTrack アカウントを認証する手順には、Telegram Desktop アプリケーションが必要です。最良の結果を得るには、Telegram デスクトップがすでにインストールされているデバイスでこのセットアップを実行する必要があります。

ボットを承認したら、Telegram アプリをインストールした任意のデバイスでボットと対話できます。

統合を有効にする

ユーザーがこれらの機能を利用するには、最初に YouTrack サイトの統合を有効にする必要があります。

開始する前に、次の要件を満たしていることを確認してください。

• YouTrack サーバーのインストールへの接続は、既知の機関によって署名された SSL/TLS 証明書で保護されています。自己署名、期限切れ、その他の方法で無効な証明書を使用する接続要求は拒否されます。

• サーバーインフラストラクチャは、内部ネットワークの外部への接続を許可します。

• JetBrains プッシュ通知サービスがファイアウォールを通過できるようにします。

  Telegram プッシュ通知は、AWS でホストされている konnector と呼ばれる JetBrains 外部サービスを介して送信されます。konnector の静的受信 IP は 34.241.222.184 です。

Telegram で YouTrack ボットを承認する

統合を有効にしたユーザーとして、すでに YouTrack ボットにログインしています。ログインすることで、YouTrack ボットは、どの Telegram アカウントがあなたに属しているかを正確に認識します。

他のすべてのユーザーは、YouTrack アカウントでログインしてボットを承認する必要があります。

課題の下書き

YouTrack ボットは、YouTrack で課題の下書きを作成できるスラッシュコマンドをサポートしています。メッセージは概要にコピーされるため、YouTrack で行う必要があるのは、プロジェクトを選択し、オプションの説明を追加し、フィールドの値を設定し、課題を報告することだけです。

スラッシュコマンドと課題の概要を 1 つのメッセージに入力することもできます。例:

下書きが作成されたら、YouTrack で直接開いて、課題の報告を完了することができます。YouTrack の課題のドラフトの詳細については、課題の下書きの読み込みを参照してください。

この課題は、YouTrack で最後に課題を報告したプロジェクトに自動的に割り当てられます。以前に課題を報告したことがない場合、YouTrack は、課題の作成パーミッションが付与されている最初に見つかったプロジェクトを選択します。

記事の下書き

YouTrack ボットは、YouTrack ナレッジベースの記事の下書きを作成できるスラッシュコマンドもサポートしています。選択したメッセージは、新しい記事のタイトルとして使用されます。下書きを公開する準備を整えるには、共有したいコンテンツを追加して、公開するプロジェクトを選択します。

以下に示すように、スラッシュコマンドと記事のタイトルを 1 つのメッセージに入力することもできます。

ドラフトが作成されたら、YouTrack で直接開いて公開できます。YouTrack で記事の下書きを操作する方法については、記事の下書きを更新するを参照してください。

課題と記事へのコメントの追加

YouTrack ボットを使用すると、/comment コマンドを使用してコメントを追加することで、課題や記事を操作できます。

スラッシュコマンド、課題 ID、コメントを 1 つのメッセージに入力することもできます。例:

コマンドに関する更新の課題

/update コマンドを使用して、Telegram から課題を直接更新できます。

以下に示すように、スラッシュコマンド、更新する課題の ID、YouTrack コマンドを 1 つのメッセージに入力することもできます。

例: 新しい課題が作成されたという通知を受け取り、それを自分に割り当てたい場合は、次のコマンドを適用します。

課題をできるだけ早く解決するよう求めるコメントが誰かから追加された場合は、次のコマンドで優先度を上げます。

グループチャットで課題について話し合う

グループは、Telegram プラットフォームで顧客とやり取りし、コミュニティを構築するための非常に人気のあるツールです。YouTrack ボットを使用すると、任意のグループチャットを、/discuss コマンドで課題について話し合うための専用フォームに変えることができます。

このコマンドは、指定された課題のディスカッションモードを有効にします。ディスカッションモードがアクティブである限り、グループチャットに投稿されたメッセージはコメントとして課題に追加されます。

コメントは、YouTrack ボットを承認し、課題が作成された YouTrack サイトにアカウントを登録している代理またはユーザーのみが投稿します。ボットは、これらの条件を満たさないユーザーによって投稿されたすべてのメッセージを無視します。

ディスカッションモードを終了するには、/wrapup コマンドを使用します。

スラッシュコマンド

使用可能なコマンドのリストについては、/help と入力してください。ボットでは、次のスラッシュコマンドがサポートされています。