A hubot script to listen for bitbucket activity
Last updated 5 years ago by andrewtarry .
MIT · Repository · Bugs · Original npm · Tarball · package.json
$ cnpm install hubot-bitbucket 
SYNC missed versions from official npm registry.

Hubot Bitbucket Listener

Build Status

The Hubot Bitbucket listener allows custom Bitbucket Post hooks be set up that will inform Hubot when events occur. The hook data will then be parsed and an event will be fired that custom scripts can listen for.


Install the package with npm install hubot-bitbucket --save and add it to your external-scripts.json.



There are two optional environment variables that can be set to customise the listener.

Variable Default Effect
HUBOT_BITBUCKET_PUSH_URL /bitbucket/push The route bitbucket should post to
HUBOT_BITBUCKET_PUSH_EVENT bitbucketPushReceived The event that will emitted when the push is received


The Hubot Bitbucket Listener will not do anything with the data by default so there will be nothing added to a room. The listener will only parse the request and emit and event that you can listen for. If you want to have Hubot notify a room then you can easily do that.

robot.on "bitbucketPushReceived", (pushEvent) ->
    push = pushEvent.push

    # Do things

The push variable is an object that will with data from the Bitbucket hook.

repository = push.repo
repository_url = repository.url # e.g.
repository_name = # e.g. Project X
repository_slug = repository.slug # e.g. project-x

for commit in push.commits
	author = # bitbucket username
	branch = commit.master # e.g. master
	message = commit.message # A really clear message

	for file in commit.files
		file = file.filename # e.g.
		type = file.type # i.e. modified, added etc

You can listen for the event and use as much of the data as you want.

Current Tags

  • 0.1.1                                ...           latest (5 years ago)

2 Versions

  • 0.1.1                                ...           5 years ago
  • 0.1.0                                ...           5 years ago
Maintainers (1)
Today 0
This Week 0
This Month 0
Last Day 0
Last Week 0
Last Month 0
Dependencies (1)
Dev Dependencies (3)
Dependents (2)

Copyright 2014 - 2016 © |