# 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.

{% hint style="info" %}
When you create an account, Ring Tonic automatically sets up a default workspace for you.
{% endhint %}

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**

1. Go to <https://www.twilio.com/try-twilio>
2. Fill out the registration form with your information
3. Verify your email address and phone number
4. Complete the onboarding process

{% hint style="info" %}
Twilio offers a free trial with credits to get started. You can test Ring Tonic's features before committing to a paid plan.
{% endhint %}

{% hint style="warning" %}
**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!
{% endhint %}

**Step 2: Find Your Account SID and Auth Token**

Once you're logged into Twilio:

1. Navigate to the [Twilio Console](https://console.twilio.com)
2. You'll see your **Account SID** and **Auth Token** displayed under the Account Info section
3. The Account SID starts with "AC" followed by 32 characters
4. Click "Show" next to the Auth Token to reveal it

<figure><img src="https://2905537093-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXSbXRgC7knjpaMCHwuKc%2Fuploads%2Fgit-blob-5216321598bc193829be9a30a2e7ea8ba6e3af3a%2FXnapper-2025-11-13-19.35.50.png?alt=media" alt=""><figcaption><p>Your Account SID and Auth Token are displayed on the Twilio Console dashboard</p></figcaption></figure>

{% hint style="warning" %}
**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.
{% endhint %}

**Step 3: Add Credentials to Your Workspace**

1. In Ring Tonic, navigate to your workspace settings
2. Scroll down to the **Twilio Credentials** section
3. Paste your **Account SID** into the "Account SID" field
4. Paste your **Auth Token** into the "Auth Token" field
5. Click "Save" or "Update Workspace" to save your credentials

<figure><img src="https://2905537093-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXSbXRgC7knjpaMCHwuKc%2Fuploads%2Fgit-blob-c768115506780ae6cc1762a42274a717ef06ad5b%2FXnapper-2025-11-13-19.36.58.png?alt=media" alt=""><figcaption><p>Enter your Twilio credentials in the workspace settings</p></figcaption></figure>

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

{% hint style="success" %}
**What's Next?** After connecting Twilio, you can start creating campaigns and purchasing tracking numbers.
{% endhint %}

### 2. Call Control — Disable Calls for a Workspace (Agency Plan)

{% hint style="info" %}
This feature is available exclusively on the **Agency plan**. If you're on the Indie plan, you'll see the toggle but will be prompted to upgrade when you try to use it.
{% endhint %}

If you manage multiple workspaces for different clients, there may be times when you need to temporarily disable all calling for a specific workspace—for example, if a client stops paying or requests a pause on their campaigns. The **Call Control** toggle gives you a single master switch to turn off all inbound and outbound calls for a workspace instantly.

When calling is disabled:

* **Inbound calls** to all tracking numbers in the workspace are rejected (callers hear a busy signal or a custom message you define)
* **Outbound dialer** is hidden and blocked for all team members in the workspace
* **No call logs** are created for rejected inbound calls, so your analytics stay clean

#### How to Disable Calls

1. Navigate to your workspace settings
2. Scroll down to the **Call Control** section (below Twilio Credentials)
3. Toggle **"Calling Enabled"** off

<figure><img src="https://2905537093-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXSbXRgC7knjpaMCHwuKc%2Fuploads%2Fja6LjwyYFKEqjQQ8F1R3%2FXnapper-2026-03-12-12.10.00.png?alt=media&#x26;token=f71b6a37-2c84-4c6b-874a-5af0c7ff3ec4" alt=""><figcaption><p>The Call Control toggle in workspace settings</p></figcaption></figure>

#### Choosing a Rejection Method

When you disable calls, you can choose what callers hear when they dial one of your tracking numbers:

| Method             | What Callers Hear                           | Twilio Cost      | Best For                                                                               |
| ------------------ | ------------------------------------------- | ---------------- | -------------------------------------------------------------------------------------- |
| **Busy Signal**    | A standard busy tone, then the call ends    | $0 (no charge)   | Temporary suspensions where you don't want to reveal any details                       |
| **Custom Message** | Your custom message, then the call hangs up | \~$0.01 per call | Professional communication, letting callers know the number is temporarily unavailable |

**To configure the rejection method:**

1. After toggling calls off, select either **"Busy Signal"** or **"Custom Message"**
2. If you chose **Custom Message**, enter your message in the text field (up to 500 characters)
3. Click **"Save"** or **"Update Workspace"**

**Example custom messages:**

* "The number you have called is temporarily unavailable. Please try again later."
* "This line is currently not accepting calls. Please contact us at our main office number."
* "Service for this account has been temporarily suspended. Please contact your account manager."

{% hint style="warning" %}
**Important:** When calls are disabled, ALL inbound calls to every tracking number in the workspace will be rejected, and the outbound dialer will be completely hidden. Make sure this is what you intend before saving.
{% endhint %}

#### Re-enabling Calls

To restore calling, simply toggle **"Calling Enabled"** back on and save. All inbound call tracking and the outbound dialer will resume immediately—no need to reconfigure anything.

#### Per-Number Call Control

Need more granular control? Instead of disabling an entire workspace, you can disable calling for **individual phone numbers**. This is useful when you want to suspend just one line while keeping the rest of the workspace active.

Per-number call control is managed from the **Phone Numbers** page. See the [Phone Numbers guide](https://help.ringtonic.app/phone-numbers#per-number-call-control-agency-plan) for full details.

### 3. 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.

<figure><img src="https://2905537093-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXSbXRgC7knjpaMCHwuKc%2Fuploads%2Fgit-blob-2c54ff6abe962977a0ac1aa40794df2409eccc24%2FXnapper-2025-11-13-19.56.11.png?alt=media" alt=""><figcaption><p>Transcription with AssemblyAI</p></figcaption></figure>

Ring Tonic supports Deepgram and AssemblyAI—both offer automatic transcription with speaker identification, but differ in speed, accuracy, and pricing.

{% hint style="info" %}
**Don't know which provider to choose?** We recommend **AssemblyAI** for most users. It provides the best accuracy with 30% improvement in noisy environments, making it ideal for phone call transcription where audio quality can vary.
{% endhint %}

#### Choosing a Transcription Provider

Ring Tonic integrates with two powerful transcription providers. Here's how they compare:

| Feature                 | Deepgram                                   | AssemblyAI                                       |
| ----------------------- | ------------------------------------------ | ------------------------------------------------ |
| **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                                |

{% tabs %}
{% tab title="AssemblyAI" %}
**How to Set Up AssemblyAI**

**Step 1: Create an AssemblyAI Account**

1. Visit <https://www.assemblyai.com/app/signup>
2. Sign up for a new account
3. Verify your email address
4. Complete the onboarding questionnaire

{% hint style="info" %}
AssemblyAI provides $50 free credits to get started, allowing you to test their transcription quality with your actual call recordings.
{% endhint %}

**Step 2: Get Your AssemblyAI API Key**

1. After logging in, you'll be taken to the AssemblyAI Dashboard
2. Your API key is displayed prominently on the dashboard homepage
3. Click "Copy" to copy your API key to your clipboard
4. Alternatively, you can access your API key at any time from the [API Keys page](https://assemblyai.com/dashboard/api-keys)

<figure><img src="https://2905537093-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXSbXRgC7knjpaMCHwuKc%2Fuploads%2Fgit-blob-14ae336f9da381c6f4ab2f4a5d97050214b265de%2FXnapper-2025-11-13-19.51.06.png?alt=media" alt=""><figcaption><p>Your AssemblyAI API key is shown on the dashboard</p></figcaption></figure>

**Step 3: Add AssemblyAI Credentials to Your Workspace**

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

<figure><img src="https://2905537093-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXSbXRgC7knjpaMCHwuKc%2Fuploads%2Fgit-blob-bdd5473a3bfa28de1aea6f495d463f9f239e2a56%2FXnapper-2025-11-13-19.52.03.png?alt=media" alt=""><figcaption><p>Configure AssemblyAI in your workspace transcription settings</p></figcaption></figure>
{% endtab %}

{% tab title="Deepgram" %}
**How to Set Up Deepgram**

**Step 1: Create a Deepgram Account**

1. Visit <https://console.deepgram.com>
2. Sign up for a new account
3. Verify your email address
4. Complete the onboarding process

{% hint style="info" %}
Deepgram offers $200 in free credits to get started, which is approximately 46,500 minutes of transcription.
{% endhint %}

**Step 2: Get Your Deepgram API Key**

1. Once logged in, navigate to the [API Keys page](https://console.deepgram.com/project/default/settings/api-keys) in your Deepgram Console
2. Click "Create a New API Key"
3. Give your key a descriptive name (e.g., "Ring Tonic Production")
4. Set appropriate permissions (at minimum, you'll need "Usage" and "Transcription" permissions)
5. Click "Create Key" and copy the API key immediately (you won't be able to see it again)

<figure><img src="https://2905537093-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXSbXRgC7knjpaMCHwuKc%2Fuploads%2Fgit-blob-5be33a374cdff71bdc8957b90bba3a1f670f5895%2FXnapper-2025-11-13-19.44.35.png?alt=media" alt=""><figcaption><p>Create a new API key in the Deepgram Console</p></figcaption></figure>

{% hint style="warning" %}
**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.
{% endhint %}

**Step 3: Add Deepgram Credentials to Your Workspace**

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

<figure><img src="https://2905537093-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXSbXRgC7knjpaMCHwuKc%2Fuploads%2Fgit-blob-da3a916a53467725b8be6bd8bd928e12d7b4d029%2FXnapper-2025-11-13-19.46.17.png?alt=media" alt=""><figcaption><p>Configure Deepgram in your workspace transcription settings</p></figcaption></figure>
{% endtab %}
{% endtabs %}

#### 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**

<figure><img src="https://2905537093-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXSbXRgC7knjpaMCHwuKc%2Fuploads%2Fgit-blob-a53fbaa6a2aa503f62ab130d0c0c99e6e264efd3%2FXnapper-2025-11-13-19.53.19.png?alt=media" alt=""><figcaption><p>Automatically Transcribe Call Recordings</p></figcaption></figure>

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.

{% hint style="success" %}
**Recommendation:** Keep this enabled. Automatic transcription ensures you never miss capturing important conversation details, and you can always search through past calls by keywords.
{% endhint %}

**Enable Speaker Diarization**

Speaker diarization is the process of identifying and labeling different speakers in the conversation.

<figure><img src="https://2905537093-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXSbXRgC7knjpaMCHwuKc%2Fuploads%2Fgit-blob-4be5cc421001ace52959c65b3225513551e0c81b%2FXnapper-2025-11-13-19.54.20.png?alt=media" alt=""><figcaption><p>Enable Speaker Diarization</p></figcaption></figure>

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.

{% hint style="info" %}
Speaker diarization adds minimal cost to your transcription and significantly improves readability. We recommend keeping it enabled.
{% endhint %}

**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.

<figure><img src="https://2905537093-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXSbXRgC7knjpaMCHwuKc%2Fuploads%2Fgit-blob-42b498de20bd2642330549ebc09f4105732805f8%2FXnapper-2025-11-13-19.54.58.png?alt=media" alt=""><figcaption></figcaption></figure>

Ring Tonic supports:

* **Deepgram:** 30+ languages including English, Spanish, French, German, Chinese, Japanese, and more
* **AssemblyAI:** 100+ languages covering most global markets

{% hint style="info" %}
Leave the language setting on "Auto-detect" unless you exclusively handle calls in a single language. The auto-detection is highly accurate and adapts to different accents and dialects.
{% endhint %}

#### 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

<figure><img src="https://2905537093-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXSbXRgC7knjpaMCHwuKc%2Fuploads%2Fgit-blob-e5196304754d94aba4e77ad4d786c66c3ea34ec3%2FXnapper-2025-11-13-19.58.12.png?alt=media" alt=""><figcaption></figcaption></figure>

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:

| Sentiment Score   | Category     | Meaning                                                            |
| ----------------- | ------------ | ------------------------------------------------------------------ |
| 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 |

{% hint style="success" %}
**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.
{% endhint %}

**Step 1: Create a Google Cloud Account**

1. Visit <https://console.cloud.google.com>
2. Sign in with your Google account (or create one if needed)
3. Accept the terms of service
4. You may need to set up billing, but Google offers $300 in free credits for new users

**Step 2: Create a New Project**

1. In the Google Cloud Console, click the project dropdown at the top of the page
2. Click "New Project"
3. Enter a project name (e.g., "Ring Tonic Sentiment Analysis")
4. Click "Create"
5. Wait for the project to be created, then select it from the project dropdown

<figure><img src="https://2905537093-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXSbXRgC7knjpaMCHwuKc%2Fuploads%2Fgit-blob-c5b79d47378fe6c4f51da561517836b91b473527%2FXnapper-2025-11-13-19.59.38.png?alt=media" alt=""><figcaption><p>Create a new project in Google Cloud Console</p></figcaption></figure>

**Step 3: Enable the Natural Language API**

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

<figure><img src="https://2905537093-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXSbXRgC7knjpaMCHwuKc%2Fuploads%2Fgit-blob-42fecff3c6ab7ca720c97900fa28d80ebc248168%2FXnapper-2025-11-13-20.01.09.png?alt=media" alt=""><figcaption><p>Enable the Cloud Natural Language API</p></figcaption></figure>

**Step 4: Create an API Key**

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

<figure><img src="https://2905537093-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXSbXRgC7knjpaMCHwuKc%2Fuploads%2Fgit-blob-1f191f44971045f95b40ea79fee233c93d8a550b%2FXnapper-2025-11-13-20.02.54.png?alt=media" alt=""><figcaption><p>Create a new API key for the Natural Language API</p></figcaption></figure>

{% hint style="warning" %}
**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."
{% endhint %}

**Step 5: Add Google NLP API Key to Your Workspace**

1. In Ring Tonic, navigate to your workspace settings
2. Go to the **Transcription** tab
3. Scroll down to the "Sentiment Analysis (Optional)" section
4. Paste your API key into the "Google NLP API Key" field
5. Enable "Automatically analyze sentiment from transcriptions"
6. Click "Save" or "Update Workspace"

<figure><img src="https://2905537093-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXSbXRgC7knjpaMCHwuKc%2Fuploads%2Fgit-blob-c3d503b82ebfe3b78ac4e163d666579e16f7de46%2FXnapper-2025-11-13-20.04.39.png?alt=media" alt=""><figcaption><p>Configure Google NLP for sentiment analysis</p></figcaption></figure>

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**

<details>

<summary>Google's Natural Language API supports sentiment analysis in the following languages:</summary>

1. Arabic (ar)
2. Chinese (Simplified) (zh)
3. Chinese (Traditional) (zh-Hant)
4. Dutch (nl)
5. English (en)
6. French (fr)
7. German (de)
8. Indonesian (id)
9. Italian (it)
10. Japanese (ja)
11. Korean (ko)
12. Portuguese (pt)
13. Spanish (es)
14. Thai (th)
15. Turkish (tr)
16. Vietnamese (vi)

</details>

{% hint style="info" %}
If your transcription is in a language not supported for sentiment analysis, the sentiment will be marked as "Unsupported" in your call log. The transcription will still work normally.
{% endhint %}

{% hint style="success" %}
**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.
{% endhint %}

### 4. 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.

<figure><img src="https://2905537093-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXSbXRgC7knjpaMCHwuKc%2Fuploads%2Fgit-blob-4312d812653be7875b357dcbdc3f94d8e749ad11%2FXnapper-2025-11-13-20.08.01.png?alt=media" alt=""><figcaption><p>Keyword Spotting</p></figcaption></figure>

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.

{% hint style="info" %}
**Important:** AI automation requires transcription to be set up first. Make sure you've completed [Section 3: Transcription](#id-3.-set-up-call-transcription-and-sentiment-analysis) before configuring AI features.
{% endhint %}

#### How to Set Up OpenAI

**Step 1: Create an OpenAI Account**

1. Visit <https://platform.openai.com/signup>
2. Sign up with your email or Google account
3. Verify your email address
4. Complete the onboarding process

**Step 2: Get Your OpenAI API Key**

1. After logging in, navigate to the [API Keys page](https://platform.openai.com/api-keys)
2. Click "Create new secret key"
3. Give your key a name (e.g., "Ring Tonic Production")
4. Optionally restrict permissions to only what's needed
5. Click "Create secret key"
6. Copy the API key immediately (it starts with "sk-" and you won't be able to see it again)

<figure><img src="https://2905537093-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXSbXRgC7knjpaMCHwuKc%2Fuploads%2Fgit-blob-d7c9f5a98523f2264786f0baea20fe73afef374f%2FXnapper-2025-11-13-20.10.23.png?alt=media" alt=""><figcaption><p>Create a new API key in the OpenAI Platform</p></figcaption></figure>

{% hint style="warning" %}
**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.
{% endhint %}

**Step 3: Add OpenAI API Key to Your Workspace**

1. In Ring Tonic, navigate to your workspace settings
2. Go to the **AI Automation** tab
3. Paste your API key into the "OpenAI API Key" field
4. Configure your AI automation settings (explained below)
5. Click "Save" or "Update Workspace"

<figure><img src="https://2905537093-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXSbXRgC7knjpaMCHwuKc%2Fuploads%2Fgit-blob-9496efd3faa57408593e5cbc2c9c970afe4311b2%2FXnapper-2025-11-13-20.13.35.png?alt=media" alt=""><figcaption><p>Configure OpenAI in your workspace AI automation settings</p></figcaption></figure>

#### Automatically Analyze Keywords and Qualify Leads

When enabled, Ring Tonic's AI will analyze every transcribed call to:

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

<figure><img src="https://2905537093-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXSbXRgC7knjpaMCHwuKc%2Fuploads%2Fgit-blob-1a9c900d4762bbbfffcbcdf49840b3f0758ab46f%2FXnapper-2025-11-13-20.08.32.png?alt=media" alt=""><figcaption><p>Auto-tagging and keyword spotting</p></figcaption></figure>

**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.

<figure><img src="https://2905537093-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXSbXRgC7knjpaMCHwuKc%2Fuploads%2Fgit-blob-6e61128efc47a64221af9d0faa25c97e302c4d0e%2FXnapper-2025-11-13-20.15.08.png?alt=media" alt=""><figcaption><p>Auto-qualify Leads</p></figcaption></figure>

{% hint style="success" %}
**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.
{% endhint %}

#### 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:

1. Requests a quote or pricing information
2. Wants to schedule an appointment within 2 weeks
3. Has an urgent problem that needs immediate attention
4. Mentions they are ready to move forward with the service

<figure><img src="https://2905537093-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXSbXRgC7knjpaMCHwuKc%2Fuploads%2Fgit-blob-b3de83ed296f6233d0d4e27098ccee1e09f698aa%2FXnapper-2025-11-13-20.17.33.png?alt=media" alt=""><figcaption><p>Default Qualification Criteria</p></figcaption></figure>

**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 authority
```

**For 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 product
```

The AI will incorporate your custom criteria when analyzing calls and determining qualification status.

{% hint style="info" %}
Don't worry about making it perfect. The AI is smart enough to understand natural language guidelines. Write your criteria as if you're explaining it to a new team member.
{% endhint %}

#### 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.

<figure><img src="https://2905537093-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXSbXRgC7knjpaMCHwuKc%2Fuploads%2Fgit-blob-92c5c1ce8e71bdd500d04a3102338f2a5bf010e7%2FXnapper-2025-11-13-20.18.22.png?alt=media" alt=""><figcaption><p>Confidence threshold field</p></figcaption></figure>

**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**

| Threshold   | Effect                                              | Best For                                                                 |
| ----------- | --------------------------------------------------- | ------------------------------------------------------------------------ |
| **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 ❌

{% hint style="success" %}
**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%.
{% endhint %}

#### 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.

<figure><img src="https://2905537093-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXSbXRgC7knjpaMCHwuKc%2Fuploads%2Fgit-blob-1573cc1fe1629ea683f1a1d342ed74a7e3ccdcac%2FXnapper-2025-11-13-20.19.44.png?alt=media" alt=""><figcaption><p>Automatically Estimate Deal Value field</p></figcaption></figure>

**How It Works**

When a customer mentions specific products or services during a call, the AI:

1. Matches their needs to items in your catalog
2. Considers context (urgency, scope, complexity)
3. Estimates a deal value within your pricing ranges
4. 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:

1. **Enable the feature** - Toggle "Automatically estimate deal value" in the AI Automation tab
2. **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](https://help.ringtonic.app/guides/products-and-services) for detailed instructions on building your catalog for best results.

{% hint style="info" %}
**Recommendation:** Set up your Products & Services catalog for the most accurate deal value estimates. The AI works best when it has your actual pricing data to reference.
{% endhint %}

#### Automatically Detect Caller Name

<figure><img src="https://2905537093-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXSbXRgC7knjpaMCHwuKc%2Fuploads%2FaYYtq9lFE7OwjCXG7Eci%2FXnapper-2026-01-03-17.39.11.png?alt=media&#x26;token=7034713b-0456-467f-84c0-df0ee31e7e36" alt=""><figcaption><p>Automatically Detect Caller Name setting</p></figcaption></figure>

When enabled, the AI extracts caller names from transcriptions when callers introduce themselves (e.g., "Hi, this is John Smith..."). This supplements [CNAM lookup](https://help.ringtonic.app/phone-numbers#toggling-cnam-lookup) from phone carriers. If both are enabled, AI only overrides the CNAM name when detection confidence exceeds 80%.

{% hint style="success" %}
**What's Next?** After setting up AI automation, Ring Tonic will automatically analyze every transcribed call, extract keywords, qualify leads, estimate deal values, and detect caller names. You can view all this intelligence in your call logs and use it to prioritize follow-ups, train your team, and close more deals.
{% endhint %}

### 5. 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.

<figure><img src="https://2905537093-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXSbXRgC7knjpaMCHwuKc%2Fuploads%2Fgit-blob-4e97708b26326d0422685a5de3017d1b912fcf7c%2FXnapper-2025-11-13-20.20.52.png?alt=media" alt=""><figcaption></figcaption></figure>

**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.

<figure><img src="https://2905537093-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXSbXRgC7knjpaMCHwuKc%2Fuploads%2Fgit-blob-5f11ce99ce0fbf08644007a0172fcf27cbb43cce%2FXnapper-2025-11-13-20.21.28.png?alt=media" alt=""><figcaption></figcaption></figure>

**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

{% hint style="info" %}
**Currency + Locale Work Together:** Your currency determines what currency to use (USD, EUR, etc.), while your locale determines how to format it. For example, if you choose USD currency with the de\_DE locale, amounts will show as "1.500,00 $" using German formatting conventions.
{% endhint %}

#### 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

<figure><img src="https://2905537093-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXSbXRgC7knjpaMCHwuKc%2Fuploads%2Fgit-blob-9d722b9f95fe298e3913edf23578eea2d95a050f%2FXnapper-2025-11-16-09.55.16.png?alt=media" alt=""><figcaption></figcaption></figure>

{% hint style="success" %}
**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.
{% endhint %}

{% hint style="info" %}
**Agency Plan Users:** If you're on the Agency plan, you can also [invite team members to collaborate on your workspace](https://help.ringtonic.app/guides/team-management).
{% endhint %}
