Spam labeling — Finn docs

What spam labeling is

Carriers and phone apps decide how an incoming call is shown. A number they think is unwanted may show a spam warning, or the call may be blocked. Either way, fewer people answer.

Labels are applied by carriers and third parties, not by Finn. Finn cannot see a number's label directly. What it can see is the effect on your calls: fewer connects, more calls hung up in the first seconds, more failures. The Health check is built on those signals.

Finn does not register numbers, caller ID names or brands with carriers, and does not file label appeals.

The Health check

Settings → Phone numbers scores every number on its last 7 days of calls. The score runs from 0 to 100, where higher is worse.

Band	Score
Healthy	0–30
Watch	31–60
At risk	61–100
No data	Fewer than 30 calls in the window

The signals:

Signal	What it measures	Why it matters
Connect rate	Answered calls ÷ calls placed	Falls when people stop picking up
Short-call ratio	Answered calls of 5 seconds or less ÷ answered calls	People hanging up as soon as they see or hear the call
Failure rate	No-answer, busy and failed calls ÷ calls placed	Often rises after a carrier starts blocking

Each number gets two scores:

Relative: how it compares with your workspace's own baseline.
Absolute: how it compares with fixed floors.

The relative score also weighs how quickly the number is placing calls compared with your other numbers. The band uses whichever score is worse, and the badge shows which one drove it.

The section above the table shows the same signals across all your numbers, with a health timeline and a count of numbers in each band.

Thresholds

Click Configure thresholds to change the absolute floors. Pick a Regional preset (India, United States, Europe) to start from, then tune each signal:

Setting	Default
Connect rate floor	Warn ≤ 30%, critical ≤ 15%
Short-call ratio	Warn ≥ 10%, critical ≥ 20%
Failure rate	Warn ≥ 50%, critical ≥ 70%
Short-call threshold	5 seconds
Min calls for reliable score	30

These defaults match the India preset. Reset to defaults puts the thresholds back.

Act on a flagged number

Click a number's health badge to open its drawer. It shows the scores, call counts, a degradation timeline and a daily breakdown.

Action	Effect
Pause / Resume	Marks the number as paused. The Deploy dialog warns if you pick it.
Isolate	The number can't be picked for a deployment until you release it. The drawer shows how long ago it was isolated. A typical cooldown is 7 days before you test it again.
Rotate number	Opens the rent flow for a replacement. The old number is released once the new one is live.

Isolating keeps the number, so you can try it again later. Rotating replaces it for good.

Lower the risk

Spread volume and give people a reason to answer:

Use more numbers. Fewer calls per number keeps each one's volume down. See number-pools.
Clean the audience. Remove invalid numbers and people who asked not to be called.
Make the first seconds count. A clear opening that says who is calling and why keeps people on the line, which keeps the short-call ratio down. See agents-welcome.
Don't call the same person too often. Use sequences to space out follow-ups.
Call at sensible local times. Check the deployment's start time and time zone against your contacts. See outbound-campaigns.

Rules on who you may call, when, and with what consent depend on the country. See compliance-regions.

What goes wrong

Symptom	What to check
One number's band moves to At risk	Open its drawer. Isolate it, or rotate it if it doesn't recover.
Every number's connect rate drops together	The cause is probably shared: the audience, the opening line, or the calling times. A new number won't fix it.
A number stays at No data	It has fewer calls in the window than Min calls for reliable score.