Jenkins App via Rocket.Chat Marketplace

Follow these steps to receive Jenkins notifications in Rocket.Chat using the Jenkins app from the Rocket.Chat marketplace:

1. Install the Jenkins app in Rocket.Chat

  1. Go to Administration > Apps > Marketplace, and search for Jenkins

  2. Install the app

  3. Click the Settings tab and configure the following:

    1. Enter a name in the Jenkins Integration Username Alias field

    2. Add a user avatar in the Jenkins Integration Avatar field

  4. Save the changes

2. Interact with the Jenkins App using slash commands

After installing the Jenkins app, you can connect your Rocket.Chat workspace to Jenkins using slash commands:

  1. Ensure you have a Jenkins job set up

  2. Navigate to the channel where you want to receive Jenkins notifications

  3. Run the /jenkins slash command to view available actions with the Jenkins app

  4. Run the following command in the channel:

    /jenkins connect <project URL>

    Copy the job URL you created earlier in Jenkins and substitute it for <project URL>. Once executed, the Jenkins app will provide additional steps, including a webhook URL for completing the integration.

3. Configure the webhook in Jenkins

  1. Log in to your Jenkins dashboard

  2. Navigate to Dashboard > Manage Jenkins > Plugins and install the Outbound Webhook for Build Events plugin

  3. In the already-created job:

    1. Go to the Post-Build Actions section

    2. Select Outbound Webhook Notification and add the webhook URL provided by the Jenkins app in the Rocket.Chat channel

    3. Choose the types of notifications you want to receive in the Rocket.Chat channel.

  4. Save the changes.

4. Receive Jenkins notifications in Rocket.Chat

You'll receive build status notifications when the configured Jenkins job runs in the designated Rocket.Chat channel. Notifications will include updates on build success or failure, helping your team stay informed and responsive.