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

Add the GitHub Cloud bot to a Webex app space

To add the GitHub Cloud bot to a Webex app space:

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

    You can also create a new space with just the GitHub Cloud bot.

  2. Choose People, select Add People, and then enter the GitHub bot email address: GitHub02@webex.bot
  3. The bot responds with a card in the space to continue. If you’re in a direct space, send a Hi message to the bot.
  4. Select Link GitHub Account and log in with your GitHub credentials.
  5. When your GitHub account is linked, in the space with the bot, send the message help.

To list Github bot commands, send the message help in a direct space or @github help in a group space.

You can create new notifications or manage existing notifications for actions in GitHub for which you’ll receive notifications in the Webex app.

To manage GitHub notifications:

  1. In a direct space with the GitHub bot, send the message, manage.

    You can also enter the message, @GitHub manage, to manage notifications when interacting in a group space.

  2. Enter a name for your notification, choose your authorization, configure the notification message, and then select Save.

Notification types

The following notification event types are available:

  • Workflow Job
  • Discussion Comment
  • Discussion
  • Collaborator Added
  • Issue Comment Deleted
  • New Branch or Tag Created
  • Release Published
  • Commit Pushed
  • Issue Comment Updated
  • Branch or Tag Deleted
  • Repository Forked
  • Commit Status Updated
  • Repository Starred
  • Commit Comment Added
  • Pull Request Comment Added
  • Wiki Page Added or Edited
  • Collaborator Removed
  • New Deployment Created
  • Deployment Status Updated
  • Team Repository Added
  • Workflow Run
  • New Issue Create
  • Issue Updated
  • Issue Comment Added
  • Pull request opened

Notifications for event types can be set from the management portal as described above.

The following sections cover managing Github issues.

Create a GitHub issue

To create an issue in GitHub directly from your space:

  1. In the space with the GitHub bot, send the message, help.
  2. Select Create Issue.
  3. You can also send the message, @github create, to create an issue.

You’ll get multiple cards one after another asking you to choose an organization and repository before you can fill in the form to create an issue.

Update a GitHub issue

To update a GitHub issue:

  1. In the space with the GitHub bot, send the message, help.
  2. Select Edit Issue.

    You can also enter @github update in a group space to update an issue.

  3. Select the owner or organization and then choose the repository.
  4. Select the issue from the list of issues and select Continue.
  5. Fill in the form to update the issue accordingly:

Retrieve details about a GitHub issue

To retrieve and review details about a GitHub issue:

  1. In the space with the GitHub bot, send the message, help.
  2. Select View Issues.
    >

    You can also enter @github view in a group space to get details about an issue.

  3. Select the owner or organization and then select the repositories from the card provided by the bot.
  4. Choose an issue and select Continue to get the issue details: