Blacklist/Whitelist

Yeastar Cloud PBX allows you to blacklist and whitelist IP addresses. This article briefly introduces the definitions and basic settings of blacklist and whitelist, and provides related configuration examples.

What is Blacklist and Whitelist

We briefly introduce the definitions of blacklist and whitelist as follows.

  • Blacklist

    The blacklist is used to filter phone numbers. If a phone number is added to the blacklist, the system blocks incoming or outgoing calls for the phone number.

  • Whitelist
    The whitelist is used to add trusted phone numbers. If a phone number is added to the whitelist, the system allows incoming or outgoing calls for the phone number.
    Note: The whitelist has a higher priority than the blacklist.

Blacklist/Whitelist Setting

Yeastar Cloud PBX supports system blacklist/whitelist and personal blacklist/whitelist. You can set a global system blacklist/whitelist to apply to all extensions. Extension users can also log in the PBX web interface by their accounts, and set blacklist/whitelist for their own extensions.

  • System Blacklist and Whitelist

    Log in the PBX web interface as an administrator, and go to Settings > PBX > Call Features > Blacklist/Whitelist to set blacklist and whitelist.

    Yeastar Cloud PBX supports to block or allow three types of numbers:
    • Inbound: If blacklist type is set to Inbound, the number can not call in the system; if whitelist type is set to Inbound, the number can call in the system.
    • Outbound: Extension users can not call the number whose blacklist type is Outbound; extension users can call the number whose whitelist type is Outbound.
    • Both: Neither inbound calls nor outbound calls are allowed for the number whose blacklist type is Both; both inbound calls and outbound calls are allowed for the number whose whitelist type is Both.
  • Personal Blacklist and Whitelist

    Log in the PBX web interface by extension accounts, the extension users can view the system blacklist and whitelist that is set by the administrator.

    Note: Extension users can add personal blacklist and whitelist for their extensions according to their needs.
  • Blacklist/Whitelist Priority

    Priority of blacklist/whitelist: system whitelist > system blacklist> personal whitelist > personal blacklist.

Blacklist Example

We demonstrate a few examples of blacklist as follows.

Prohibit inbound calls from external numbers

For example, 10086 and 1008611 are not allowed to call in PBX. You can add the two numbers to blacklist as follows.

Prohibit inbound calls and outbound calls

For example, 10086 and 1008611 are not allowed to call in PBX, and all extensions on PBX are not allowed to call out 10086 and 1008611.

Prohibit selected extensions or extension groups from calling certain numbers

  • Prohibit extension group (Sales) from calling 10086 and 1008611.
    Note: You can add an extension group in advance for quick selection.

  • Prohibit all extensions from calling 10086 and 1008611.

  • Prohibit extensions from calling numbers with specified extension format

    For example, prohibit extension group (sales) from calling R&D team (all extension numbers are in the format 5XXX).

Whitelist Example

The whitelist has a higher priority than the blacklist, so you can use whitelist to filter trusted phone numbers from blacklist, and allow inbound/outbound calls for the phone numbers.

For example, assume you've added 5XXX (extension numbers of R&D team) to blacklist to prohibit sales from calling R&D teams, but you want to allow sales to call extension 5001. In this case, you can add 5001 to whitelist as follows.