.. _number-management-cooling:

Number Cooling
--------------

.. _19.3.1|VOSS-639:
.. _20.1.1|VOSS-651:

.. index:: Flowchart;Number Cooling

Cooling Overview
................

Number cooling allows for the automatic aging of numbers after service delete
to prevent immediate reuse of a number. For example, if a user leaves the company,
the phone number that was in use can be placed into a cooling period for a
pre-configured number of days to prevent a new user from receiving unwanted calls
on that number. This feature can be enabled per hierarchy level.

.. note::

Number cooling is enabled and configured in :ref:`global-settings`.

During the cooling period, the number cannot be reused until either the cooling
period has elapsed, or until a provider administrator has manually removed the
number from the cooling period. Once a number has been removed from the cooling
period, it will be reintroduced into the pool of available numbers for allocation
to a subscriber, phone, device, etc.

A number cooling auto expiry schedule runs daily. This schedule polls the cooling
**Release Date** field on the number inventory list view to determine which numbers
have completed their cooling period. These numbers are then returned to the list
of available numbers at the specific hierarchy level. For more details refer to
"Number Cooling Auto Expiry Schedule" in the *Advanced Feature Guide*.

The **Cooling & Reservation** form (default menu **Number Management > Cooling &
Reservation**) allows a provider administrator to manually add numbers to a cooling
period (thereby *removing them from* the list of available numbers), or to manually
remove numbers from a cooling period (thereby *adding them back* to the list of
available numbers).

|youtube.png| `Enable Cooling <https://www.youtube.com/embed/SPmfmanz-Yk>`_

.. raw:: html

<br/>

<br/>

|youtube.png| `Manage Cooling <https://www.youtube.com/embed/5leBUWvwEio>`_

.. raw:: html

<br/>

<br/>

Apply cooling
.............

1. Navigate to the required hierarchy level (Provider, Customer or Site) from which you
want to add numbers to a cooling period.
#. On the **Cooling & Reservation** form, choose **Apply cooling** from the
**Select action** drop-down.
#. Enter an optional cooling duration in days (max = 999) to apply to the selected
numbers. This setting overrides the value set in their global settings. If this
field is left blank, then the cooling duration set in :ref:`global-settings` for
each number will apply.
#. Set **Filters** to determine which numbers will be included in the **Available**
box in the **Select Numbers** area, these include:

* **Include available numbers**
* **Include cooling numbers**
* **Contains**. Used to further refine the numbers displayed in the **Available**
box.
* **Show numbers at/below hierarchy**. Allows you to select a lower hierarchy
level than the one selected on the hierarchy breadcrumb.

#. Select one or more numbers in the **Available** box and click **Select** to
move them to the **Selected** box. Note that the **Available** box will not
display numbers that are used, i.e. it will only display numbers that are unused
and available.
#. Click **Save**. The selected number(s) are placed into a **Cooling** status, and
are no longer available for use until they reach either the **Release Date** or
until they are manually removed from cooling.

Remove from cooling
...................

1. Navigate to the required hierarchy level (Provider, Customer or Site) from which
you want to remove numbers from a cooling period, i.e. add them back into the
list of available numbers.
#. On the **Cooling & Reservation** form, choose **Remove from cooling** from the
**Select action** drop-down.
#. Set **Filters** to determine which numbers will be included in the **Available**
box in the **Select Numbers** area, these include:

* **Include cooling numbers**
* **Expires from cooling within (days)**.
* **Contains**. Used to further refine the numbers displayed in the *Available* box.
* **Show numbers at/below hierarchy**. Allows you to select a lower hierarchy
level than the one selected on the hierarchy breadcrumb.

#. Select one or more numbers in the **Available** box and click **Select** to
move them to the **Selected** box.
#. Click **Save**. The selected number(s) are removed from the cooling period and
are available for allocation to a subscriber or phone, etc.