Integrating with Groove

Beanstalk has a built-in integration with Groove, an online help desk service. After configuring your repository to work with Groove you can use commands inside your commit messages to post updates to your Groove tickets.

Configuring the integration

In order to use the integration you will need to connect your Beanstalk repository to your Groove account. Please note that you need to be an admin in Beanstalk to setup the integration.

To start go to your repository then follow navigation to Settings > Integration page and click on Groove logo in the integrations list. Click on the Activate integration button to start the setup process. Beanstalk will then guide you through the process of connecting your repository to Groove, just follow the instructions. You will need your Groove Private Token handy in order to complete the configuration.

Can't find your Groove Private Token?

In Groove click Settings at the top right corner of your screen, then click API. The token should now appear on your screen.

Referencing Groove tickets in your commits

Once the integration is active you will be able to specify Groove ticket numbers in your commit messages to associate those commits with Groove tickets:

  <code>Commit message [#1234]

When Beanstalk receives this commit it will connect to your Groove account, find a ticket with ID 1234 and post information about the commit to it as a private note with a link back to your Beanstalk repository. Link to that Groove ticket will also appear on Activity and Changeset pages for quick access.

Changing Groove ticket state from commits

In addition to simply referencing tickets from your commits you can also change ticket states:

  <code>Commit message [#1234 state: closed]

After receiving this commit Beanstalk will update this ticket's state to closed. Below is a list of available states that you can use:

• unread
• opened
• follow_up
• pending
• closed
• spam

Missing something?

If there's something lacking in our integration with Groove or you want it to be improved, do let us know. We love working on our integrations with other services to make them easy to use and useful.