Jenkins app for Google Chat

To get notifications about your Jenkins builds, use the Jenkins app in Chat.

Before you begin

• Get permission from your Google Workspace administrator to install apps.
• Add the app to Chat. Learn how to find and add apps to Chat.

Step 1: Install Chat plugin on Jenkins server

To do this task, you must sign in as a Jenkins administrator.

1. On your device, download the Chat Notifier Plugin file.
2. In “Jenkins,” select Manage Jenkins Manage Plugins.
3. On the “Advanced” tab, under “Upload Plugin,” select the plug-in file.
4. Click Upload.

People in your organization can now install and set up the Jenkins app.

Step 2: Set up the Jenkins app in Chat

To send build notifications to Chat, Jenkins needs the token that the app generates. Each space where you add the app gets a token. The app sends notifications to all spaces where it's a member.

1. Open Google Chat.
2. Open a direct message or go to a space.
3. Copy the token in the app.
4. (Optional) To display the token again, select an option:
   • In a direct message, enter token.
   • In a space, enter /jenkins_token.
5. (Optional) To regenerate the token, click Regenerate Token.

Step 3: Set up notifications

1. Open “Jenkins.”
2. Go to the build that you want to add Chat notifications for.
3. Under “Build,” next to “Add build step,” click the Down arrow .
4. Choose which notifications you want to get.
5. Under “Post-build Actions,” next to “Add post-build actions,” click the Down arrow .
6. Select Notify Hangouts Chat.
7. Choose an option and paste the token you copy from Chat.
   • Chat: Choose a global configuration that you previously set up.
   • Chat Token: Override the global configuration for a specific Chat space.
8. Check the boxes for the items that you want to get notifications about in Chat.
9. Click Save.

From a Build event notification, click:

• Open Build: This modifies the build configuration in Jenkins.
• View Details: This lets you view information about the notification.

Step 4: Get notifications for a pipeline

1. Open "Jenkins."
2. Open the pipeline that you want to add Chat notifications for.

3. In your pipeline script, enter:
   
   hangoutsNotify message: "This message is from a pipeline!",token: {your_jenkins_token},threadByJob: false
   
   Tip: Make sure to replace {your_jenkins_token} with the token you requested from the Chat app. You can set threadByJob to true or false.

4. Click Save.