> For the complete documentation index, see [llms.txt](https://help.ringtonic.app/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.ringtonic.app/guides/spam-screening.md).

# Spam Screening

Spam screening checks the caller behind every short call. When the caller uses an internet phone number (VoIP) or a carrier you list, Ring Tonic marks the call as **Suspected Spam**. It then sends no email or webhook for that call or its recording, and hides it in Call Activity.

{% embed url="<https://www.youtube.com/watch?v=4x7fXMtLuws>" %}
Set up Spam Screening in one minute
{% endembed %}

{% hint style="info" %}
**Before you start:** you need a Telnyx account (its API key) or a Twilio account connected to the workspace. Each lookup is billed by that provider to your own account; Ring Tonic adds no charge. Only US and Canadian (+1) callers are looked up.
{% endhint %}

***

## How It Works

1. A call ends that is no longer than your limit (60 seconds by default).
2. Ring Tonic looks up the caller's line type and carrier with Telnyx or Twilio. The answer is saved for 30 days, so a caller who calls again within that time costs nothing.
3. **The caller matches a rule:** the call becomes **Suspected Spam**. No email or webhook is sent for its outcome (completed or missed) or its recording, and its recording is not transcribed automatically.
4. **The caller doesn't match:** the emails and webhooks go out as usual, a few seconds later than they would without screening.

Some calls are never flagged:

* Calls longer than your limit
* Callers who once had a call longer than your limit
* Numbers you marked **Not spam**
* Calls your [AI agent](https://help.ringtonic.app/guides/ai-call-answering.md) already handled: it qualified the caller, booked an appointment or passed the call to a person

{% hint style="info" %}
Incoming-call alerts are sent when a call starts, before screening can run. If a lookup fails, the call is treated as clean and its notifications go out as normal.
{% endhint %}

***

## Setting Up Spam Screening

{% stepper %}
{% step %}
**Open Spam Screening**

Click the workspace name at the top of the sidebar (1), then **Spam screening** (2). Workspace owners and admins can change these settings.

<figure><img src="https://2905537093-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXSbXRgC7knjpaMCHwuKc%2Fuploads%2Fgit-blob-858c2f334e67cdd0b34ea609ff9aadd050dcd50a%2Fspam-screening-open.png?alt=media" alt="The workspace menu open, with Spam screening below SMS settings" width="520"><figcaption><p>Open the workspace menu (1), then Spam screening (2)</p></figcaption></figure>
{% endstep %}

{% step %}
**Turn It On and Choose a Lookup Provider**

Turn on **Screen short calls for spam** (1), then choose where callers are looked up (2).

{% tabs %}
{% tab title="Telnyx Number Lookup" %}

* About **$1.50–$4.00 per 1,000 lookups**. VoIP and landline callers cost the low price; only mobile callers cost more.
* Paste your API key from the Telnyx portal (**Auth > API Keys**). Ring Tonic checks the key with Telnyx when you save, at no charge.
* Works for any workspace, including one without a Twilio account.
  {% endtab %}

{% tab title="Twilio Lookup" %}

* About **$8.00 per 1,000 lookups**.
* Uses the workspace's own Twilio account. There is no key to enter.
* The only option that tells online-only VoIP numbers (Google Voice, TextNow) apart from home and office VoIP lines.
  {% endtab %}
  {% endtabs %}

<figure><img src="https://2905537093-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXSbXRgC7knjpaMCHwuKc%2Fuploads%2Fgit-blob-e8c3b87108286cf4ac12c7749e09e0215e5b2870%2Fspam-screening-lookup.png?alt=media" alt="The Spam Screening page with the on switch and the Telnyx and Twilio lookup options"><figcaption><p>The on switch (1) and the lookup provider (2)</p></figcaption></figure>
{% endstep %}

{% step %}
**Set Your Rules**

Adjust the rules (see [The Rules](#the-rules) below), then click **Save**.

<figure><img src="https://2905537093-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXSbXRgC7knjpaMCHwuKc%2Fuploads%2Fgit-blob-f35e0866cb7f843997a06a66256e4bf69e1d1229%2Fspam-screening-rules.png?alt=media" alt="The Rules section with the seconds limit, line types, carriers and the block option"><figcaption><p>The call length limit (1), line types (2), carriers (3) and automatic blocking (4)</p></figcaption></figure>
{% endstep %}
{% endstepper %}

***

## The Rules

A call is flagged when it is no longer than the limit **and** its caller matches the line type rule **or** one of your carriers.

| Setting                                    | What it does                                                                                                                 |
| ------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------- |
| **Only calls up to (seconds)**             | Longer calls are never screened. Default: 60.                                                                                |
| **Line types that count as spam**          | **Any VoIP number** (default), **Online-only VoIP numbers** (Twilio Lookup only), or **None (carriers only)**.               |
| **Carriers that count as spam**            | Flags a caller whose carrier name contains what you enter, for example *Sinch*. Press Enter after each one.                  |
| **Screen**                                 | **Answered calls**, **Missed calls**, or both. Both are on by default.                                                       |
| **Also block the number for future calls** | Adds a flagged caller to the workspace's [block list](https://help.ringtonic.app/guides/blocked-numbers.md). Off by default. |

{% hint style="warning" %}
**Any VoIP number** also matches many real home and office phones: cable providers and business phone systems use VoIP. Large carriers serve real businesses too. Check your suspected spam regularly when you start, and with Twilio Lookup consider **Online-only VoIP numbers**.
{% endhint %}

***

## Reviewing Suspected Spam

Go to **Analytics > Call Activity**. The call list hides spam calls by default, both suspected spam and calls stopped by your press-1 [Spam Filter](https://help.ringtonic.app/guides/campaigns.md#configure-simple-routing). Use the **Spam** filter to see them:

| Spam filter             | Shows                                        |
| ----------------------- | -------------------------------------------- |
| **Hide spam** (default) | Every call except spam                       |
| **Suspected spam only** | Calls that spam screening flagged            |
| **All spam only**       | Suspected spam and press-1 Spam Filter calls |

The **Carrier** column shows the carrier and line type of every caller that was looked up, flagged or not. Other calls show a dash.

<figure><img src="https://2905537093-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXSbXRgC7knjpaMCHwuKc%2Fuploads%2Fgit-blob-3861d10d4c103bba9b3646c953b493dfa991a473%2Fspam-screening-call-activity.png?alt=media" alt="Call Activity filtered to suspected spam, with Suspected Spam statuses and the Carrier column"><figcaption><p>The Spam filter (1), a Suspected Spam call (2) and its carrier (3)</p></figcaption></figure>

{% hint style="info" %}
The answered and missed rates at the top of Call Activity are shares of your non-spam calls.
{% endhint %}

***

## Marking a Call as Not Spam

{% stepper %}
{% step %}
**Open the Call**

Click a Suspected Spam call. A notice explains why it was flagged: the caller's line type, the call's length, and the status the call had before screening.
{% endstep %}

{% step %}
**Click Not Spam**

Click **Not spam**. Then:

* The call gets its earlier status back, for example **No Answer**.
* The emails and webhooks that were held back, for the call and its recording, are sent now. If you transcribe calls automatically, the recording is transcribed too.
* The number is never screened again in this workspace.
* If spam screening blocked the number, the block is removed. A block you added yourself stays.

<figure><img src="https://2905537093-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FXSbXRgC7knjpaMCHwuKc%2Fuploads%2Fgit-blob-bc4715c978772eff27c4ff8d0182ff85d0b9bc6c%2Fspam-screening-not-spam.png?alt=media" alt="Call details with the Suspected spam notice, the Not spam button and the Carrier"><figcaption><p>Why the call was flagged (1), the Not spam button (2) and the caller's carrier (3)</p></figcaption></figure>
{% endstep %}
{% endstepper %}

***

## Common Questions

<details>

<summary>A real customer was marked as suspected spam. What should I change?</summary>

1. Open the call and click **Not spam**. The customer is never screened again.
2. If it keeps happening, narrow the rules: choose **Online-only VoIP numbers** (Twilio Lookup), or **None (carriers only)** and list only the carriers you see in your spam.

</details>
