In this tutorial, we'll go over how to set up FireHydrant's integration with Clubhouse.
With our Clubhouse integration, you'll be able create and sync incidents and action items created in FireHydrant with tickets (stories) in Clubhouse.io.
You can start by navigating over to your Clubhouse.io workspace. From here, you'll want to navigate to Settings > API Tokens.
Once you're in the API Tokens page, you'll now be able to type in a name for the API token that will be generated. For this example below, I've named the token "FireHydrant Integration".
Copy the token that is generated and head over to FireHydrant's Clubhouse integration set up by going to the FireHydrant UI and clicking Organization > Integrations > Clubhouse "Setup", or by clicking here.
Within the set up page, paste in your API token generated from the step above. For now, you can skip the rest and click "Submit".
From here, head over to your Organization Overview page by clicking Organization > Overview > "Edit", or click here.
Under "Default Project For Tickets", you'll now be able to select which Project from Clubhouse that FireHydrant will send information to, and click "Save Organization". In the example below, the Clubhouse Project named "Incidents" was selected.
Lastly, head back over to your Clubhouse integration configuration page by visiting Organization > Integrations > Clubhouse "Configure Integration" (this is a separate page from the previous set up page). There will be no need to fill out another API token unless a new API token is generated from Clubhouse.
You'll now be able to configure the default story types to be created within Clubhouse whenever an incident or action item (task or follow-up) is created on FireHydrant. On top of this, you'll be able map the status of an incident or action item in FireHydrant to a Story State for its corresponding ticket in Clubhouse (in the example below, for instance, an action item in FireHydrant with the status of "In Progress" will have a Story State of "In Development" for its corresponding ticket in Clubhouse).
That's it! Now you'll be able to create and sync incidents and action items created in FireHydrant with tickets in Clubhouse.io. For more information on how ticketing and action items work in FireHydrant, click here.
To setup the integration as bi-directional, you'll need to set up a webhook configuration within Clubhouse.
You can start by grabbing your webhook payload URL from FireHydrant by visiting Organization > Integrations > Clubhouse "Configure Integration". From here, you'll need to copy the URL to your clipboard.
Next, navigate over to Clubhouse and select Integrations > Webhooks.
From here, you'll simply need to paste the URL into the "Payload URL" section and click "Add New Webhook".
You're all set! With our bi-directional integration, you'll be able to update the state of your story within Clubhouse, which will automatically update the status of the ticket in FireHydrant.