Features
- Automated Issue Creation: Generate Linear issues from meeting signals and insights
- Project Linking: Link custom objects to Linear projects for tracking development work
- 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
-
Linear Requirements:
- Linear account (any paid plan)
- Admin access for API key generation
- Teams and projects configured
-
BuildBetter Requirements:
- Active BuildBetter account
- Admin privileges for integration setup
Installation Steps
-
Connect Linear
- Go to Settings > Integrations in BuildBetter
- Click “Connect” under Linear
- Enter your Linear API key
- Select teams and projects to connect
-
Configure Workflows
- Map signal types to Linear teams/projects
- Set up issue template mappings
- Configure priority and status defaults
- Define custom field mappings
-
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
Project Linking
Link your BuildBetter custom objects (like Cycles, Initiatives, or custom entities) directly to Linear projects. This creates a live connection between customer feedback and your development work.How It Works
Custom objects can have an “integration object” property that links to Linear projects. Once linked, you can:- See the project name and status directly in BuildBetter
- Click through to the project in Linear
- Update project status from BuildBetter
- Filter custom objects by linked project
Linking a Project
- Open a custom object with a Linear project property
- Click the property field
- Choose from:
- Link existing project: Search and select from your Linear projects
- Create new project: Create a new Linear project and link it immediately
Project Actions
Once a project is linked, you can:| Action | Description |
|---|---|
| View in Linear | Click the external link icon to open the project in Linear |
| Mark as Done | Update the project status to “completed” |
| Unlink | Remove the link without deleting the Linear project |
| Refresh | Update the cached project data from Linear |
Status Indicators
Linked projects display their current status with color-coded badges:- Backlog (gray): Not yet started
- Planned (blue): Scheduled for work
- Started (yellow): In progress
- Paused (red): On hold
- Completed (green): Finished
- Canceled (gray): Not proceeding
Filtering by Project
You can filter custom object lists by linked Linear project to:- See all items related to a specific project
- Track customer feedback driving a project
- Monitor progress across related work
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:- Email: support@buildbetter.app
- Visit our Help Center
- Schedule a setup call