Integrations
Connect external tools to your helpdesk to streamline workflows. Integrations let your staff create and track issues in tools like GitHub directly from tickets, without leaving Discord or the dashboard.
Connecting GitHub
The GitHub integration allows staff to create GitHub issues from tickets and receive Discord notifications when issue status changes. Follow these steps to connect your GitHub organization or account:
- Navigate to Dashboard → Integrations → GitHub.
- Click "Install GitHub App". You will be redirected to GitHub to authorize the Tixie app.
- Select the organization (or personal account) and the repositories you want to grant access to. You can limit access to specific repos or allow all repositories.
- Once redirected back to the dashboard, select which of the installed repositories your staff should be able to use when creating issues from tickets.
Repository Access
Creating Issues from Tickets
Once GitHub is connected, staff can create GitHub issues directly from any ticket:
- Open a ticket from the Ticket Logs or Staff Queue in the dashboard.
- Scroll down to the "Linked Issues" section.
- Click "+ Create Issue".
- Select a repository, fill in the issue title and body, then click Create.
The newly created issue will appear in the Linked Issues section with a direct link to GitHub. Multiple issues can be linked to a single ticket.
Status Sync
Tixie automatically listens for status changes on linked GitHub issues. When an issue is closed or reopened on GitHub, a notification is posted in the ticket's Discord thread so staff and the ticket creator stay informed without checking GitHub manually.
Status sync is powered by GitHub webhooks and happens in near real-time. No polling or manual refresh is required.
Settings
Configure integration behavior from the Integrations page in your server's dashboard:
| Setting | Description |
|---|---|
| Default Labels | Labels automatically applied to every issue created from Tixie. Useful for filtering Tixie-created issues in GitHub (e.g., a tixie label). |
| Issue Body Template | A template for the default issue body when staff create issues. Supports variables that are replaced automatically (see below). |
| Discord Notifications | Toggle whether status changes on linked GitHub issues are posted as messages in the ticket's Discord thread. Enabled by default. |
Issue Body Template Variables
The following variables can be used in your issue body template. They are replaced with actual values when an issue is created:
| Variable | Replaced With |
|---|---|
{{ticket.id}} | The ticket number |
{{ticket.title}} | The ticket title or topic |
{{ticket.url}} | Link to the ticket in the dashboard |
{{ticket.creator}} | The Discord username of the ticket creator |
{{ticket.category}} | The ticket category name |
{{guild.name}} | The Discord server name |
More Integrations Coming