Appearance
GitHub
Connect GitHub and a draft can tell a customer whether a reported bug is known, whether it is still open, and which release fixed it. If you allow it, your support team can also open GitHub issues from a conversation or from a finding.
What you need
- A fine-grained personal access token, created at github.com/settings/personal-access-tokens. A classic token is refused, because it could push code to every repository you can reach.
- The repositories to read, in owner/name form.
Connect GitHub
- In GitHub, create a fine-grained token. Tick the repositories you will list, and give it read access to Metadata, Contents and Issues.
- To let your team open issues from a conversation or a finding, set Issues to read and write instead. Read is enough for everything else.
- In Overdesk, open Integrations and choose GitHub.
- Paste the token into Fine-grained token.
- List the repositories in Repositories, one per line, up to 20. A pasted GitHub URL works too.
- Click Connect. Overdesk checks that the token reaches each repository before saving anything, and the repositories sync that night.
If a repository comes back as not found, the token was usually not given access to it. A fine-grained token reaches only the repositories you ticked when you created it.
What Overdesk reads
Each night Overdesk syncs the issues and published releases of the repositories you list, so a draft can name the version a fix shipped in. It also indexes each repository's file list and README, and can open a single file while a draft is being written when the answer depends on what the code does. Your code is never added to the knowledge base, and Overdesk is instructed not to paste your source into a reply.
On a public repository, an issue opened by someone outside your team is kept as its number and status, without the report. An owner's, member's or collaborator's issue is read in full, and so is every issue in a private repository, except the ones Overdesk opened. See GitHub, Linear and Jira.
Opening issues
Opening an issue from a conversation or a finding is the one thing Overdesk writes to GitHub. A person confirms every issue, and email addresses, card numbers and international and North American phone numbers are stripped out first. When the repository is public, the form warns you before you post. An issue Overdesk opens comes back into your knowledge base as its title and status only. See Creating issues from a conversation.
It needs the token's Issues permission set to read and write. If your token is read-only, Overdesk says so when someone tries, and the fix is to edit the token in GitHub and change Issues from read to read and write.
Change repositories later
On the GitHub page in Integrations, under "Which repositories should Overdesk read?", add or remove repositories without reconnecting. The token must already have access to any repository you add. Removing one takes its issues and releases out of your knowledge base, and your team can no longer open issues in it. Nothing in GitHub is touched.