🏠Setup Workspace
What is a workspace?
A workspace is an isolated environment for managing a single business or client. Each workspace has its own dedicated tracking numbers, campaigns, call logs, team members, and analytics reports. This separation is essential for agencies that need to keep client data completely private and organized. Think of it like having multiple separate accounts, but managed from one convenient dashboard.
Here are a few quick steps to get your new workspace ready:
1. Set up Twilio for Tracking Calls
Ring Tonic uses Twilio to provision phone numbers and track calls. To get started, create a Twilio account and connect it to your workspace using your Account SID and Auth Token. This lets Ring Tonic search for numbers, purchase tracking lines, and log incoming calls on your behalf.
How to Get Your Twilio Credentials
Step 1: Create a Twilio Account
Fill out the registration form with your information
Verify your email address and phone number
Complete the onboarding process
Important: During Twilio account setup, if asked about your account type or business model, select "Direct" (not ISV/reseller). Since you own the account and the API keys, Twilio considers you a direct customer. 'ISV' is a specific status for software platforms (like Ring Tonic) that resell connectivity. Choosing Direct makes your account verification and SMS registration much simpler!
Step 2: Find Your Account SID and Auth Token
Once you're logged into Twilio:
Navigate to the Twilio Console
You'll see your Account SID and Auth Token displayed under the Account Info section
The Account SID starts with "AC" followed by 32 characters
Click "Show" next to the Auth Token to reveal it

Important: Your Auth Token is sensitive information. Never share it publicly or commit it to version control. Ring Tonic encrypts and stores these credentials securely.
Step 3: Add Credentials to Your Workspace
In Ring Tonic, navigate to your workspace settings
Scroll down to the Twilio Credentials section
Paste your Account SID into the "Account SID" field
Paste your Auth Token into the "Auth Token" field
Click "Save" or "Update Workspace" to save your credentials

Once saved, Ring Tonic will be able to:
Search for available phone numbers in your desired area codes
Purchase tracking numbers on your behalf
Receive and log incoming calls
Provide call recordings and metadata
What's Next? After connecting Twilio, you can start creating campaigns and purchasing tracking numbers.
2. Set up Call Transcription & Sentiment Analysis
Call transcription turns recorded conversations into searchable text, making it easy to find calls, analyze patterns, and spot keywords without replaying full recordings.

Ring Tonic supports Deepgram and AssemblyAI—both offer automatic transcription with speaker identification, but differ in speed, accuracy, and pricing.
Choosing a Transcription Provider
Ring Tonic integrates with two powerful transcription providers. Here's how they compare:
Processing Speed
10x faster than real-time
Standard processing
Accuracy
Excellent
Best-in-class (30% better in noisy environments)
Speaker Diarization
Up to 100,000+ speakers
Up to 50 speakers
Language Support
30+ languages
100+ languages
Best For
High-volume call centers, batch processing
Maximum accuracy, challenging audio conditions
Pricing
~$0.0043/minute
~$0.00065/minute
How to Set Up AssemblyAI
Step 1: Create an AssemblyAI Account
Sign up for a new account
Verify your email address
Complete the onboarding questionnaire
Step 2: Get Your AssemblyAI API Key
After logging in, you'll be taken to the AssemblyAI Dashboard
Your API key is displayed prominently on the dashboard homepage
Click "Copy" to copy your API key to your clipboard
Alternatively, you can access your API key at any time from the API Keys page

Step 3: Add AssemblyAI Credentials to Your Workspace
In Ring Tonic, navigate to your workspace settings
Go to the Transcription tab
Select AssemblyAI as your transcription provider
Paste your API key into the "AssemblyAI API Key" field
Enable "Automatically transcribe call recordings" if you want transcriptions to run after every call
Enable "Enable speaker diarization" to identify different speakers (Agent vs Customer)
Optionally select a language, or leave it on "Auto-detect" for automatic language detection
Click "Save" or "Update Workspace"

How to Set Up Deepgram
Step 1: Create a Deepgram Account
Sign up for a new account
Verify your email address
Complete the onboarding process
Step 2: Get Your Deepgram API Key
Once logged in, navigate to the API Keys page in your Deepgram Console
Click "Create a New API Key"
Give your key a descriptive name (e.g., "Ring Tonic Production")
Set appropriate permissions (at minimum, you'll need "Usage" and "Transcription" permissions)
Click "Create Key" and copy the API key immediately (you won't be able to see it again)

Important: Store your API key securely. Deepgram only shows the key once when you create it. If you lose it, you'll need to generate a new one.
Step 3: Add Deepgram Credentials to Your Workspace
In Ring Tonic, navigate to your workspace settings
Go to the Transcription tab
Select Deepgram as your transcription provider
Paste your API key into the "Deepgram API Key" field
Enable "Automatically transcribe call recordings" if you want transcriptions to run after every call
Enable "Enable speaker diarization" to identify different speakers (Agent vs Customer)
Optionally select a language, or leave it on "Auto-detect" for automatic language detection
Click "Save" or "Update Workspace"

Understanding Transcription Settings
After choosing your provider and entering your API key, you'll need to configure a few important settings:
Automatically Transcribe Call Recordings

When enabled, Ring Tonic will automatically send each call recording to your chosen transcription provider as soon as the call ends. The transcription usually completes within a few minutes, and you'll be able to view the full text conversation in your call log.
If disabled, you'll need to manually trigger transcription for each call you want transcribed.
Recommendation: Keep this enabled. Automatic transcription ensures you never miss capturing important conversation details, and you can always search through past calls by keywords.
Enable Speaker Diarization
Speaker diarization is the process of identifying and labeling different speakers in the conversation.

When enabled, your transcription will show:
Agent: The person who answered or made the call (usually your team member)
Customer: The caller
Speaker C, D, E...: If more than two people participate in the call
Example transcription with speaker diarization:
Agent: Thanks for calling ABC Plumbing, this is Sarah. How can I help you today?
Customer: Hi Sarah, I have a leaking pipe under my kitchen sink and it's getting worse.
Agent: I understand, that sounds urgent. Let me check our schedule for you.Without speaker diarization, the entire conversation would appear as a single block of text, making it harder to follow.
Language Selection
Both Deepgram and AssemblyAI support automatic language detection, which is the default setting. However, if you know your calls will always be in a specific language, selecting it manually can slightly improve accuracy and processing speed.

Ring Tonic supports:
Deepgram: 30+ languages including English, Spanish, French, German, Chinese, Japanese, and more
AssemblyAI: 100+ languages covering most global markets
Set up Google Natural Language API for Sentiment Analysis (Optional)
Sentiment analysis examines the emotional tone of your call transcriptions, helping you identify whether conversations were positive, negative, or neutral. This is incredibly valuable for:
Flagging potentially unhappy customers for follow-up
Identifying calls that might need manager review
Tracking overall customer satisfaction trends
Spotting training opportunities for your team

Ring Tonic uses Google's Natural Language API to analyze sentiment from your transcriptions. The API examines the entire conversation and returns a sentiment score ranging from -1.0 (very negative) to +1.0 (very positive).
How Sentiment Categories Work
Ring Tonic categorizes sentiment into three groups:
Greater than 0.25
Positive
Customer expressed satisfaction, enthusiasm, or approval
-0.25 to 0.25
Neutral
Factual conversation with balanced or mixed emotions
Less than -0.25
Negative
Customer expressed frustration, disappointment, or dissatisfaction
Use Case: Set up alerts for calls with negative sentiment so managers can review them promptly and reach out to unhappy customers before the situation escalates.
Step 1: Create a Google Cloud Account
Sign in with your Google account (or create one if needed)
Accept the terms of service
You may need to set up billing, but Google offers $300 in free credits for new users
Step 2: Create a New Project
In the Google Cloud Console, click the project dropdown at the top of the page
Click "New Project"
Enter a project name (e.g., "Ring Tonic Sentiment Analysis")
Click "Create"
Wait for the project to be created, then select it from the project dropdown

Step 3: Enable the Natural Language API
In the left sidebar, navigate to "APIs & Services" > "Library"
Search for "Cloud Natural Language API"
Click on "Cloud Natural Language API" from the results
Click the "Enable" button
Wait for the API to be enabled (usually takes a few seconds)

Step 4: Create an API Key
Navigate to "APIs & Services" > "Credentials"
Click "Create Credentials" at the top
Select "API key" from the dropdown
Your new API key will be displayed (it starts with "AIza...")
Click "Copy" to copy the key
Optional but recommended: Click "Restrict Key" and add API restrictions to limit the key to only the Natural Language API

Security Best Practice: Restrict your API key to only the Natural Language API to prevent unauthorized use. You can do this by clicking "Restrict Key" after creating it, then under "API restrictions," select "Restrict key" and choose "Cloud Natural Language API."
Step 5: Add Google NLP API Key to Your Workspace
In Ring Tonic, navigate to your workspace settings
Go to the Transcription tab
Scroll down to the "Sentiment Analysis (Optional)" section
Paste your API key into the "Google NLP API Key" field
Enable "Automatically analyze sentiment from transcriptions"
Click "Save" or "Update Workspace"

Once configured, Ring Tonic will automatically analyze sentiment for every transcribed call and display the results in your call log.
Supported Languages for Sentiment Analysis
What's Next? After setting up transcription and sentiment analysis, Ring Tonic will automatically process your call recordings and provide searchable transcripts with sentiment scores. You can view all this data in your call logs and use it to improve customer service, train your team, and qualify leads more effectively.
3. Set up AI Automation with OpenAI
AI automation supercharges your call analytics by automatically extracting insights from every conversation. With OpenAI integration, Ring Tonic can identify important keywords, categorize calls, qualify leads, and even estimate deal values—all without manual review.

This is incredibly powerful for:
Automatically identifying hot leads ready to buy
Spotting keywords that indicate urgency or specific needs
Auto-tagging calls for easy filtering ("Ready to Buy", "Needs Escalation", "Price Shopping")
Estimating potential revenue from each call
Training your team by highlighting what customers care about
Ring Tonic uses OpenAI's GPT models to analyze your call transcriptions and provide actionable intelligence on every conversation.
How to Set Up OpenAI
Step 1: Create an OpenAI Account
Sign up with your email or Google account
Verify your email address
Complete the onboarding process
Step 2: Get Your OpenAI API Key
After logging in, navigate to the API Keys page
Click "Create new secret key"
Give your key a name (e.g., "Ring Tonic Production")
Optionally restrict permissions to only what's needed
Click "Create secret key"
Copy the API key immediately (it starts with "sk-" and you won't be able to see it again)

Important: Store your API key securely. OpenAI only shows the full key once when you create it. If you lose it, you'll need to generate a new one and update Ring Tonic.
Step 3: Add OpenAI API Key to Your Workspace
In Ring Tonic, navigate to your workspace settings
Go to the AI Automation tab
Paste your API key into the "OpenAI API Key" field
Configure your AI automation settings (explained below)
Click "Save" or "Update Workspace"

Automatically Analyze Keywords and Qualify Leads
When enabled, Ring Tonic's AI will analyze every transcribed call to:
Extract Important Keywords - Identifies meaningful words and phrases that indicate customer intent, needs, or concerns
Categorize Each Keyword - Labels keywords by type (sales, scheduling, support, urgent, pricing, escalation, etc.)
Identify the Speaker - Knows whether the Agent or Customer said each keyword
Auto-Tag Calls - Applies tags like "Ready to Buy", "Needs Escalation", "Price Shopping", "Product Inquiry" for easy filtering
Qualify Leads Automatically - Determines if the call represents a qualified lead based on your criteria

Example: How It Works
Imagine a customer calls and says:
"Hi, I need someone to fix my water heater today. It's leaking everywhere and I'm worried about water damage. Can you give me a quote and come out this afternoon?"
The AI would extract keywords like:
"water heater" (category: product, importance: 8, speaker: Customer)
"today" (category: urgent, importance: 9, speaker: Customer)
"leaking" (category: support, importance: 7, speaker: Customer)
"quote" (category: pricing, importance: 9, speaker: Customer)
"this afternoon" (category: scheduling, importance: 10, speaker: Customer)
Auto-tags applied: "Ready to Buy", "Urgent", "Needs Quote"
Lead qualification: QUALIFIED (95% confidence) because the customer requested a quote, showed urgency, and wanted to schedule service.

Recommendation: Enable this feature. It saves hours of manual call review and ensures no qualified leads slip through the cracks. The AI is remarkably accurate at identifying buying intent.
Custom Qualification Criteria (Optional)
Every business defines "qualified leads" differently. Ring Tonic provides sensible defaults, but you can customize the qualification criteria to match your specific business needs.
Default Qualification Criteria
Out of the box, Ring Tonic considers a call qualified if the customer:
Requests a quote or pricing information
Wants to schedule an appointment within 2 weeks
Has an urgent problem that needs immediate attention
Mentions they are ready to move forward with the service

Customizing for Your Business
You can override the default criteria with your own business-specific guidelines. For example:
For a High-End Law Firm:
A lead is qualified if:
- Case value exceeds $50,000
- Client has immediate legal needs
- Decision-maker is on the call
- Case type matches our practice areas (corporate, real estate, litigation)For a Roofing Company:
A lead is qualified if:
- Customer owns the property (not renters)
- Roof damage is current, not future planning
- Customer requests inspection or estimate
- Property is within our service area
- Customer has decision-making authorityFor a SaaS Business:
A lead is qualified if:
- Company size is 50+ employees
- Customer discusses budget or pricing
- Decision-maker or influencer is on the call
- Timeline is within 3 months
- Specific use case mentioned that matches our productThe AI will incorporate your custom criteria when analyzing calls and determining qualification status.
Confidence Threshold
The confidence threshold determines how certain the AI must be before automatically qualifying a lead. This is a crucial setting that balances quantity versus quality.

How It Works
When the AI analyzes a call, it assigns a qualification confidence score from 0-100:
90-100%: Very confident this is a qualified lead
75-89%: Confident, but some uncertainty
60-74%: Moderate confidence
Below 60%: Low confidence
Your workspace confidence threshold (default: 80%) acts as a filter. Only calls meeting or exceeding this threshold will be automatically marked as qualified.
Choosing Your Threshold
50-65%
More leads auto-qualified, lower accuracy
High-volume businesses that manually review all leads anyway
70-80%
Balanced approach, good accuracy
Most businesses (recommended)
85-100%
Only very obvious qualified leads, highest accuracy
Businesses with limited sales resources, want to focus only on hot leads
Example Scenario
With an 80% threshold:
Call A: 95% confidence → Auto-qualified ✅
Call B: 82% confidence → Auto-qualified ✅
Call C: 75% confidence → Not auto-qualified (you can manually review) ❌
Call D: 60% confidence → Not auto-qualified ❌
Recommendation: Start with 80% (the default) and adjust based on your results. If you find the AI is missing qualified leads, lower it to 70-75%. If you're getting too many false positives, raise it to 85-90%.
Automatically Estimate Deal Value
Deal value estimation helps you prioritize leads based on potential revenue. When enabled, Ring Tonic's AI analyzes customer conversations and automatically estimates the potential deal value using your Products & Services pricing catalog.

How It Works
When a customer mentions specific products or services during a call, the AI:
Matches their needs to items in your catalog
Considers context (urgency, scope, complexity)
Estimates a deal value within your pricing ranges
Displays the estimate in your call log
Example: A customer calls about a broken water heater needing same-day replacement. The AI identifies "Water Heater Replacement" ($1,200-$3,500) plus "Emergency Service" ($150) from your catalog and estimates the deal at $1,500-$3,650.
Setting Up Deal Value Estimation
To use this feature:
Enable the feature - Toggle "Automatically estimate deal value" in the AI Automation tab
Optionally build your catalog - Add Products & Services with pricing ranges for more accurate estimates
How Deal Values Are Estimated:
With a Products & Services Catalog (Recommended):
AI matches customer needs to your catalog items
Estimates within your defined price ranges
More accurate and consistent estimations
Without a Catalog:
AI can still estimate if customers explicitly mention budgets or prices
Example: "I'm looking to spend around $5,000" → AI estimates $5,000
Less reliable as it depends on customers volunteering pricing information
See the complete Products & Services Guide for detailed instructions on building your catalog for best results.
What's Next? After setting up AI automation, Ring Tonic will automatically analyze every transcribed call, extract keywords, qualify leads, and estimate deal values. You can view all this intelligence in your call logs and use it to prioritize follow-ups, train your team, and close more deals.
4. Configure Currency, Language & Branding, Timezone
Beyond the core integrations, your workspace has a few additional settings that control how Ring Tonic displays information and represents your brand.
Currency
The currency setting determines how money values are displayed throughout Ring Tonic—in call logs, deal value estimates, pricing catalogs, and reports.

What It Affects:
Deal value estimates - Shows amounts in your chosen currency ($1,500 vs €1,500 vs ₫1,500,000)
Products & Services pricing - Your catalog displays in your currency
Reports and exports - All financial data formatted correctly
Language & Region (Locale)
The locale setting controls regional formatting preferences for dates, times, numbers, and currency display. It works together with your currency setting to ensure everything displays correctly for your region.

What It Affects:
Date and time formats - US format (MM/DD/YYYY, 12-hour) vs European (DD/MM/YYYY, 24-hour)
Number formatting - Decimal and thousands separators (1,500.00 vs 1.500,00)
Currency symbol position - Before ($1,500) or after (1.500€)
Day/month names - Language for calendar displays
First day of week - Sunday vs Monday in calendars
Timezone
The timezone setting controls how dates and times are displayed throughout Ring Tonic—in call logs, analytics, date ranges, and reports. Choose the timezone where your business operates for accurate reporting aligned with your business hours.
Default: UTC

You're All Set! After configuring these basic settings along with your Twilio, transcription, and AI integrations, your workspace is fully configured and ready to track calls, analyze conversations, and generate valuable insights.
Last updated