64898b2c79
Some checks failed
Code scanning / CodeQL (push) Failing after 15s
Zulip production suite / Ubuntu 22.04 production build (push) Failing after 26s
Zulip production suite / Debian 12 production install with custom db name and user (push) Has been skipped
Zulip production suite / Ubuntu 22.04 production install and PostgreSQL upgrade with pgroonga (push) Has been skipped
Zulip production suite / Ubuntu 24.04 production install (push) Has been skipped
Zulip production suite / Ubuntu 26.04 production install (push) Has been skipped
Zulip production suite / Debian 13 production install (push) Has been skipped
Zulip production suite / 7.0 Version Upgrade (push) Has been skipped
Zulip production suite / 8.0 Version Upgrade (push) Has been skipped
Zulip production suite / 6.0 Version Upgrade (push) Has been skipped
Zulip production suite / 10.0 Version Upgrade (push) Has been skipped
Zulip production suite / 9.0 Version Upgrade (push) Has been skipped
Zulip production suite / 12.0 Version Upgrade (push) Has been skipped
Zulip production suite / 11.0 Version Upgrade (push) Has been skipped
GitHub Actions Security Analysis with zizmor / zizmor (push) Failing after 3s
Zulip CI / Debian 12 (Python 3.11, backend + documentation) (push) Failing after 26s
Zulip CI / Ubuntu 22.04 (Python 3.10, backend + frontend) (push) Failing after 3s
Zulip CI / Ubuntu 24.04 (Python 3.12, backend) (push) Failing after 25s
Zulip CI / Ubuntu 26.04 (Python 3.14, backend) (push) Failing after 25s
Zulip CI / Debian 13 (Python 3.13, backend) (push) Failing after 28s
Zulip production suite / Required jobs (push) Has been cancelled
Zulip CI / Required jobs (push) Has been cancelled
API Documentation Update Check / check-feature-level-updated (push) Has been cancelled
API Documentation Update Check / notify-if-api-docs-changed (push) Has been cancelled
53 lines
1.9 KiB
Markdown
53 lines
1.9 KiB
Markdown
# Zulip GitLab integration
|
|
|
|
Receive GitLab notifications in Zulip!
|
|
|
|
!!! tip ""
|
|
|
|
If you also configure a [custom profile
|
|
field](/help/custom-profile-fields) for GitLab accounts, this
|
|
integration will refer to GitLab users using [Zulip silent
|
|
mentions](/help/mention-a-user-or-group#silently-mention-a-user),
|
|
rather than their GitLab name.
|
|
|
|
|
|
{start_tabs}
|
|
|
|
1. {!create-an-incoming-webhook.md!}
|
|
|
|
1. Decide where to send {{ integration_display_name }} notifications, and
|
|
[generate the integration URL](/help/generate-integration-url). You'll be
|
|
able to configure which branches you'll receive notifications from,
|
|
whether to exclude notifications from private projects, and whether to
|
|
include the merge request title in addition to the merge request ID in
|
|
the topic name.
|
|
|
|
1. Go to your repository on GitLab and click **Settings** on the left
|
|
sidebar. Click on **Webhooks** and select **Add new webhook**.
|
|
|
|
1. Set **URL** to the URL you generated, and **Name** to a name of your
|
|
choice, such as `Zulip`. Select the [events](#filtering-incoming-events)
|
|
you would like to receive notifications for, and click **Add Webhook**.
|
|
|
|
!!! warn ""
|
|
|
|
**Note**: If your GitLab server and your Zulip server are on a local network
|
|
together, and you're running GitLab 10.5 or newer, you may need to enable
|
|
GitLab's "Allow requests to the local network from hooks and
|
|
services" setting (by default, recent GitLab versions refuse to post
|
|
webhook events to servers on the local network). You can find this
|
|
setting near the bottom of the GitLab "Settings" page in the "Admin area".
|
|
|
|
{end_tabs}
|
|
|
|
{!congrats.md!}
|
|
|
|
|
|
|
|
{!event-filtering-additional-feature.md!}
|
|
|
|
### Related documentation
|
|
|
|
{!webhooks-url-specification.md!}
|
|
* [GitLab webhooks documentation](https://docs.gitlab.com/user/project/integrations/webhooks/#create-a-webhook)
|