Trello
Add Trello cards to a list from monitoring errors and docs feedback.
What you need
Get an API key and a token from a Trello Power-Up you own, under its API key settings. Cards are created as the token's owner.
Connect it
- Open Integrations
Open Integrations in the project sidebar and choose Trello under Issue tracking.
- Fill in the details
Paste the list's ID, the API key and the token. Octri reads the list's name back and shows it on the card.
- Press Connect
Octri checks the details with Trello before it saves, and says what's wrong if Trello refuses them.
Settings
List IDstringrequiredThe 24-character ID of the list cards go in.
API keysecretrequiredYour Power-Up's 32-character API key.
TokensecretrequiredA token generated for that API key.
Keys and tokens are stored encrypted and never shown again: the card shows only a masked preview. To change another field later, leave the secret empty and the saved one is kept.
From a monitoring issue
Open an issue in Monitoring, on the Issues tab, and press Create issue. If several trackers are connected, pick one first. Octri opens one Trello card per monitoring issue: after that, the button is a link to it, labelled with its number, such as #42.
The card is titled with the error, and says:
- how many times it was seen, by how many users, and when first and last
- the endpoint, as method and path, when there is one
- the culprit, when there is one
- a link back to the project's issues in Octri
- the last stack trace, as a code block in the description
From docs feedback
Turn on Send docs feedback here on the Trello card to collect what readers say about your docs. With page feedback on, a reader who votes No is asked what was missing. The first comment on a page opens a card titled Docs feedback: <page>, and later comments on that page are added to it, so each page collects its feedback in one place.
Octri passes each comment on and doesn't keep it. Votes are counted in Octri either way.
When it refuses
If Trello turns the credentials down, the message says so with the HTTP status it answered. Check the token still works and can see the list. Trello is given ten seconds to answer.
Disconnect
Press Disconnect on the card. Trello cards already opened stay where they are. If Trello was receiving docs feedback, readers' comments stop being asked for until another tracker takes it.
Connecting and changing trackers needs permission to edit project settings. Opening an issue from monitoring needs permission to edit monitoring. See organizations and roles.