searchspring/asana-github-pr-webhook

Github - Asana Connector

Outdated! Please use the github app that is now supported for business asana accounts.

Asana Github PR Webhook

Connects Github and Asana when you put an Asana ID at the beginning of a PR title.

Usage

Use the last 4 digits of an Asana task ID at the beginning of a PR name or at the beginning of the description.

See a link to the PR appear as a comment on that task in Asana.

See a link to the Asana task appear as a comment on the PR.

Installation

1. Get an Asana access token

• To get an access token go to 'My Profile Settings' -> Apps -> 'Manage Developer Apps' -> 'Create new personal access token'.
• Make a note of the access token as you'll need it later on. <asana access token>

2. Get your Asana workspace id

• Make sure you're logged in to asana and go to https://app.asana.com/api/1.0/workspaces
• Make a note of the gid as you'll need it later on. <workspace id>

3. Get an Github access token

• To get an access token go to 'Settings' -> 'Developer Settings' -> 'Personal Access Token' -> 'Generate new token'.
• Under 'scopes' select 'Repo'.
• Make a note of the access token as you'll need it later on. <github access token>

4. Deploy the application

This project uses Zeit Now to deploy, which requires only a github account and gives you 2 million free invocations a month.

• Create a long, random password that we'll refer to as <webhook secret>
• Fork this repo and download it.
• Change the now.json config to choose a different alias as you won't be able to use the default. We'll refer to this URL as <url>
• Run npm init
• Run

  now \
    -e WEBHOOK_SECRET="<webhook secret>" \
    -e ASANA_ACCESS_TOKEN="<asana access token from step 1>"\
    -e WORKSPACE_ID="<workspace id from step 2>"\
    -e GITHUB_ACCESS_TOKEN="<github access token from step 3>"

• Run now alias to set the non-changing URL that we can use in step 5.

5. Setup webhooks in Github

• For the github project you want to integrate, go to settings -> webhooks -> add a new webhook.
• Set the Payload URL to https://<url from step 3>/webhook.js
• Set the content type to application/json
• Set the secret to <webhook secret>
• Set the events to 'Let me select individual events' and check the box next to 'Pull Requests'
• Save.

Everything should work.

asana-github-pr-webhook's Issues

Stale `now` documentation

Issue Description

It looks like #35 deprecated the now.json file in favor of a vercel.json file. This change has caused the "Deploy the application" documentation in the README to become stale; specifically, the content around updating now.json and running > now \ .....

I attempted forking and trying to npm install vercel, but couldn't really figure it out (typical python dev, right 😉). Anyway - I thought I'd let you know about the issue b/c it probably feels like a quick patch on your end.

Thanks for the library; I'm really hoping our team can use it!

We couldn't deliver this payload: timed out

Hey I would love to use this integration, how can I troubleshoot a timeout error?

Issue

Following the steps, I get the following behavior:
✅ "worked" if I don't specify last 4 digits of an asana task
❌ Timeout error if I specify 4 digits

Screenshot

Github

Vercel (Zeit)

Does not seem to able to interface with asana

I followed the instructions, was very easy.
Github shows that the webhook is being called, and it returned it worked in the body of the response, but nothing is posted to asana and the Pr doesnt get updated with asana details

README refers to wrong step numbers

Run now alias to set the non-changing URL that we can use in step 4.

4. Setup webhooks in Github
   For the github project you want to integrate, go to settings -> webhooks -> add a new webhook.
   Set the Payload URL to https://<url from step 3>/webhook.js

Change to use auth header instead of url param

https://github.com/codeallthethingz/asana-github-pr-webhook/blob/4d5dc0e274994bb711b7e72f28cb6c15f5a43fca/src/githubator.js#L12