Segment Integration

Integrate BuildBetter with Segment to seamlessly collect, transform, and route your BuildBetter data to over 300 tools for analytics, marketing, and data warehousing.

Features

  • Unified Data Collection: Send BuildBetter events to all your tools through a single integration
  • User Identification: Map BuildBetter users across your tech stack
  • Custom Event Tracking: Configure which BuildBetter events to track
  • Retroactive Data: Backfill historical BuildBetter data to Segment
  • Compliance Controls: Manage data privacy settings centrally through Segment

Setup Instructions

Prerequisites

  • An active BuildBetter account
  • A Segment account with write key access
  • Admin permissions in BuildBetter

Connecting Segment

  1. Go to Settings → Integrations in your BuildBetter dashboard
  2. Select Segment from the analytics integrations section
  3. Enter your Segment write key
  4. Choose which events to track (or select “All Events”)
  5. Click Connect to activate the integration

Configuring Destinations in Segment

After connecting BuildBetter to Segment:

  1. Log in to your Segment dashboard
  2. Go to Sources and find the BuildBetter source
  3. Add and configure destinations (Google Analytics, Mixpanel, etc.)
  4. Map BuildBetter events to your destination requirements
  5. Enable the destinations to begin receiving data

Usage

Tracked Events

The following events from BuildBetter are tracked in Segment:

Event NameDescription
Call RecordedWhen a call recording is completed
Call Summary CreatedWhen an AI summary is generated
Document GeneratedWhen a document is created from calls
Chat InteractionWhen users interact with the AI chat
User InvitedWhen a new user is invited to the workspace
Signal CreatedWhen a signal is generated from call data
Folder CreatedWhen a new organizational folder is created

Identity Resolution

BuildBetter sends the following user traits to Segment:

  • User ID
  • Email
  • First and Last Name
  • Organization Name
  • Role
  • Signup Date

Custom Properties

You can configure additional custom properties to be sent with each event:

  1. Go to Settings → Integrations → Segment → Properties
  2. Select the events you want to customize
  3. Add custom properties to include with each event
  4. Save your configuration

Troubleshooting

Events Not Appearing in Segment

  • Verify your Segment write key is correct
  • Check that Segment source is not paused
  • Ensure no API call limits have been reached

Data Latency Issues

If there’s a delay in events appearing:

  • Check Segment’s status page for any ongoing issues
  • Verify your network connectivity
  • Confirm destination settings in Segment

Security and Compliance

  • All data sent to Segment is encrypted in transit
  • Consider using Segment’s Privacy Portal for GDPR and CCPA compliance
  • Review which sensitive data is being sent through this integration