Telegram

GitLabを構成して、通知をTelegramのチャットまたはチャンネルに送信できます。Telegramインテグレーションをセットアップするには、次の手順を実行する必要があります:

1. Telegramボットを作成する。
2. Telegramボットを設定する。
3. GitLabでTelegramインテグレーションをセットアップする。

Telegramボットを作成する

Telegramでボットを作成するには:

1. @BotFatherとの新しいチャットを開始します。
2. Telegramのドキュメントの説明に従って、新しいボットを作成します。

ボットを作成すると、BotFatherからAPIトークンが提供されます。このトークンは、Telegramでボットを認証するために必要なため、安全に保管してください。

Telegramボットを設定する

Telegramでボットを設定するには:

1. ボットを管理者として、新規または既存のチャンネルに追加します。
2. イベントを受信するために、ボットにPost Messages権限を割り当てます。
3. チャンネルの識別子を作成します。
   • パブリックチャンネルの場合は、パブリックリンクを入力し、チャンネル識別子（例: https:/t.me/MY_IDENTIFIER）をコピーします。
   • プライベートチャンネルの場合は、APIトークンでgetUpdatesメソッドを使用し、チャンネル識別子（例: -2241293890657）をコピーします。

GitLabでTelegramインテグレーションをセットアップする

ボットをTelegramチャンネルに招待した後、通知を送信するようにGitLabを構成できます:

1. インテグレーションを有効にするには、次のようにします:
   • For your group or project（グループまたはプロジェクトの場合）:
     1. 左側のサイドバーで、検索または移動先を選択して、プロジェクトまたはグループを見つけます。
     2. 設定 > インテグレーションを選択します。
   • For your instance（インスタンス）の場合:
     1. 左側のサイドバーの下部で、管理者を選択します。
     2. 設定 > インテグレーションを選択します。
2. Telegramを選択します。
3. インテグレーションを有効にするで、有効チェックボックスをオンにします。
4. オプション。ホスト名に、ローカルボットAPIサーバーのホスト名を入力します。
5. パイプライントークンに、Telegramボットからトークン値を貼り付けます。
6. トリガーセクションで、Telegramで受信するGitLabイベントのチェックボックスを選択します。
7. 通知設定セクションで、次のことを行います:
   • チャンネルの識別子に、Telegramチャンネル識別子を貼り付けます。
   • オプション。メッセージスレッドIDに、ターゲットメッセージスレッド（フォーラムスーパーグループのトピック）の固有識別子を貼り付けます。
   • オプション。壊れたパイプラインのみ通知チェックボックスをオンにして、失敗したパイプラインの通知のみを受信します。
   • オプション。通知を送信するブランチドロップダウンリストから、通知を受信するブランチを選択します。
8. オプション。テスト設定を選択します。
9. 変更を保存を選択します。

Telegramチャンネルは、選択されたすべてのGitLabイベントを受信できるようになりました。