---
sidebar_position: 4
title: Contacts & Audio Files
description: Organize customer profiles across shared and team Address Books, enable caller screen-pop, and upload studio audio prompts for IVR call flows.
---

# Contacts & Audio Files

Centralize customer caller identity across your workspace with **Contacts & Address Books**, and manage studio-recorded greetings, announcements, and queue hold music in **Audio Files**.

---

## Contacts & Address Books

Whenever an inbound call or SMS arrives—or an agent searches the directory before placing an outbound call—Firetell normalizes the phone number to E.164 format and matches it against your workspace **Contacts** in real time.

### 1. Organizing Address Books & Access Scope

Every contact belongs to an **Address Book**. Click **Address Books** in the top-right corner of **Console → Call Center → Contacts** to create and structure directories by visibility scope:

| Address Book Scope | Who Can Access It | Typical Use Cases |
| :--- | :--- | :--- |
| **Workspace-Wide** | All agents, supervisors, Call Flows, and Voice AI Agents in the workspace. | Master customer directory, vendor hotlines, and shared VIP lookup lists. |
| **Team Directory** | Members assigned to a specific [Agent Team](/use-guides/getting-started/extensions-and-teams) (e.g., `Enterprise Sales` or `Billing`). | Department-specific leads, regional client portfolios, or partner escalations. |
| **Personal Agent Book** | Private to an individual agent account. | Dedicated account manager contact lists and personal follow-up callbacks. |

Mark your primary directory as the **Default Address Book** so newly created contacts (via Agent Portal or API) land in the right repository automatically.

### 2. Contact Profile Fields & Multi-Number Normalization

Click **New Contact** to create a rich customer record containing:
- **Identity & Organization**: `First Name`, `Last Name`, `Company`, and `Job Title`.
- **Multiple Phone Numbers**: Add `mobile`, `work`, `home`, `fax`, or `other` numbers and designate a `Primary` number. Firetell indexes normalized E.164 digits automatically so `+1 (415) 555-0199` and `14155550199` resolve to the same customer profile.
- **Multiple Emails**: Store `work`, `personal`, or `other` email addresses.
- **Segmentation & Context**: Attach searchable **Tags** (e.g., `vip`, `enterprise`, `renewal-q4`), free-form agent **Notes**, customer `Timezone`, preferred `Language`, `Assigned Agent`, and custom key-value CRM metadata.

### 3. How Contacts Power Live Calls & Voice AI

- **Agent Workspace Screen-Pop**: Displays the caller's full name, company, tags, and notes before the agent answers an inbound ring.
- **Voice AI Personalization**: Automatically populates the `{{caller_name}}` runtime variable in [Autonomous Voice AI Agents](/use-guides/voice-ai-and-sms/voice-ai-agents) so AI receptionists greet returning customers by name.
- **Unified Call & SMS History**: Links historical [Call Logs (CDRs)](/use-guides/call-center/call-logs-and-transcriptions#call-logs-cdrs) and [Two-Way SMS threads](/use-guides/voice-ai-and-sms/sms-messaging) to the customer's record.
- **CRM Synchronization**: Sync records two-way via the [Contacts REST API](/developers/rest-api/agent-api/contacts), [Address Books REST API](/developers/rest-api/agent-api/address-books), and real-time `contact.created` / `contact.updated` / `contact.deleted` webhooks.

---

## Audio Files & IVR Prompts

Audio assets uploaded under **Console → Call Center → Audio Files** provide custom voice greetings, holiday/after-hours announcements, ringback tones, and queue hold music across your [Visual Call Flow Builder (IVR)](/use-guides/call-center/call-flow-builder).

### 1. Uploading & Managing Studio Prompts

1. Navigate to **Console → Call Center → Audio Files** and click **Upload Audio**.
2. Enter a clear, searchable **Title** using a consistent naming convention—for example:
   - `IVR_Main_Welcome_EN`
   - `IVR_AfterHours_Closed_VI`
   - `Queue_HoldMusic_AcousticLoop`
3. Upload your audio file. Firetell automatically processes telephony-ready sample rates (`8 kHz` G.711 for PSTN/SIP carrier compatibility alongside wideband streams) and displays file duration and storage size in the table.
4. Click the inline **Play** preview button on any row to verify audio clarity and volume before binding the file to a live Call Flow node.

### 2. Recommended Recording & Mastering Specifications

Phone networks compress dynamic range much more aggressively than desktop speakers. Follow these studio targets so your IVR prompts sound crisp on mobile phones, landlines, and WebRTC softphones alike:

| Audio Property | Recommended Target | Why It Matters |
| :--- | :--- | :--- |
| **Container / Format** | Uncompressed `.wav` (`16-bit PCM`) or high-bitrate `.mp3` (`192+ kbps`) | Uploading lossless `.wav` prevents generation loss when transcoded to telephony codecs (`PCMU`/`PCMA`/`Opus`). |
| **Sample Rate** | `16 kHz` or `44.1/48 kHz` source (auto-resampled to `8 kHz` for PSTN legs) | Preserves wideband clarity on WebRTC/SIP calls while downsampling cleanly for traditional PSTN carriers. |
| **Channel Layout** | **Mono** (`1 channel`) | All telephony call legs are mono. Downmix stereo tracks to mono beforehand to avoid phase cancellation when left/right channels sum together. |
| **Integrated Loudness** | `-16 LUFS` (Voice) / `-20 LUFS` (Hold Music) with `-1.5 dBTP` true peak | Prevents harsh clipping on mobile earpieces and avoids jarring volume jumps when transitioning from hold music to a live agent's voice. |
| **Background Music Under Speech** | Avoid—or duck at least `-18 dB` below voiceover | Telephony codecs (`G.711`) prioritize speech frequencies (`300 Hz–3.4 kHz`); loud background music muddies spoken menu options (`Press 1, Press 2`). |

:::tip[Updating Live Call Flow Prompts]
Before deleting an audio file in **Console → Call Center → Audio Files**, verify that no active **Play Audio** or **Queue Hold Music** node in your published [Call Flows](/use-guides/call-center/call-flow-builder) still references that asset. For automated campaign announcements, see the **[Audios REST API](/developers/rest-api/workspace-api/audios)**.
:::
