​
Linear Integration

Connect BuildBetter with Linear to automatically create and track issues based on customer conversations, ensuring feedback directly influences your product roadmap.

​
Features

  • Automated Issue Creation: Generate Linear issues from meeting signals and insights
  • Custom Workflows: Map conversation signals to specific Linear teams and projects
  • Rich Context: Include meeting snippets, timestamps, and customer details in issues
  • Two-way Sync: Update status in either system and keep everything in sync
  • Priority Mapping: Convert customer sentiment and frequency into Linear priority

​
Setup Guide

​
Prerequisites

  1. Linear Requirements:
    • Linear account (any paid plan)
    • Admin access for API key generation
    • Teams and projects configured
  2. BuildBetter Requirements:
    • Active BuildBetter account
    • Admin privileges for integration setup

​
Installation Steps

  1. Connect Linear
    • Go to Settings > Integrations in BuildBetter
    • Click “Connect” under Linear
    • Enter your Linear API key
    • Select teams and projects to connect
  2. Configure Workflows
    • Map signal types to Linear teams/projects
    • Set up issue template mappings
    • Configure priority and status defaults
    • Define custom field mappings
  3. Test Integration
    • Create a test signal
    • Send to Linear
    • Verify issue creation and field mapping

​
Usage

​
Creating Issues from Conversations

After a customer call:
  • Review and approve extracted signals
  • Select “Send to Linear” from the signal actions menu
  • Choose team, project, and other attributes
  • BuildBetter creates a detailed issue with context

​
Bulk Issue Creation

For multiple signals:
  • Filter signals by type, meeting, or customer
  • Multi-select relevant signals
  • Use “Bulk Actions” → “Send to Linear”
  • Apply team/project mapping

​
Workflow Automation

Example automated workflows:
  • Feature request signals → Product team issues
  • Bug reports → Engineering team issues
  • UI/UX feedback → Design team issues
  • Customer success concerns → CS team issues

​
Templates and Formatting

BuildBetter creates Linear issues with:
  • Clear, automatically generated titles
  • Detailed descriptions with context
  • Embedded audio/video clips when relevant
  • Customer attribution and metadata
  • Links back to the full conversation

​
Advanced Configuration

  • Custom Fields: Map BuildBetter signal attributes to Linear custom fields
  • Labels: Automatically apply labels based on signal classification
  • Relations: Create issue relationships based on related signals
  • Webhooks: Trigger BuildBetter actions when Linear issues change status

​
Support

Need help? Contact us: