GitHub Integration

Overview

The GitHub integration allows you to create GitHub issues directly from user feedback and ideas in SeggWat. When customers report bugs, request features, or vote on ideas, you can instantly convert them into trackable issues in your repository.

Features

• One-click issue creation - Convert feedback or ideas to GitHub issues instantly
• Automatic label mapping - Bug feedback gets bug, features get enhancement, ideas get feature-request
• Bidirectional status sync - When issues are closed on GitHub, feedback and ideas are updated automatically
• Screenshot inclusion - Attach user screenshots directly in the GitHub issue body
• Milestone support - Optionally assign issues to a default milestone

Setup Instructions

Step 1: Open the GitHub Integration

1. Navigate to your project in SeggWat
2. Go to Integrations in the sidebar
3. Click on the GitHub integration card

Step 2: Install the GitHub App

1. Click Connect GitHub in the integration modal
2. You'll be redirected to GitHub to install the SeggWat App
3. Choose which account or organization to install the app on
4. Select the repositories you want SeggWat to access
5. Click Install to authorize the app

Step 3: Select a Repository

After installing the GitHub App:

1. You'll be redirected back to SeggWat
2. A list of accessible repositories will appear
3. Select the repository you want to link with this project
4. Click Connect Repository

Step 4: Integration Complete

Once connected, you'll see:

• The linked repository name with a link to GitHub
• Screenshot inclusion status (enabled by default)
• Integration status (Active)

Creating Issues from Feedback

Once the integration is configured:

1. Open any feedback item in your project
2. Click the Create GitHub Issue button
3. The issue is created with:
   • A title based on the feedback type and message
   • The full feedback message in the body
   • A link back to the feedback in SeggWat
   • The user's screenshot (if enabled and available)
   • Automatic labels based on feedback type

Issue Content

Created issues include:

**Feedback Message:**
[User's feedback text]

**Type:** Bug
**Page:** /pricing
**Version:** 1.2.3

**Screenshot:**
[Embedded image if available]

---
*Created from [SeggWat feedback](https://seggwat.com/org/.../feedback/...)*

Creating Issues from Ideas

If you have the Ideas board enabled, you can also create GitHub issues from feature requests:

1. Navigate to Features in your project
2. Open any idea
3. Click the Create GitHub Issue button
4. The issue is created with:
   • The idea title as the issue title (or a custom title you provide)
   • The description in the issue body
   • Automatic feature-request label
   • Tag names as additional labels (e.g., mobile, ux)
   • Vote count and status in the body
   • A link back to your feature board

Issue Content for Ideas

Created issues from ideas include:

## Idea

**Status:** Under Review
**Votes:** 42
**Tags:** `mobile`, `ux`

## Description

[Idea description]

---
*Created from [SeggWat Idea](https://seggwat.com/...)*

Label Mapping

SeggWat automatically maps feedback types to GitHub labels:

Feedback Type	GitHub Label
Bug	bug
Feature	enhancement
Question	question
Improvement	enhancement
Praise	(no label)
Other	(no label)

Issue Status Sync

SeggWat keeps feedback and ideas in sync with GitHub issue state via webhooks.

For feedback items:

GitHub Issue State	Feedback Status
Closed	Resolved
Reopened	Active

For ideas:

GitHub Issue State	Idea Status
Closed	Completed
Reopened	Started

This keeps both your feedback list and feature roadmap in sync with your actual development progress.

Configuration Options

Screenshots

By default, user screenshots are included in GitHub issues. The screenshot appears as an embedded image in the issue body.

To disable screenshots:

1. Open the GitHub integration settings
2. Toggle Include Screenshots off
3. Future issues will not include screenshot images

Default Milestone

You can optionally set a default milestone for all created issues:

1. Open the GitHub integration settings
2. Select a milestone from the dropdown
3. All new issues will be assigned to this milestone

Disconnecting

To remove the GitHub integration:

1. Open the GitHub integration modal
2. Click Disconnect
3. The integration is removed from SeggWat

To revoke SeggWat's access entirely:

1. Go to your GitHub App Installations
2. Find the SeggWat app
3. Click Configure and then Uninstall

Troubleshooting

"Create GitHub Issue" button not visible

• Ensure the GitHub integration is connected for your project
• Check that you're viewing a feedback item or idea
• Verify the item doesn't already have a linked issue

Issue creation fails

1. Check the integration status in the Integrations page
2. Ensure the GitHub App still has access to the repository
3. Verify you have write permissions to the repository
4. Check that the repository still exists

Labels not being applied

GitHub labels must exist in your repository before SeggWat can apply them. Create labels named bug, enhancement, or question in your repository's Labels settings.

Webhook sync not working

Issue status sync requires webhook delivery. If issues aren't syncing:

1. Go to your GitHub App settings
2. Click Configure on the SeggWat app
3. Check for any webhook delivery failures
4. Ensure the app has not been suspended

Privacy & Security

SeggWat's GitHub App:

• Only requests necessary permissions (issues: write)
• Cannot access your source code
• Only connects to repositories you explicitly authorize
• Uses secure OAuth flow for authentication
• Stores only the installation ID and repository reference

Next Steps