Skip to content

Flowdock integration

netwolfuk edited this page Nov 24, 2015 · 17 revisions

tcWebHooks can post messages into a new thread on Flowdock. A new thread is created for each build type and branch combination.

To use this integration, you must be running version v1.1-alpha4.54.105 (or later) of the tcWebHooks plugin, which was still in Alpha at the time of writing.

Screenshot of Flowdock output from template

Creating an account for tcWebHooks in Flowdock

Go to https://www.flowdock.com/oauth/applications and click the "New Application" button to create a new Developer Application account.

  1. Enter a name for your account: Eg, TeamCity
  2. Check the box labelled Shortcut application
  3. Choose a small (128x128) icon for your account. This one is a good example.
  4. Scroll to the bottom and click Save

Your developer application account should now be created. Next, let's create a new Source

Creating a new Source for tcWebHooks in Flowdock

If you have followed the instructions above, you will have an application called "TeamCity".

  1. On the developer application page click the button named Tools (or scroll down).
  2. Fill in the form to create a new Source.
  3. Give your source a name, something like tcWebHooks would be fine.
  4. Choose a Flow to post into. You probably have one called Main, or you can choose another if you would prefer.
  5. Click the Generate Source button.
  6. Copy the generated Flow token. You need to use this for the URL when configuring tcWebHooks.

Add a new WebHook to TeamCity.

If you have not already installed the tcWebHooks plugin in TeamCity, see the installing documentation.

  1. Navigate to the WebHooks tab in any project or build in TeamCity.
  2. Click the applicable Edit Project webhooks link.
  3. Create a new WebHook.
  4. Enter the URL as https://api.flowdock.com/messages?flow_token=*your_flow_token* Use the flow token value obtained in step 6 above.
  5. Choose Flowdock Integration as the Payload Format.
  6. Select the Build Events you'd like to be posted into your flow.
  7. Click Save.