Skip to main content

​
Overview

The GitHub integration allows you to create GitHub issues directly from user feedback in SeggWat. When customers report bugs or request features, you can instantly convert them into trackable issues in your repository.
This integration uses a GitHub App to securely connect your repository. You control exactly which repositories SeggWat can access.

​
Features

  • One-click issue creation - Convert feedback to GitHub issues instantly
  • Automatic label mapping - Bug feedback gets the bug label, features get enhancement
  • Issue status sync - When issues are closed on GitHub, feedback can be marked as resolved
  • 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
You can grant access to all repositories or select specific ones. SeggWat only needs write access to create issues.

​
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/...)*

​
Label Mapping

SeggWat automatically maps feedback types to GitHub labels:
Feedback TypeGitHub Label
Bugbug
Featureenhancement
Questionquestion
Improvementenhancement
Praise(no label)
Other(no label)
Labels are only applied if they already exist in your repository. SeggWat does not create new labels.

​
Issue Status Sync

When a linked GitHub issue is closed:
  • SeggWat receives a webhook notification
  • The feedback item can be automatically marked as Resolved
  • You can see the issue status (Open/Closed) directly in SeggWat
This keeps your feedback list in sync with your actual issue resolution.

​
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
Disconnecting does not delete issues already created on GitHub. Existing feedback items will retain links to their GitHub issues.
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 (not a rating)
  • Verify the feedback 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

Feedback Collection

Set up widgets to collect feedback from users

Polar Integration

Track customer churn from Polar subscriptions