> ## Documentation Index
> Fetch the complete documentation index at: https://help.yournewdoor.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Phone and calls

> RingCentral call history, recordings and the in-app phone.

Field Ops connects to the RingCentral phone system for call history, recordings and an in-app phone.

> [!NOTE]
>
> If RingCentral isn't connected yet, you'll see plain empty states (for example the phone system "isn't connected yet") instead of errors.

## Call history

The **Calls** desk (`/desk/calls`) lists calls, inbound and outbound. Calls also show on the customer page, the booking and the job.

* Columns include the caller, **Called number**, the result, and length.
* Missed or unanswered calls show an empty length.
* Outbound calls to a number that doesn't match a customer show the caller as **Unknown**.
* Call rows have a little more space at the top so the caller phone isn't tight against the border.

### Source and campaign

For inbound calls, the **Source · campaign** column shows where the call came from.

| What you see | What it means |
| - | - |
| A source, with the campaign in gray (for example **Google Ads · Fall door replacement**) | Field Ops knows the marketing source for the number the customer dialed. The dialed number shows in **Called number**. |
| **Source unknown · Dialed (214) 785-0960** | Field Ops doesn't know the source, but it has the number the customer dialed, so it shows that number. Use it to work out which ad or listing the call came from. |
| **Source unknown** | Field Ops doesn't know the source and has no dialed number for the call. It never guesses a number. |

Outbound calls leave this column blank, and the number you called shows in **Called number**.

### Date range

Pick a date range with the same date picker used in [Reporting](https://help.yournewdoor.com/guides/reporting.md#dates-and-compare) (for example **Last 30 days**, quarter to date, **All time**, or a custom range). Calls no longer uses the old **All time** / **Last 7 days** / **Last 30 days** cycle chip. The Calls picker does not show **Compare vs previous**; that stays on Reporting.

### Search

Use the search box on **Calls** to find calls across the **whole selected date range**, not only the page currently loaded. Search matches:

* Phone number (any format)
* Contact name
* Called number
* Source and campaign
* Time and length
* AI summary and transcript

### Number, Source and Contact filters

The **Number**, **Source** and **Contact** dropdowns on **Calls** also look across the **whole selected date range**, not only the calls already loaded on screen. So a number, source or contact that only shows up later in the range now appears when you pick it.

* The filters combine with search and the date picker. Picking **All** or **Any** adds no filter.
* Each dropdown lists the numbers, sources and contacts that exist in your selected date range, search and role scope (the other dropdowns don't narrow these lists).
* Your choices stay in the page address, so you can reload or share the link and land on the same filtered view.
* A very wide range such as **All time** can take a moment longer to load the dropdown choices.

Everyone who can open **Calls** gets the same search, filter and date controls. Your role still limits which calls you see (for example, a door expert's outbound calls stay limited to their own extension).

## Listen to recordings

Recordings play inside Field Ops for people allowed to listen: admins, the Owner, managers and executives. CSRs can only play recordings of **inbound** calls they were on, plus stored [ServiceTitan call recordings](#servicetitan-call-recordings). Installers and techs never see call recordings. The same people see the **AI summary** text; others don't get the summary or the audio.

> [!TIP]
>
> Stored recordings play from Field Ops itself.

### On the Calls desk

Every call card on **Calls** (desktop and mobile) shows the same recording block plus an **AI summary** box. There is no separate link or new tab: play, pause, seek and speed stay on the card.

| What you see | What it means |
| - | - |
| Inline player (play / pause / seek / speed) | The recording is ready. A saved RingCentral file is labeled **Phone system recording**; an in-app capture is labeled **In-app recording**; a copy brought over from ServiceTitan is labeled **ServiceTitan recording**. |
| **Recording processing, check back in a few minutes** (muted gray, no Try again) | RingCentral says a recording is ready, but Field Ops does not have the audio file in storage yet (still pending, processing, or rate-limited). This is not a failure. Check back in a few minutes. |
| **Couldn't load this recording. Try again.** (red) | The file is already stored but Field Ops could not open it (for example a bad or truncated file), or saving it failed after several tries. Press **Try again**. Valid stored recordings should play. |
| **No recording** | This call wasn't recorded. |

Under the player, the **AI summary** box shows:

| What you see | What it means |
| - | - |
| Written summary | Field Ops finished processing the recording. |
| **Summary will appear after the recording processes** | Same neutral processing state as the player: the audio is not stored yet, so the summary waits. |
| **Summary pending. It will appear after the recording is processed.** | The audio is in, and the summary is still running. |
| **Summary pending retry.** | Summarizing failed once; Field Ops will try again. |
| **AI summary unavailable.** | Field Ops couldn't produce a summary for this recording. |
| **No recording** | Same as above: there was nothing to summarize. |

The summary never blocks playback. If summarizing fails, you can still listen when the recording is ready. Only people allowed to listen see processing or error states; others still do not see that a recording exists.

#### Transcript

Once Field Ops has the recording stored it writes the summary and a transcript automatically after the call. When a transcript exists, a **Transcript** line appears under the written summary. Click it to expand the full text (it scrolls if the call was long) and click again to collapse it. If there's no transcript yet, the line doesn't show.

* The summary and transcript show the same way on the **Calls** desk and in the customer flyout.
* If a live transcript was already saved for the call, Field Ops keeps it and only fills in the summary.
* Calls recorded in the app get a summary and transcript too, even when the RingCentral recording sync is turned off, so they aren't left stuck on pending.

#### Calls and open opportunities

When a call matches a customer, Field Ops links that call to the customer's newest open opportunity behind the scenes, so the call and its summary can be pulled up with that opportunity later. There's nothing new to click for this yet; an opportunity summary panel that shows these calls is coming in a later update.

### On the customer, booking and job

You can also play a recording from:

* The **Calls** card on the customer page. It lists up to the 50 most recent calls with that customer, each with a **Play recording** button when a recording is ready.
* The **Calls** section on the booking and the job.

Press **Play recording** to listen right on the page, and drag the bar to skip ahead.

| What you see | What it means |
| - | - |
| **Play recording** | The recording is ready. |
| **Recording is processing. Check back in a few minutes.** | RingCentral hasn't finished the recording yet, or Field Ops is still fetching it. It keeps checking, and the button appears once it's ready. |
| **Recording expired. Recordings are kept for 90 days.** | The recording is past RingCentral's 90-day window. |
| No recording control | The call wasn't recorded (for example, a missed call). |

> [!NOTE]
>
> Field Ops goes back and fetches recordings for older calls that were stuck on "processing," a batch at a time. If a call you expected to have a recording still says processing, give it a little while and check again.

### ServiceTitan call recordings

Past calls from ServiceTitan can play in Field Ops once a copy of the audio has been saved in Field Ops. They show up like any other call: on the **Calls** card on the customer page, in the **Calls** section on the job (and booking), and on the **Calls** desk.

* **Label:** the player is labeled **ServiceTitan recording**.
* **Who can listen:** the same people who can listen to other recordings (admins, the Owner, managers and executives), plus **CSRs**. A CSR doesn't need a RingCentral extension or to have been on the call to play a stored ServiceTitan recording. Other office roles still can't play it, and installers and techs never see call recordings.
* **Doesn't expire:** because the copy lives in Field Ops, a stored ServiceTitan recording never shows **Recording expired**, even after ServiceTitan's own 90-day link runs out. RingCentral recordings still follow the 90-day rule.
* **Only once it's stored:** a ServiceTitan call plays only after its audio file is saved in Field Ops. Until then there's nothing to play.
* **Which recording plays:** if the same call also has an in-app or phone system recording, that one plays first. The ServiceTitan copy plays only when neither of the others is stored.
* **No automatic AI summary or transcript:** Field Ops doesn't auto-summarize or transcribe ServiceTitan recordings, so the **AI summary** box stays hidden for them unless a summary already exists.

Each ServiceTitan call row can also show:

| What you see | What it means |
| - | - |
| An agent name (small gray text) | The ServiceTitan agent who handled the call. |
| **ST job #…** | The ServiceTitan job the call belongs to. It shows only when the call isn't already tied to a Field Ops job. |
| **View in ServiceTitan** | Opens that job in ServiceTitan in a new tab. |

Call times show in [your profile timezone](https://help.yournewdoor.com/guides/your-profile.md#set-your-timezone), like everywhere else in Field Ops.

## In-app phone

> [!NOTE]
>
> The in-app phone is on for office roles. Each person signs in to RingCentral in the phone bar.

The RingCentral phone sits at the bottom of the screen. Minimize or expand it; Field Ops remembers your choice per screen size. On desktop it starts minimized on your first visit.

## Linking staff to RingCentral

Admins link each user to their RingCentral extension under **Settings → Company → Users**. In **Add user**, the picker lists all RingCentral extensions (search by name, extension or direct number).

> [!WARNING]
>
> If you see **"RingCentral app needs ReadAccounts to list all extensions."**, the RingCentral app needs one more permission before the full list appears. Until then, only your own extension shows.

## Numbers

The **Numbers** desk lists the company's phone numbers. If something fails you'll see **"Couldn't confirm number. Try again."** or **"Couldn't save changes. Try again."**


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.