Sign in

Confluence

Using the Automation option in Confluence, you can automate the creation of Confluence activity records in Steady for actions like publishing a new page, editing and existing page, or commenting.

Activities in Steady will appear alongside check-ins and in your team's activity stream.

Set up

  1. Navigate to the admin section of Confluence.
  2. Select Automation from the Admin Tools menu
  3. Select Create rule
  4. In the Add a trigger menu, select the trigger event. Ex: "Page published"
  5. Once the trigger has been selected, select THEN: Add an action.
  6. Select the Send web request action
  7. In the configuration screen, add https://service.statushero.com/api/v1/status_activities to the Web request URL field
  8. HTTP method should be POST
  9. In the Headers section, add headers for:
    1. X-TEAM-ID
    2. X-API-KEY
  10. For those values, go to the Team Settings section for your team and navigate to the API section. Copy and paste the string for Team ID to the value field for X-TEAM-ID. Use your Team API key for X-API-KEY
  11. Select Custom data from the Web request body dropdown. Enter the following custom data:
{"email":"{{page.author.emailAddress}}", "source":"Confluence", "description":"Published <a href='{{page.url}}'>{{page.title}}</a>"}

If you are using a trigger that is different than "Page published" customize the Published text to match. For instance, if you're using the "Page edited" trigger, change Published to Edited.


Finally, save the automation. That's it! To verify the integration is working, test publishing a page (or whatever your trigger is) and look on the Activity page in Steady to see if it's displaying.

Troubleshooting

  • Look for updates in the activity stream first. The dashboard will sum up updates from the previous period. (The check-ins essentially say "here's what I did yesterday, and here is all of the Confluence activity to go along with that.)
  • Check to make sure the email address that is being used in Confluence matches the email address that is being used in Steady. If you or a team member is using a different email address in Confluence, set the secondary email address in Steady to match the one used in Confluence.
  • Steady won't be able to record data retroactively. Make sure you generate some activity in Confluence in order to test things out after you've set up the connection.