GitLab

Send GitLab project events to Telegram.

Add the webhook

In your project open Settings → Webhooks and fill the form:

Field Value
URL https://thook.altr.dev/hooks/gitlab/{unique_path}
Secret token The secret key from the bot
Trigger Tick the events below

Use the Test button next to the webhook to send a sample event.

Supported events

  • Push events
  • Tag push events
  • Issues events and confidential issues events
  • Merge request events
  • Wiki page events
  • Pipeline events
  • Job events
  • Comments (on commits, issues, merge requests and snippets)
  • Releases events
  • Deployment events

You choose the events: Thook shows the ones the webhook sends.

Other events are accepted and ignored.

What you get

The same shape as the other services. The meaning of the icons is in the quick start.

🟢 Pipeline passed · GitLab

📦 group/thook · main
⚙️ Pipeline #55 · 🕒 1m 35s

👤 alice

View pipeline
🟣 Merge request merged · GitLab

📦 group/thook
📰 !12 Fix start
🌿 fix/start → main

👤 alice

Open MR
💬 New comment on merge request · GitLab

📦 group/thook
📰 !12 Fix start
✍️ Looks good to me

👤 alice

View comment
🔴 Deployment failed · GitLab

📦 group/thook
🚀 production · abc1234

👤 alice

View deployment

The last line is a link that opens the push, the merge request, the issue, the comment, the release or the pipeline on GitLab.

Troubleshooting

  • 401: the Secret token does not match the bot secret.
  • Self-hosted GitLab: the instance must be able to reach thook.altr.dev over HTTPS.