Overview
The Aircall integration enables you to:- Import call recordings and transcripts from Aircall
- Analyze customer support and sales calls
- Track call trends and patterns
- Extract insights from phone conversations
- Maintain automatic sync of new calls
Features
- Call Recording Import: Import phone call recordings with audio
- Transcript Support: Import full transcripts with speaker identification
- Participant Tracking: Identify internal agents and external callers
- Call Metadata: Duration, direction, status, and timestamps
- Automatic Sync: New calls are automatically imported every 6 hours
- Date Range Filtering: Control which calls to import by date
Setup Guide
Prerequisites
-
Aircall Requirements:
- Active Aircall account
- API access enabled
- API ID and API Token from Aircall settings
- Call recording enabled in Aircall
-
BuildBetter Requirements:
- Active BuildBetter account
- Admin privileges for integration setup
Quick Setup
-
Get Aircall API Credentials
- Log in to your Aircall dashboard
- Navigate to Settings > Integrations > API
- Copy your API ID
- Generate and copy an API Token
- Keep these credentials secure
-
Connect in BuildBetter
- Go to Settings > Integrations in BuildBetter
- Select “Aircall” from recording import integrations
- Enter your Aircall API ID
- Enter your Aircall API Token
- Click “Connect”
-
Configure Import Settings
- Set date range for initial import
- Review import configuration
- Save settings
-
Start Import
- Click “Import” to begin importing calls
- Monitor import progress in the dashboard
- BuildBetter will automatically check for new calls every 6 hours
Imported Data
When calls are imported from Aircall, the following data is preserved:Call Metadata
- Call ID: Unique identifier from Aircall
- Direction: Inbound or outbound
- Status: Initial, answered, or done
- Timestamps: Started at, answered at, ended at
- Duration: Call duration in seconds
- Phone Numbers: Caller and agent phone numbers
Call Recordings
- Audio URL: Call recording audio file
- Recording Type: Full call recordings
- Download: Audio files downloaded and stored
Transcripts
- Full Transcript: Complete word-level transcription
- Speaker Identification: Internal (agents) vs external (callers)
- Timestamps: Word-level timing information
- Language: Detected language for each call
Participants
- Internal Agents: User IDs, names, and availability status
- External Callers: Phone numbers and contact information
- Speaker Mapping: Each speaker identified in transcript
Contact Information
- Contact Name: Caller name (when available)
- Phone Number: Caller phone number
- Email: Contact email (when available)
Import Requirements
Important: Aircall calls must have either a recording or a transcript available to be imported. Calls with neither will be skipped.- With Recording: Calls with audio recordings are always imported
- With Transcript: Calls with transcripts (even without recordings) are imported
- Without Either: Calls lacking both recording and transcript are skipped
Transcript Access
Transcripts require specific Aircall plan features:- 403 Error: Your Aircall plan doesn’t include transcript access
- 404 Error: No transcript available for this call
- Graceful Handling: Calls without transcripts can still be imported if they have recordings
Call Types Supported
- Inbound Calls: Incoming customer calls
- Outbound Calls: Outgoing calls to customers
- Answered Calls: Successfully connected calls
- Completed Calls: Calls that reached done status
Usage
Viewing Imported Calls
- Navigate to the Calls section in BuildBetter
- Calls imported from Aircall will show “Aircall” as the source
- Filter by source to view only Aircall calls
- Access all standard BuildBetter features:
- Listen to recordings
- Read transcripts
- Extract signals
- Generate documents
Analysis Features
Once imported, Aircall calls are analyzed by BuildBetter:- Signal Extraction: Detect customer issues, feature requests, and sentiment
- Search: Search keywords across call transcripts
- AI Summaries: Generate summaries of support calls
- Trend Analysis: Identify patterns across calls
- Agent Performance: Analyze agent interactions
- Call Categorization: Organize calls by topic or issue type
Automatic Updates
After initial setup, BuildBetter automatically:- Checks for new Aircall calls every 6 hours
- Imports new answered and completed calls
- Processes recordings and transcripts
- Updates your call library
Use Cases
Customer Support
- Analyze support call quality and resolution
- Identify common customer issues
- Track support agent performance
- Generate coaching materials from calls
Sales Calls
- Review outbound sales call effectiveness
- Identify successful talk tracks
- Track objection handling
- Analyze call outcomes
Quality Assurance
- Monitor call quality and compliance
- Review agent adherence to scripts
- Identify training opportunities
- Track customer satisfaction indicators
Product Insights
- Extract feature requests from support calls
- Identify product issues and bugs
- Understand customer pain points
- Inform product development priorities
Limitations
- One-Way Import Only: Calls are imported from Aircall to BuildBetter. No data flows back to Aircall.
- Recording or Transcript Required: Calls must have either a recording or transcript to be imported.
- Basic Filtering: Only date range filtering is currently supported.
- No Real-Time Sync: Calls sync every 6 hours, not in real-time.
- Transcript Access: Requires appropriate Aircall plan for transcript features.
- Metadata Not Captured: Tags, comments, and team associations are not imported.
- Voicemail: Voicemail URLs are available but not actively used.
Troubleshooting
Connection Issues
- Verify your Aircall API ID and API Token are correct
- Ensure API access is enabled in your Aircall account
- Check that you have admin permissions
- Confirm credentials haven’t been revoked
No Calls Being Imported
- Check your date range settings
- Verify calls exist in Aircall for the specified period
- Ensure calls have recordings or transcripts available
- Confirm calls have status “answered” or “done”
- Check that call recording is enabled in Aircall
Missing Transcripts
- Verify your Aircall plan includes transcript access
- Check if transcription is enabled for your calls
- Some calls may not have transcripts available
- Calls can still be imported with recordings only
Import Errors
- Verify sufficient storage space in BuildBetter
- Check network connectivity
- Ensure Aircall API is accessible
- Review error messages in import logs
- Contact support if errors persist
API Details
Base URL:https://api.aircall.io/v1
Authentication: HTTP Basic Authentication
- Username: API ID
- Password: API Token
Security & Compliance
- Basic Authentication with encrypted credentials
- Secure API communication over HTTPS
- Encrypted credential storage
- SOC 2 compliant infrastructure
- GDPR compliant data handling
- Audio files securely stored and transmitted
Support
Need help? Contact us:- Email: support@buildbetter.app
- Visit our Help Center
- Schedule a setup call