Inbound Number Lists

The Number List feature in the DIDWW user panel allows you to manage inbound call filtering by specifying which phone numbers or prefixes should be allowed or rejected. These lists can be linked to inbound SIP and PSTN trunks, ensuring that only approved calls go through while unwanted ones are rejected.

This guide walks you through the process of creating a Number List, adding numbers or prefixes, and configuring rules to either allow or reject calls. You’ll learn how to:

  • Create a Number List and assign it to an inbound SIP or PSTN trunk.

  • Define specific numbers or prefixes to allow or reject calls.

  • Manage Number Lists, including editing and deleting entries.

  • Analyze call rejection error codes to troubleshoot blocked calls and adjust settings.

Pick one of the following options to proceed:

1. Create a Number List

Set up a Number List to allow or reject calls based on full number or prefix matches.

1. Create a Number List
2. Add and Configure Numbers in the Number List

Learn to add numbers, set actions, and define length limits in a Number List.

2. Add and Configure Numbers in the Number List
3. Assign a Number List to a Trunk

Assign a Number List to an Inbound SIP or PSTN Trunk to filter calls by number or prefix.

3. Assign a Number List to a Trunk
Number List Examples & Use Cases

See examples of Number List configurations for allowing or rejecting calls.

Number List Examples & Use Cases


1. Create a Number List

Before you can filter inbound calls, you need to create a Number List. This list will store numbers and prefixes that can later be assigned to a SIP or PSTN trunk for call filtering.

Follow these steps to create a Number List to filter inbound calls.

Step 1: Open the Create Inbound Number List

  1. Go to the Voice menu.

  2. Select Inbound Trunks.

  3. Open the Number Lists tab.

  4. Click Create New to start the setup.

Number Lists Create New Button

Fig. 1. Number Lists Create New Button

Step 2: Configure the Number List

On the Number List creation screen, configure the list based on your requirements:

  1. Enter a Friendly Name (e.g., Blocked Callers).

  2. Select a Mode:

    • Full Number Match: The number(s) must include the exact full source calling number to apply this rule.

    • Prefix Match: The number(s) must include a prefix. This rule applies only if the source number matches your entered prefix(s).

  3. Set the Default Action:

    • Allow call: All calls will be allowed if no matching numbers are found in your number list.

    • Reject call: All calls will be rejected if no matching numbers are found in your number list.

Configure the Number List

Fig. 2. Configure the Number List

Step 3: Create the Number List

Click Create to save your new Number List. It will now appear in the Number Lists section.

Create the Number List

Fig. 3. Create the Number List



2. Add and Configure Numbers in the Number List

After creating a Number List, the next step is to configure it by adding numbers or prefixes, setting actions to allow or reject calls, and, if using prefixes, defining length limits.

Follow these steps to add numbers to an existing Number List.

Step 1: Open the Number List

  1. Go to the Voice menu.

  2. Select Inbound Trunks.

  3. Open the Number Lists tab.

  4. Choose the list where you would like to add or manage numbers and click the Actions button button.

  5. Select Manage Numbers or click Add Numbers.

Open Manage or Add Numbers.

Fig. 4. Open Manage or Add Numbers.

Step 2: Add Numbers to the Number List

On the Manage Numbers page, you can view and modify the list of previously added numbers. You can add new numbers, remove existing ones, or adjust their settings to allow or reject calls based on your needs.

  1. Click Add Numbers from the Manage Numbers page or within the Number List page to open the number entry dialog.

Add Number Button.

Fig. 5. Add Number Button.

  1. When the Add Numbers pop-up appears, enter the Numbers or prefixes to be added to the list.

    • Separate multiple numbers with a comma (e.g., 15551234567, 1234567890).

Comma Separated Numbers

Fig. 6. Comma Separated Numbers

Step 3: Configure Number Actions & Save Changes

A mandatory action must be selected to either allow or reject calls for the added numbers or prefixes.

  1. Select an Action:

    • Allow call: The call will be allowed if the source number matches a number or prefix in your list. This action overrides any rules set in your number list.

    • Reject call: The call will be rejected if the source number matches a number or prefix in your list. This action overrides any rules set in your number list.

  2. (Optional) When using prefixes for routing, adjust the Min. Length and Max. Length fields. These settings define the range of phone numbers the rule applies to:

    • Min. Length: The shortest phone number that can match the prefix (default: 0).

    • Max. Length: The longest phone number that can match the prefix (default: 100).

  3. Click Submit to save the changes.

Number List Settings

Fig. 7. Number List Settings



3. Assign a Number List to a Trunk

After creating and configuring your Number List, you can assign it to a trunk to apply inbound call filtering rules.

Number Lists can be assigned to either a SIP Trunk or a PSTN Trunk, depending on your routing setup. Choose one of the options below:

Assign a Number List to a SIP Trunk

Apply your Number List to a SIP trunk to filter inbound calls.

Assign a Number List to a SIP Trunk
Assign a Number List to a PSTN Trunk

Apply your Number List to a PSTN trunk to filter inbound calls.

Assign a Number List to a PSTN Trunk

Assign a Number List to a SIP Trunk

Follow these steps to assign a Number List to a SIP Trunk.

Step 1: Open the SIP Trunk

  1. Go to the Voice > Inbound Trunks menu.

  2. Choose an existing SIP Trunk by clicking its name, or create a new one (see SIP Trunk documentation).

Selecting an inbound SIP trunk

Fig. 8. Selecting an inbound SIP trunk

Step 2: Assign the Number List

  1. In the General section, locate the CLI Number List field and select the Number List you want to assign.

  2. Click Submit to save the changes.

Warning

Number Lists match inbound caller ID (CLI). If you change the CLI format or CLI prefix in the SIP Trunk settings, update your Number List entries to match the new format.

Assigning a Number List to a SIP Trunk

Fig. 9. Assigning a Number List to a SIP Trunk

Assign a Number List to a PSTN Trunk

Follow these steps to assign a Number List to a PSTN Trunk.

Step 1: Open the PSTN Trunk

  1. Go to the Voice > Inbound Trunks menu.

  2. Choose an existing PSTN Trunk or create a new one (see PSTN Trunk documentation).

Selecting an inbound PSTN trunk

Fig. 10. Selecting an inbound PSTN trunk

Step 2: Assign the Number List

  1. In the General section, locate the CLI Number List dropdown and select the Number List you want to assign.

  2. Click Submit to save the changes.

Assigning a Number List to a PSTN Trunk

Fig. 11. Assigning a Number List to a PSTN Trunk



Edit or Delete a Number List

To edit or delete an existing Number List, such as changing its name, mode, or default action, follow these steps:

  1. Go to Inbound Trunks > Number Lists.

  2. Locate the list you want to edit or delete.

  3. Click the Actions button button next to the list and choose:

    • Edit: Modify the Friendly Name, Mode, or Default Action and click Update to save changes.

    • Delete: If the list is not assigned to a trunk, confirm deletion when prompted.

Editing a Number List

Fig. 12. Editing a Number List.

Important

If a Number List is assigned to a trunk, it cannot be deleted. To check where it is in use:

  1. Go to Inbound Trunks.

  2. Use the CLI Number List filter to find trunks using the list.

  3. Remove the Number List from the trunk before attempting deletion.



Edit or Delete Numbers in a Number List

After adding numbers to a Number List, you can modify their settings or remove them as needed. Each number can be configured to allow or reject calls, ensuring precise call filtering.

To edit or delete a number in a Number List, follow these steps:

  1. Open the Number List that contains the number.

  2. Locate the number you want to modify or remove.

  3. Click the Actions button button next to the number and choose:

    • Edit to update the number, prefix or its action (Allow/Reject), then click Save.

    • Delete to remove the number and confirm the action.

Editing or deleting a number in a Number List

Fig. 13. Editing or deleting a number in a Number List.



Call Logs & Number List Rejection Codes

When a call is rejected due to Number List filtering, it will appear in the Inbound Call Logs with the following error message:

  • Error code: 403

  • Response: Rejected by trunk settings

This error message in the call logs indicates that the call was blocked by Number List settings before it could reach the trunk destination.


Why does this error occur?

If a number is included in a Number List with the action Reject Call, the system blocks the call before routing it to the trunk destination.

This prevents further call processing, leading to the 403 error.


How can I check inbound call rejections caused by a Number List?

Follow these steps to analyze calls rejected due to a Number List:

  1. Navigate to Logs & Analytics > Call Logs and select the Inbound tab.

  2. Look for calls that failed with the Rejected by trunk settings response. (You can also filter by status: Failed.)

  3. Check if the caller’s number is listed in your Number List.

Call Rejection Error Code

Fig. 14. Call Rejection Error Code

Note

If you want to allow a blocked number, go to your Number List settings and change its action to Allow Call or remove it from the list.



Additional Resources

Number List Examples & Use Cases

Learn how to configure Number Lists with real-world scenarios, such as blocking spam calls, allowing only specific prefixes, or restricting unwanted callers.

Number List Examples & Use Cases
Create a SIP trunk

Create and configure SIP trunks for inbound calls, set transport protocols, authentication, media options, and more.

SIP Trunk
Inbound Call Logs

Review and analyze your inbound call logs, which provide detailed records of inbound call activity.

Inbound Call Logs