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 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 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 SIP Trunk

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

3. Assign a Number List to a SIP 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 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 numbers or manage numbers in the list and click in actions the Actions 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 SIP Trunk

After creating and configuring your Number List, you must assign it to a SIP Trunk to apply call filtering rules. This ensures that inbound calls to the trunk are allowed or rejected based on your configured settings.

Follow these steps to assign a Number List to a new or existing SIP Trunk.

Step 1: Open Inbound Trunk

  1. Go to Voice menu.

  2. Select Inbound Trunks and open the Trunks tab.

  3. Choose an existing SIP Trunk by clicking its name to open the settings, or create a new trunk by following the SIP Trunk Documentation.

Assigning a Number List

Fig. 8. Assigning a Number List

Step 2: Select a CLI Number list

  1. In the General settings, locate the CLI Number List field.

  2. Select the Number List you want to assign.

Warning

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

Assigning a Number List

Fig. 9. Assigning a Number List



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 SIP trunk, confirm deletion when prompted.

Editing a Number List

Fig. 10. Editing a Number List.

Important

If a Number List is assigned to a SIP 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 SIP trunks using the list.

  3. Remove the Number List from the SIP 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. 11. 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 SIP 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 SIP 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. 12. 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