テレグラム
GitLab 16.1 で導入されました。
GitLabがTelegramのチャットやチャンネルに通知を送るように設定できます。Telegramインテグレーションを設定するには、以下が必要です:
- Telegramボットを作成します。
- Telegram botを設定します。
- GitLabでTelegramインテグレーションを設定します。
Telegramボットを作成
テレグラムでボットを作成するには
-
@BotFather
で新規チャットを開始します。 - Telegramのドキュメントに記載されているように、新しいボットを作成します。
ボットを作成すると、BotFather
から API トークンが提供されます。このトークンは、Telegramでボットを認証するために必要なので、セキュリティで保護してください。
Telegram ボットの設定
Telegramでボットを設定します:
- 新規または既存のチャンネルにボットを管理者として追加します。
- ボットにイベントを受信する
Post Messages
権限を割り当てます。 - チャネルの識別子を作成します。
- 公開チャネルの場合、公開リンクを入力し、チャネル識別子をコピーします (例:
https:/t.me/MY_IDENTIFIER
)。 - 非公開チャネルの場合は、API トークンを使用して
getUpdates
メソッドを使用し、チャネル識別子をコピーします。
- 公開チャネルの場合、公開リンクを入力し、チャネル識別子をコピーします (例:
GitLabでTelegramインテグレーションをセットアップします。
ボットをTelegramチャンネルに招待したら、GitLabが通知を送るように設定します:
- インテグレーションを有効にするには
-
グループやプロジェクトの場合:
- 左側のサイドバーで、「検索」を選択するか、または「移動」を選択して、プロジェクトまたはグループを見つけます。
- 設定]>[インテグレーション]を選択します。
-
インスタンスの場合:
- 左のサイドバーで、Search を選択するか、次のページに進んでください。
- Admin Areaを選択します。
- 設定]>[インテグレーション]を選択します。
-
グループやプロジェクトの場合:
- Telegramを選択します。
- インテグレーションを有効にする]で、[アクティブ]チェックボックスを選択します。
- 新しいトークン]で、Telegramボットのトークン値を貼り付けます。
- Triggerセクションで、Telegramで受け取りたいGitLabイベントのチェックボックスを選択します。
- Channel identifierに Telegramのチャンネル識別子を貼り付けます。
- オプション。Test settingsを選択します。
- 変更を保存を選択します。
Telegramチャンネルは選択した全てのGitLabイベントを受信できるようになりました。