UPDATE 2/23/2012: Assistly is moving their endpoints to desk.com. If you've already installed this app prior to 2/23, you'll need to update and push the new code to Heroku:

cd myapp
git pull origin master
bundle update
git push heroku master

This is a little Sinatra app that allows you to integrate your Assistly tickets into Pivotal.

Inspired by airbrake_to_pivotal.

Uses the excellent assistly gem by zencoder though right now we're on my fork of the fork by bobbytables - only diff is that we use desk.com instead of assistly.com so we don't get shut down when they complete the transition.

1. Grab a copy of the source

   git clone git://github.com/andrewpbrett/assistly_to_pivotal.git

2. Create a Heroku app

   heroku create myapp

3. Add required config from your assistly API page.

           heroku config:add ASSISTLY_SUBDOMAIN=mysubdomain
           heroku config:add CONSUMER_KEY=your_key
           heroku config:add CONSUMER_SECRET=your_secret
           heroku config:add OAUTH_TOKEN=your_token
           heroku config:add OAUTH_TOKEN_SECRET=your_token

4. Add optional config to filter on only certain channels or labels

           heroku config:add ASSISTLY_LABELS=labels                # default is "" - retrieves all labels
           heroku config:add ASSISTLY_CHANNELS=channels        # default is "email"
           heroku config:add ASSISTLY_DAY_COUNT=count          # number of days of cases to retrieve; default is 7 to avoid timeout errors

5. Pick a username and password for Pivotal to use

   heroku config:add HTTP_BASIC_USERNAME=pivotal
   heroku config:add HTTP_BASIC_PASSWORD=password

6. Deploy to Heroku

   git push heroku master

7. Test you're getting XML back

   open http://myapp.heroku.com/

8. Add the integration to Pivotal. From the "Configure Integrations" page, add an "Other" integration.

   • Name: Assistly
   • Basic Auth username: What you picked for HTTP_BASIC_USERNAME
   • Basic Auth password: What you picked for HTTP_BASIC_PASSWORD
   • Base URL: https://[your_subdomain].assistly.com/agent/case/
   • Import API URL: http://myapp.heroku.com/
   • Active: Yes

9. From the "More" menu of Pivotal Tracker you should see "Assistly"

10. Buy me a beer.