Integrations overview

Tracker has integrations with several popular tools, including defect tracking systems and customer support apps: Bugzilla, Jira, Lighthouse, Zendesk, and Get Satisfaction.

Also tools such as Slack, and GitHub have integrations with us—see the Tracker Integrations for more.

Tracker can also publish activity in your project to Twitter, a Campfire chatroom, or a custom application that listens to HTTP requests. You can create Other integrations in any project you own that allow you to import from and link to Tracker stories, to tickets or issues in external bug tracking, or to customer support applications. You can also associate your source code commits with stories and update story state automatically via special commit message syntax.

You may need to open up your firewall to allow incoming requests from Tracker integrations (e.g., if you have an internal JIRA instance). If this is needed, ask your network administrator to allow the IP addresses for the following:

  • app01.pivotaltracker.com

  • app02.pivotaltracker.com

  • app03.pivotaltracker.com

However, please note that the IPs assigned to these addresses may change without notice.

Setting up an external tool integration

Tracker allows your team to prioritize and collaborate around stories that are linked to issues/tickets in other systems (e.g., bug-tracking applications, customer support ticket systems, etc.). You can find more detailed setup information for each external tool integration in that specific tool’s Help Center article. However, in general, external tool integrations will involve these steps:

  1. Click the Settings tab in your project, then choose Integrations in the sidebar.

  2. Scroll down to the External Tool Integration section and choose the type of integration from the dropdown on the far right.
    A drop down displaying the list of integrations available

  3. Configure and activate the integration. Enter your integration-specific configuration details. Most will require some form of user credentials, location/URL information, and possibly the ID of a saved search or a filter. We’re using Jira as an example here, but specifics for each integration type are included below.
    The JIRA integration configuration screen

  4. Import stories from an external tool. After you create an integration, you should see a new option in your project’s sidebar with the name you gave your integration.

  5. Click on the integration name from the sidebar. If you’ve configured the integration properly, when you open the Integrations panel, you should see a list of tickets or issues from the external tool:<br A list of tickets or issues displayed in Tracker from the external tool for JIRA

  6. Drag an issue or ticket into the Icebox or Backlog. This will create a new story, linked to the external issue/ticket. Stories that have external links have an “E” in the story icon, as shown here:
    A story in Tracker with an 'E' displayed in the story's bug icon

  7. Work on linked stories in Tracker. Depending on the integration type, state changes and comments to linked stories will be reflected in the integrated external tool/application. For example, starting a linked story will mark the corresponding JIRA issue as In Progress, and when the story gets accepted, the ticket will be marked as Resolved.
    Comment activity shown in JIRA, generated from the Tracker integration

Next
Lighthouse