---
title: "How to Configure a Blocked Number Custom Object"
slug: "how-to-configure-a-blocked-number-custom-object"
updated: 2025-03-18T15:25:09Z
published: 2025-03-18T15:25:09Z
canonical: "docs.natterbox.com/how-to-configure-a-blocked-number-custom-object"
---

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

# How to Configure a Blocked Number Custom Object

> [!NOTE]
> This guide is intended for [advanced Salesforce admins](/v1/docs/advanced-salesforce-integration-examples). For Salesforce education, contact Salesforce directly or use trailheads for specific knowledge.

### **Introduction**

This guide details how to create and configure a custom object in Salesforce for efficient management of blocked numbers. Using a dedicated custom object for blocked number querying offers several advantages over managing them in complex rule components:

- **Improved Performance:** Avoids performance bottlenecks and slowdowns, especially when dealing with large block lists, by optimizing database queries.
- **Enhanced Scalability:** Easily manage and expand your blocked number list as needed without impacting system performance.
- **Simplified Maintenance:** Centralized management of blocked numbers makes updates and modifications easier.

### **Step-by-Step Configuration**

**1. Create the Custom Object**

- Navigate to Salesforce Setup.
- Go to **Object Manager**.
- Click **Create** and select **Custom Object**.
- Enter the following:
  - **Label:** Blocked Number
  - **Plural Label:** Blocked Numbers
  - The Object Name will auto-populate.
- In the Description field, enter "This object manages blocked numbers for use in call blocking."
- Click **Save**.

![](https://lh7-qw.googleusercontent.com/docsz/AD_4nXfSqJIYHsV_KNHXmuucoZlOhgx8uM_vB0--hb8cgHRMy95huqYmZizhZoTRNfovFIa6WkPdp9dX0sIKFjtRtLcGK8PRK5YrtdO0h7PRnJG1J7uE7FJrdH7-l7d2cjQHC-P_D9ks?key=LGzGWsrYrz-fmgN7ET8_yzM_)

**2. Add Fields to the Custom Object**

- In the Object Configuration Menu, go to **Fields & Relationships**.
- Click **New**.

![](https://lh7-qw.googleusercontent.com/docsz/AD_4nXdTIPPw1-MTZtT9XhpE03BBFoTVVnwf_Dn1PoLkkkBZy_sq4nfB5hfxc-l2wyyC-WDgIfYH7mlekNBwtBxwkA1XafoZfsxDO5DQed-fqKIOqoojGXTBJOy2JFchfAk5KZF5Q9PQ?key=LGzGWsrYrz-fmgN7ET8_yzM_)
  - **Create the "Active" Field:**
    - Select **Checkbox** as the field type.
    - Click **Next**.
    - **Field Label:** Active
    - **Default Value:** Checked
    - **Description:** Is Contact Blocked (True/False)
    - Uncheck "Add this field to existing custom report types that contain this entity."
    - Click **Next**, **Next**, and then **Save**.

![](https://lh7-qw.googleusercontent.com/docsz/AD_4nXeADgZd-SUnq6Y37WFZbulK8ZEjexF7h5U_wozUKD22HJdU8TIMqji6-LtRzOBVttkbaOtoLi476KV4o24wH04OM09Udjv7usGTNoC9CLwWc7Z_D89NClX89FemqRdAZ4KD0OyOMw?key=LGzGWsrYrz-fmgN7ET8_yzM_)

![](https://lh7-qw.googleusercontent.com/docsz/AD_4nXf-BefMoRNhhpVPfY_0VeZiAxqHbcDdvo47zcCqYnUBff014gOAl5UocILKrxpLhbmwkzsV-3zpoP6e4XTwQiTqTgtrBqgDtipTagw5QQO5mFheYoi37Jhc-Qwu5BGuLNw1EvWFZQ?key=LGzGWsrYrz-fmgN7ET8_yzM_)
  - **Create the "Blocked Number" Field:**
    - Click **New**.
    - Select **Text** as the field type.
    - Click **Next**.
    - **Field Label:** Blocked Number
    - **Length:** 20 (adjust as needed to accommodate phone number formats)
    - **Field Name:** Phone_Number
    - **Description:** The phone number to block.
    - **Help Text:** Enter the phone number in E.164 format (e.g., 442035100500).
    - Click **Next**, **Next**, and then **Save**.

![](https://lh7-qw.googleusercontent.com/docsz/AD_4nXeBoCEKVX_tVb1c-IGyjgEufXJ_HeYa9hkp-UG8ctFTEI0GFLdc8o1KxINQG3QJCyjTYPt-3wkOzouaf8xxpURu2S77tyDAHB_PS9tiBGaliaeEBaZpphfPjjDsLy8h9lSzRF_S?key=LGzGWsrYrz-fmgN7ET8_yzM_)

**3. Create a Tab for the Custom Object**

- Go to Salesforce Setup Home.
- Search for "Tabs" in the Quick Find box.
- Click **Tabs**.
- Click **New**.
- Select "Blocked Number" as the Object.
- Choose a Tab Style (e.g., IP Phone).
- Enter a Description: "Object to handle blocked numbers for Natterbox Policy Routing."
- Click **Next**, **Next**, and then **Save**. (You can also configure tab visibility for specific roles).

![](https://lh7-qw.googleusercontent.com/docsz/AD_4nXffDenJ2Lpwe9sQaDbHvv9CI0i10AxsDI01FYszdtzuOCRwdw1Se_0wcbOQLIvfkGIPQCiSrlFWBoXjyRAnDtbnsbpXbRemozKQCxsm5PnwKgiRgJ1jZ7DuBDYFXDWxLA4cR0a20g?key=LGzGWsrYrz-fmgN7ET8_yzM_)

![](https://lh7-qw.googleusercontent.com/docsz/AD_4nXdJ5yWuqu2zdaYs1FdVbBwQIYH5L4W7QKL74ThVAVGWb2KUgKBH81DKY6xVYsdpQw-8CpPqoUjEFhXP8M-QT5xT1FwXHxtCART0--XvF28sdfKNN_NgoLIsDK-Bjc5A55Fq4f-vcQ?key=LGzGWsrYrz-fmgN7ET8_yzM_)

![](https://lh7-qw.googleusercontent.com/docsz/AD_4nXdAjjbzJu5-HOZeGBoU3ag3OpucvSOhBDcmBV7WpWsQLgqrTVJdI6EXmb0FYPd4PIB6inbCgiztmjtIWANXWvRa8lvm06mJt0aBHKkWAX-RvUXM4EMUGlfroA6IyR_hoJShEDcIqg?key=LGzGWsrYrz-fmgN7ET8_yzM_)

**4. Add Blocked Number Records**

- Use the App Launcher to find and select the "Blocked Numbers" object.
- Click **New**.
- Enter the following:
  - **Blocked Number Name:** A descriptive name (e.g., "John Smith - Cell")
  - **Blocked Number:** The phone number in E.164 format (e.g., 442035100500)
  - **Active:** (Checkbox) - Ensure this is checked to activate the block. (Set Active by default)
- Click **Save**.
- Repeat for all numbers you want to block.

![](https://lh7-qw.googleusercontent.com/docsz/AD_4nXcmR885LfOAHzPEfIFO6YEXtpNGDgPNhovY8bhJBY3r-oye8MDJhAkxMrQyPmruWiH1oLBIdwEzVgtRpLRF7Wh102BKd8eJR-maDaPB8WYyADxis_dRO7DW7N6R52Z_pWn8H_IOcA?key=LGzGWsrYrz-fmgN7ET8_yzM_)

![](https://cdn.document360.io/c81c490c-daaa-4ebd-a3c3-1a2dee8b7617/Images/Documentation/image(264).png)

**5. Configure Call Policy**

- Navigate to the call policy where you want to implement the blocked number check.
- Replace the existing block list rule component with a "Query Object" component.
- Configure the "Query Object" component as follows:

![](https://cdn.document360.io/c81c490c-daaa-4ebd-a3c3-1a2dee8b7617/Images/Documentation/image(265).png)
  - **Object:** Blocked Number
  - **Query Field:** Blocked Number
  - **Query Value:** Use the appropriate macro for the incoming caller's number (e.g., `$(E164CallerNumber)` for inbound calls).
  - **Query Field:** Active Equals True
  - **Fields to Retrieve:** (e.g., Blocked Number Name, Active)
- Click "Test Query" and enter a blocked number to verify the configuration. You should receive the name of the record verifying the configuration is working.

![](https://lh7-qw.googleusercontent.com/docsz/AD_4nXccJpK0plI4kTjnWoD8F_P-DeS1i_ZabK9lj8K8Zn3gPn51UKP6cPJdKrTOgcKqn5r20hoi6TXVJVcfTHaJ8H5BgMEi55ET2iCVQ9zVOu5moA2e07dUbBAtJoR_XONjjwfht0Kccw?key=LGzGWsrYrz-fmgN7ET8_yzM_)

- Configure the call routing:
  - If the query finds a matching active record (number is blocked), route the call to the desired destination (e.g., voicemail, disconnect).
  - If no matching record is found, route the call as normal.

![](https://lh7-qw.googleusercontent.com/docsz/AD_4nXeq4unSnyXr0Nw0wfBJgEi8U1P5zcbAgc-TLv_5CORfkpciHsJAn8pAOFu-6N1grjWW2trlv_cSkIKHBqIddAY5Ljq2p0PO1bPcRHA6sBppFohmeORaFI2wakIXS4-taiSsl3BaJQ?key=LGzGWsrYrz-fmgN7ET8_yzM_)