Yammer Plugin

Skip to end of metadata
Go to start of metadata

Plugin Information

Plugin ID yammer Changes In Latest Release
Since Latest Release
Latest Release
Latest Release Date
Required Core
1.1.0 (archives)
Jul 19, 2013
ruby-runtime (version:0.12)
token-macro (version:1.8)
Source Code
Issue Tracking
Pull Requests
Open Issues
Pull Requests
n/a (id: matthewriley)
Usage Installations 2014-Nov 120
2014-Dec 117
2015-Jan 115
2015-Feb 119
2015-Mar 132
2015-Apr 124
2015-May 125
2015-Jun 124
2015-Jul 117
2015-Aug 111
2015-Sep 118
2015-Oct 96

Sends build notifications to Yammer.

Yammer Plugin for Jenkins

The Yammer Plugin for Jenkins enables notifications to be sent to a Yammer group on the success or failure of a build.
Yammer Plugin on jenkins-ci.org.

This is an example of a successful build notification sent to the Build Notifications group:


Easy install

Install the plugin from the Jenkins Plugin Manager. It should be listed as Yammer Plugin under Build Notifiers.

Manual install

  • Install the ruby-runtime plugin.
  • Upload the .hpi file into Jenkins from Plugin Manager > Advanced.
  • Restart Jenkins.

Obtaining an Access Token

See: Obtaining an Access Token

Enabling Yammer Notifications

In the job configuration, under Post-build Actions, select Yammer Notification:

The Access Token defaults to an environment variable named YAMMER_ACCESS_TOKEN under the assumption that the same access token will likely be the same for many, if not all jobs.
For example, you might create a Yammer user representing Jenkins that will act as the source of all Yammer notifications from Jenkins.

Global environment variables can be set from Jenkins at Manage Jenkins > Configure System > Global Properties:

With the Access Token set, select whether to send success and/or failure notifications:

Both success and failure notifications require a message and a group name. Environment variables are also allowed.

Please ensure that the Yammer user associated with the OAuth token has been added to the specified groups,
otherwise the post will result in a HTTP 403 Unauthorised error.

Config File

The same settings specified in the job configuration can be provided as a JSON file that can be generated during the build. By default, the file should be named yammer.json under the workspace root.

Example file:

    "success": {
        "message": "This success message was generated by the build.",
        "group": "Build Notifications"
    "failure": {
        "message": "This failure message was generated by the build.",
        "group": "Build Notifications"

The file path can be changed in the 'Advanced' section of the job configuration.

Please note that the settings specified in the job configuration will be merged with the config file. Any duplicate settings will overidden by the config file.


Raise an issue


Version 1.1.0 (July 19, 2013)

  • Add config file so that settings can be generated during the build.

Version 1.0.0 (March 15, 2013)

  • Upgrade to OAuth 2.0 requiring only an access token.
  • Yammer group name replaces group ID.

Version 0.1.1 (March 15, 2013)

  • Use better OAuth terminology (consumer instead of client). Thanks mikec-bullhorn.

Version 0.1.0 (June 24, 2012)

  • Initial release.

Last updated: 2013-07-19 19:44:41 +1000


plugin-notifier plugin-notifier Delete
Enter labels to add to this page:
Please wait 
Looking for a label? Just start typing.