GitHub Slack Integration - A Ticketing System

Necessary Steps from GitLab:

1. GitHub Account Information

• Get the name of your GitHub account which you can create either as a private account or a company organization.
• Point out the GitHub account name (case-sensitive) that there no domain in it. Such as your URL is github.com/acme-inc, your account name should be acme-inc.

2. Access Token

• Create a personal access token from your GitHub account by navigating to 'github.com/settings/tokens'
• The scope for the token should be set to: repo: Full control of private repositories.
• Minimum Scope: ''api''
• Store the token securely, as it will be required for the integration setup in Suptask.

Configuring the GitHub Integration in Suptask:

1. Navigate to Integrations

• Access the Integrations page within the Suptask web admin interface.

2. Add New Integration

• Click on the +GitHub button to create a new GitHub integration.
• Give the integration a name and indicate the Suptask ticket forms that will activate the integration once they are submitted. These forms are automatically generated that correspond to the GitHub ticket.

3. Create Credentials

• Enter your GitHub username and the access token that you stored.
• Note: The GitHub username may differ from the account name.
• These credentials can be reused for multiple integrations of the same type.

4. Specify GitHub Account and Repository:

• Enter the GitHub account name collected earlier.
• You include the exact repository names you want to integrate
  (case-sensitive).

5. Assign Default GitLab labels (Optional)

• Optionally, add default GitHub labels to the tickets created from Suptask.

6. Activate the Slack GitHub Integration

• Complete the setup to activate the integration.

Using the GitHub Slack Integration

1. Access the Agent Responder Channel:

• Ensure you are in the Agent Responder channel in Slack.

2. Trigger Integration:

• Add the 🌪️ reaction emoji to a ticket message in the channel.
• Select the desired integration target from the prompt.

3. Edit Ticket Details:

• Using the available placeholders, one can automatically add Suptask ticket information into the GitHub issue.
• The 'ticketUrl' placeholder is particularly useful as it links directly to the Suptask ticket in Slack.