Trello - API key and token
~2 min, onceTrello asks for two things: an API key and a token. Both come from one place.
- Sign in to Trello, then open trello.com/power-ups/admin.
- Click New and create a Power-Up - call it Sayso, pick your workspace. (It's just a container for your key; nothing gets installed on your boards.)
- Open it and go to the API key tab, then Generate a new API key. Copy the key.
- To the right of the key, click the Token link, click Allow, and copy the token it shows you.
- In Sayso's side panel, open the Trello export settings, paste the key and token, and pick your board and list. Done - next time it's one click.
Asana - personal access token
~1 min, onceAsana uses a single personal access token.
- Sign in to Asana, then open app.asana.com/0/my-apps. (Long way round: your profile photo → Settings → Apps → Manage developer apps.)
- Click Create new token, name it Sayso, and click Create token.
- Copy it straight away - Asana only shows it once. (Lost it? Just delete that token and make another.)
- In Sayso's side panel, open the Asana export settings, paste the token, and pick your project. Done.
Slack - incoming webhook
~2 min, onceSlack works through an incoming webhook - a private URL that lets Sayso post a summary into one channel you choose, and nothing else. You create it inside your own workspace:
- Go to api.slack.com/apps and click Create New App → From scratch.
- Name it Sayso, pick your workspace, and create it. (This is a private mini-app that only exists in your workspace - nobody else can see or use it.)
- In the left menu choose Incoming Webhooks and switch them On.
- Click Add New Webhook to Workspace, pick the channel your reviews should land in, and Allow.
- Copy the webhook URL (it starts
https://hooks.slack.com/) and paste it into Sayso's Slack export settings. Done.
Common questions
Do I have to do this every time?
No - once per tool. Sayso saves the key in the extension on your machine and it keeps working until you revoke it (in Trello, Asana or Slack) or disconnect it in Sayso.
Is it safe to paste keys into Sayso?
The keys live in your browser's extension storage, on your machine. When you export, they go directly from your browser to Trello, Asana or Slack - Sayso has no server of its own in the middle. Revoking a key at the source kills it instantly everywhere.
Which one should I use?
Wherever your dev work already lives. Trello and Asana make one card or task per point, screenshot attached, so points drop straight into an existing workflow. Slack posts a summary with a link, best for keeping a team channel in the loop. And the client link needs none of this - clients never sign in to anything.
Something's not connecting?
Nine times out of ten it's a copy-paste that clipped a character - paste the key again. Otherwise email support@sayso.digital and Sam will sort it.