a user interacting with various Webex bots in different messaging spaces
Examples of Cisco-developed bots in use

Add the Jenkins bot to a Webex app space

To add the Jenkins bot to a Webex space

  1. Go to Messaging and choose a space to which you’d like to add the Jenkins bot.

    NOTE: You can also create a new space with just the Jenkins bot.

  2. Choose People, select Add People, and then enter the Jenkins bot email address: Jenkins02@webex.bot.
  3. Enter help or hi and send the message. In a group space, you can enter @jenkins help or @jenkins hi.
  4. In the help card, select Manage Notifications or enter the manage command to retrieve the bot management link.

There are no authorization steps within the Webex App itself. All notification configurations and authorizations are handled directly within your Jenkins environment, using the management portal. The bot simply relays the notifications based on the triggers you set up in Jenkins.

Jenkins bot commands

There are several commands you can use to interact with the Jenkins bot in Webex. To see the list send the message help in a direct space or @jenkins help in a group space.

Manage Jenkins bot notifications

You can create new notifications or manage existing notifications for actions in Jenkins, which will then trigger notification in the Webex app.

To manage Jenkins bot notifications:

  1. In the space containing the Jenkins bot, enter help and send the message.
  1. Select Manage Notifications and select a notification type or edit an existing notification.

    You can also enter @jenkins manage and send the message to manage notifications in a group space.

  2. Enter a name for your notification and follow the steps in the Jenkins management portal to create a new notification.

Only Jenkins account administrators can set up notifications in the Jenkins Portal.

Notification types

The possible event types for the Jenkins bot are:

  • Job Queued
  • Job Started
  • Job Completed
  • Job Finalized
  • Job Failed
  • Job Failed and First Success

You must choose the events to subscribe to using the Jenkins management portal.

Once you’ve set up your notifications, you’ll receive updates in Webex.