Linear Integration

This guide provides a comprehensive overview of the Linear integration, from setup to daily use. It is intended for product managers, designers, researchers, and support agents who want to leverage customer feedback from Linear to drive product decisions.

Introduction

The Linear integration allows you to connect your Linear account to this platform, enabling a seamless flow of customer feedback. By integrating with Linear, you can:

  • Sync customer requests: Automatically pull in customer requests from your Linear account.
  • Analyze customer feedback: Use AI-powered tools to analyze request content and identify emerging trends, feature requests, and pain points.
  • Gain actionable insights: Translate customer feedback into actionable insights that can inform your product roadmap and strategy.
  • Create Linear issues from feedback: Create Linear issues directly from feedback clusters, linking customer feedback to your development workflow.

Setup Process

Connecting your Linear account is a straightforward process that uses OAuth2 for secure authentication. Here's how to do it:

  1. Navigate to the Integrations Page: From the main dashboard, go to Settings > Integrations.
  2. Select Linear: Find the Linear integration and click Connect.
  3. Authorize Access: You will be redirected to Linear and asked to authorize the integration. Click Authorize to grant access.
  4. Confirmation: After authorizing, you will be redirected back to the platform. The Linear integration will now show as Connected.

Data Synchronization

Once connected, the platform will automatically sync data from your Linear account. Here's a breakdown of how it works:

  • Initial Sync: The first time you connect, the platform will perform an initial sync of your Linear customer requests.
  • Ongoing Sync: After the initial sync, the platform will periodically sync new and updated customer requests. You can also trigger a manual sync at any time.
  • Data Collected: For each customer request, the platform collects the following information:
    • Request body
    • Priority
    • Customer name and domains
    • Associated issue details (title, description, URL, priority, labels)
    • Creation and update timestamps
  • Data Processing: The collected data is then processed by our AI models to:
    • Categorize feedback into types like "feature request," "complaint," or "bug report."
    • Identify keywords and themes.
    • Analyze sentiment.
    • Extract product areas and feature gaps.

User Interface

The Linear integration page provides a comprehensive overview of your synced data and allows you to manage the integration's settings. Here's a walkthrough of the key components:

  • Sync Status: This section shows the status of the latest sync, including the last sync time and the number of requests processed. You can also trigger a manual sync by clicking the Sync Now button.
  • Configuration: In this section, you can configure the integration's settings.
  • Create Linear Issue: From a feedback cluster, you can create a Linear issue by clicking the Create Linear Issue button. This will open a dialog where you can customize the issue's title, description, priority, and labels.
  • Disconnect: If you need to disconnect your Linear account, you can do so by clicking the Disconnect button. This will stop all data synchronization and remove your Linear credentials from our system.

Troubleshooting

If you encounter any issues with the Linear integration, here are some common problems and their solutions:

  • Integration is not connecting:
    • Permissions: Ensure that the user who authorized the integration has the necessary permissions in Linear to access customer requests and other data.
  • Customer requests are not syncing:
    • Sync is in Progress: Check the sync status to see if a sync is already in progress.
  • Data is not up to date:
    • Manual Sync: You can always trigger a manual sync to get the latest data.
  • Unable to create Linear issue:
    • Permissions: Ensure that you have the necessary permissions in Linear to create issues.

If you continue to experience issues, please contact us for assistance.