1. Home
  2. Integrations
  3. Hubot Integration Guide – VictorOps

Hubot Integration Guide – VictorOps

Hubot is your company’s robot. Install him in your VictorOps timeline to dramatically improve employee efficiency.

The Hubot – VictorOps Adapter allows your Hubot to join your VictorOps timeline. You can then address Hubot with timeline chat messages in the usual way. After giving your Hubot instance a name (just Hubot in the example below) you can then address it from the timeline with or without an @.


Configuration Steps:

  1. First, if you have not already, install Hubot according to these instructions: https://github.com/github/hubot/tree/master/docs
  2. In VictorOps, select Settings >> Alert Behavior >> Integrations >> Hubot.
    If the integration has not yet been enabled, click the “Enable Integration” button to generate your endpoint URL as seen below.  Be sure to replace the “$routing_key” section with the actual routing key you intend to use. (To view or configure route keys in VictorOps, click Alert Beahvior >> Route Keys)

  3. You can then follow the installation steps on Github copied below here:


First, install Hubot according to the instructions: https://github.com/github/hubot/tree/master/docs

  1. Add the VictorOps adapter to your Hubot’s dependencies in package.json:
    "dependencies": {
      "hubot-victorops": ">=0.0.2",
  2. Run Hubot with the VictorOps adapter:
    bin/hubot --adapter victorops


Your Hubot will need a login key to connect to VictorOps. Your Hubot key is available at the “Hubot” link of your VictorOps Integrations page. Configuration of the key is in an environment variable:

export HUBOT_VICTOROPS_KEY=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

Installation alternatives

Rather than edit your Hubot’s dependencies, you can install the adapter directly from github:

npm install git://github.com/victorops/hubot-victorops.git

Or from npmjs.org:

npm install hubot-victorops

Hubot and the Transmogrifier

You can annotate Hubot commands directly to take automated actions.

To accomplish this you will need an additional Hubot script that can be found here.

Then you will need to add an annotation with the name “HUBOT COMMAND” and you will be able to all Hubot programatically.



Updated on March 10, 2017

Was this article helpful?

Related Articles