GitLab Slack Integration

Necessary Steps from GitLab:

1. GitLab Account Information

• Ensure that you have the account name of your GitLab account, which can be an organization or a personal account.
• Example: For an organization named "acme.inc" with a repository "core" hosted on GitLab, the URL would be ''https://gitlab.com/acme.inc/core.''

2. Access Token

• To create an access token from your GitLab account is doable. You can do this by clicking the user link in your profile or by visiting User Account > Preferences > Access Tokens
• If creating an access token for a particular project, guarantee that the role is set to the Developer at least.
• Minimum Scope: ''api''
• Store the token as you will need it for the integration.

Configuring the GitLab Slack Integration in Suptask

1. Navigate to Integrations

• Go to the Integrations page within the Suptask web admin interface.

2. Add New Integration

• Click on the +GitLab button to create a new GitLab integration.
• Provide a name for the integration and specify which Suptask ticket forms will trigger it. Tickets produced as a result of these forms will automatically get a corresponding ticket in GitLab.

3. Create Credentials

• Provide the GitLab server URL and the saved access token from step 2.
• These credentials can be reused for multiple integrations of the same type.

4. Specify GitLab Account and Repository:

• Enter the GitLab name as mentioned in step; ''GitLab Account Information''.
• List the exact names of the repositories you want to integrate with (case-sensitive).

5. Assign Default GitLab labels (Optional)

• Optionally, you can assign default GitLab labels to the tickets issued from Suptask.

6. Complete the Integration

• Complete the setup and finalize the integration.

Using the GitLab 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:

• You can edit the Description and Title of the issue being sent to GitLab.
• The Description field will have a default template which can be customized. Use Suptask ticket placeholders to include relevant ticket information automatically.