> ## Documentation Index
> Fetch the complete documentation index at: https://docs.buildbetter.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Conversations & Messaging

> Import and analyze customer conversations from support and communication platforms

<Note>
  **About Conversations**: This section covers **imported conversations** from external platforms like Intercom, Zendesk, and Slack. BuildBetter does not have internal team messaging - use your existing communication tools and import those conversations for analysis.
</Note>

BuildBetter extends beyond meetings to capture insights from all your customer conversations. Import support tickets, chat messages, and communication threads to build a complete picture of customer interactions across every touchpoint.

## Understanding Conversations

Conversations in BuildBetter represent any multi-message exchange between your team and customers:

<CardGroup cols={2}>
  <Card title="Support Tickets" icon="ticket">
    Help desk conversations from Intercom, Zendesk, Kustomer
  </Card>

  <Card title="Chat Messages" icon="comments">
    Team discussions from Slack, Microsoft Teams
  </Card>

  <Card title="CRM Activities" icon="users">
    Salesforce cases and HubSpot ticket conversations
  </Card>

  <Card title="Development Discussions" icon="code">
    GitHub issues and pull request conversations
  </Card>
</CardGroup>

## Importing Conversations

### Supported Platforms

<Tabs>
  <Tab title="Intercom">
    **What's Imported**:

    * Customer conversations
    * Internal notes
    * Tags and attributes
    * Customer data
    * Response times

    **Setup Process**:

    1. Connect via OAuth in Settings > Integrations
    2. Select conversation types to import
    3. Configure sync frequency
    4. Map custom attributes
  </Tab>

  <Tab title="Slack">
    **What's Imported**:

    * Channel conversations
    * Direct messages (with permission)
    * Thread discussions
    * Reactions and mentions

    **Setup Process**:

    1. Install BuildBetter Slack app
    2. Choose channels to monitor
    3. Set privacy preferences
    4. Configure notification settings
  </Tab>

  <Tab title="Zendesk">
    **What's Imported**:

    * Support tickets
    * Customer messages
    * Agent responses
    * Internal comments
    * Ticket metadata

    **Setup Process**:

    1. API key authentication
    2. Select ticket views
    3. Configure field mapping
    4. Set import rules
  </Tab>

  <Tab title="Kustomer">
    **What's Imported**:

    * Customer conversations
    * Timeline events
    * Custom attributes
    * Team assignments

    **Setup Process**:

    1. Connect Kustomer account
    2. Choose conversation types
    3. Map custom fields
    4. Enable real-time sync
  </Tab>
</Tabs>

<Note>
  Conversations are imported with full context, including participant information, timestamps, and platform-specific metadata.
</Note>

## Viewing Conversations

### Conversations List

Navigate to the Conversations section to see all imported exchanges:

**List Features**:

* Chronological ordering
* Platform filtering
* Participant search
* Quick preview
* Bulk actions

**Conversation Cards Show**:

* Platform indicator
* Participant avatars
* Message preview
* Latest activity
* Signal count

### Conversation Details

Click any conversation to view the full exchange:

<AccordionGroup>
  <Accordion title="Messages Tab" icon="message">
    **Full Thread View**:

    * Complete message history
    * Participant information
    * Timestamps and context
    * Rich media attachments
    * Platform-specific features

    **Message Display**:

    * Chronological order
    * Author attribution
    * Read receipts (where available)
    * Inline reactions
  </Accordion>

  <Accordion title="Signals Tab" icon="sparkles">
    **Extracted Insights**:

    * Customer sentiment
    * Feature requests
    * Issues and complaints
    * Action items
    * Key topics

    **Signal Features**:

    * Link to source message
    * Severity indicators
    * Type classification
    * Export options
  </Accordion>

  <Accordion title="Participants Panel" icon="users">
    **People Information**:

    * Contact details
    * Company association
    * Previous interactions
    * Related conversations

    **Quick Actions**:

    * View person profile
    * See all conversations
    * Add to collection
    * Export data
  </Accordion>
</AccordionGroup>

## Working with Conversation Data

### Filtering and Search

Find specific conversations using powerful filters:

<Steps>
  <Step title="Platform Filter">
    Select specific platforms:

    * Intercom only
    * Slack conversations
    * Support tickets
    * All platforms
  </Step>

  <Step title="Date Range">
    Focus on time periods:

    * Today
    * This week
    * Last 30 days
    * Custom range
  </Step>

  <Step title="Participant Filter">
    Find by people involved:

    * Customer name
    * Team member
    * Company
    * Email domain
  </Step>

  <Step title="Content Search">
    Search message content:

    * Keywords
    * Phrases
    * Signal types
    * Topics
  </Step>
</Steps>

### Signal Extraction

BuildBetter automatically extracts signals from conversations:

**Common Signal Types**:

* 🔴 **Issues**: Problems, bugs, complaints
* 💡 **Feature Requests**: Ideas, suggestions, wishlist
* ❓ **Questions**: Support queries, clarifications
* ✅ **Action Items**: Commitments, follow-ups
* 💰 **Commercial**: Pricing, upgrades, renewals
* 😊 **Sentiment**: Satisfaction, frustration, praise

<Tip>
  Signals from conversations are integrated with meeting signals, providing a complete view of customer feedback across all touchpoints.
</Tip>

### Collections and Organization

Organize conversations for analysis:

**Use Cases**:

* Product feedback collection
* Support issue tracking
* Customer success monitoring
* Feature request aggregation
* Churn risk identification

**Organization Methods**:

1. Create topic-based collections
2. Group by customer segment
3. Organize by time period
4. Filter by signal type

## AI Analysis

### Conversation Insights

The AI assistant can analyze conversations to provide:

**Summary Generation**:

* Thread overview
* Key points discussed
* Action items identified
* Sentiment analysis
* Resolution status

**Pattern Recognition**:

* Common issues
* Trending topics
* Customer pain points
* Feature demand
* Support quality metrics

### Cross-Channel Analysis

Combine conversation data with meetings:

<Check>
  Track customer journey across all touchpoints
</Check>

<Check>
  Identify patterns between support and sales interactions
</Check>

<Check>
  Measure topic consistency across channels
</Check>

<Check>
  Generate comprehensive customer reports
</Check>

## Integration Workflows

### Support Ticket Workflow

<Steps>
  <Step title="Import Tickets">
    Automatically sync support conversations
  </Step>

  <Step title="Extract Signals">
    AI identifies issues and requests
  </Step>

  <Step title="Create Tasks">
    Generate action items in project tools
  </Step>

  <Step title="Track Resolution">
    Monitor follow-through and outcomes
  </Step>
</Steps>

### Product Feedback Loop

1. **Collect**: Import from all communication channels
2. **Analyze**: AI groups similar feedback
3. **Prioritize**: Use signal severity and frequency
4. **Action**: Create product tickets
5. **Communicate**: Update customers on progress

## Best Practices

<Check>
  **Privacy First**: Only import conversations with appropriate permissions
</Check>

<Check>
  **Regular Sync**: Set up automated imports for real-time insights
</Check>

<Check>
  **Tag Consistently**: Use platform tags to enhance signal extraction
</Check>

<Check>
  **Cross-Reference**: Link conversations to related meetings and contacts
</Check>

<Check>
  **Act on Insights**: Create workflows to address identified issues
</Check>

## Use Cases

### Customer Success

* Monitor account health through support interactions
* Identify expansion opportunities in conversations
* Track feature adoption discussions
* Prevent churn with early warning signals

### Product Management

* Aggregate feature requests across channels
* Understand user pain points
* Validate roadmap priorities
* Track feature impact post-launch

### Support Operations

* Measure response quality
* Identify training needs
* Track issue resolution
* Optimize support workflows

### Sales Intelligence

* Understand prospect concerns
* Track competitive mentions
* Identify decision criteria
* Monitor deal progression

## Limitations

<Warning>
  **Current Limitations**:

  * Historical import limits vary by platform
  * Some platforms require API access
  * Real-time sync depends on platform capabilities
  * Message formatting may vary

  **Workarounds**:

  * Use CSV import for unsupported platforms
  * Set up webhook integrations
  * Export data for bulk analysis
  * Use API for custom imports
</Warning>

## Tips for Success

<Tip>
  Start with your highest-volume communication channel to quickly build valuable insights
</Tip>

<Tip>
  Create saved filters for common conversation types like "Feature Requests" or "Bug Reports"
</Tip>

<Tip>
  Use the AI assistant to summarize long conversation threads before meetings
</Tip>

<Tip>
  Set up alerts for high-severity signals from VIP customers
</Tip>

Conversations in BuildBetter transform your support and communication channels into valuable insight streams, ensuring no customer feedback is lost and every interaction contributes to better products and experiences.
