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

# Boss Mode

> What Boss Mode is, how phone validation scores every mobile number on a list, and how the dialer uses those scores to reach more people.

Boss Mode is the dialer's phone validation layer. Before you dial a list, it checks every mobile
number against live carrier data and tells you which ones are real, which carrier they belong to,
and how likely each one is to be answered. With Boss Mode on, the dialer skips the numbers that
will not pick up and dials the best number for each person first.

<Note>
  Boss Mode is enabled per team. If you do not see the Boss Mode button above your contact list,
  ask your account manager to turn it on.
</Note>

## How it works

<Steps>
  <Step title="Start a cleanup">
    Open a contact list in the dialer and click **Boss mode**. The first time on a list, a dialog
    explains what is about to happen and offers **Start Cleanup**. That creates a validation
    request for the list.
  </Step>

  <Step title="Every mobile number is validated">
    Salesfinity collects each phone number on the list that is typed as mobile and checks it
    against carrier records. Numbers already validated in the last six months are reused
    instantly, so a list that shares numbers with an earlier cleanup finishes faster. The rest
    are checked in the background, and a progress panel shows how many contacts are done.
  </Step>

  <Step title="Each number gets a result">
    For every number, Salesfinity stores whether it is valid, its carrier, its line type, and, for
    US numbers, a likely-to-answer score. See [what the scores mean](#what-the-scores-mean).
  </Step>

  <Step title="Boss Mode switches on">
    When validation finishes, the list is marked validated and the Boss Mode toggle turns on.
    Subsequent visits to the list toggle Boss Mode on and off without re-validating.
  </Step>
</Steps>

Only one cleanup runs per user at a time. Starting a second one while the first is in progress is
rejected. A request that has not finished after ten minutes is no longer considered active, so a
stuck request will not block you.

## What the scores mean

Every US mobile number receives a likely-to-answer grade from its activity score. Line type comes
from the carrier, so a number saved as mobile that turns out to be a landline or VoIP line is
graded on the stricter non-mobile bands.

| Grade    | Label in the dialer             | Mobile lines               | Other line types   |
| -------- | ------------------------------- | -------------------------- | ------------------ |
| P1       | Highest likely-to-answer        | Activity score 90 or above | Score above 79     |
| P2       | Medium likely-to-answer         | Score 61 to 89             | Score 59 to 79     |
| P3       | Lowest likely-to-answer         | Score below 61             | Score below 59     |
| Unscored | Non-mobile or not yet validated | No score available         | No score available |

International numbers are validated for line type, carrier, and whether the number is live, but
do not receive an activity score, so they show as unscored.

Results are cached across Salesfinity for six months. Validating the same number on another list,
or another team, reuses the stored result.

## What changes when Boss Mode is on

* **P3 numbers are skipped.** The dialer removes numbers graded P3 from each contact's dialing
  set, so a rep does not spend a line on a number that is unlikely to answer. A number that the
  dialer has already screened as a live line is kept regardless of grade.
* **Best number first.** Each contact's remaining numbers are ordered P1, then P2, then
  unscored, so the parallel dialer tries the strongest number first.
* **Badges and details.** Every validated number shows a grade badge, and hovering it reveals
  line type, carrier, and status.
* **Filter, sort, and group by grade.** The contact table gains a "Likeliness to pickup" filter
  and lets you sort or group contacts by their best grade.
* **Contact counts reflect it.** The list header and the enrichment dialog count only the
  contacts that still have a dialable number under Boss Mode.
* **Calls are tagged.** Each call logged while Boss Mode is on records that fact, which feeds the
  analytics below.

Turning Boss Mode off restores every number and the original order. Nothing is deleted by
validation; a P3 number is hidden, not removed.

## Boss Mode in analytics

Two views under **Analytics → Connect rate** use validation data:

* **Boss Mode on vs off** compares the connect rate of calls dialed with verified numbers against
  calls dialed with all numbers, so a manager can see what validation is worth on their lists.
* **Validation score** breaks connect rate down by grade, P1 through P3 and unscored.

The AI Companion can pull the same comparison when you ask it about connect rate by Boss Mode.

## Boss Mode and enrichment

Boss Mode grades the numbers you already have. [Contact enrichment](/enrichment/contacts) finds
numbers you do not have. They work well together: run a cleanup first, then enrich the contacts
left without a P1 or P2 number. Numbers returned by enrichment arrive already screened, since
enrichment discards landlines and lowest-grade numbers before adding a number to a contact.

## Related

<CardGroup cols={2}>
  <Card title="Enrich contacts" icon="phone" href="/enrichment/contacts">
    Find mobile numbers for contacts that have a LinkedIn profile.
  </Card>

  <Card title="Connect rate analytics" icon="chart-line" href="/api-reference/endpoint/analytics-overview">
    Read connect rate metrics through the API.
  </Card>
</CardGroup>
