.. _number-management-cooling:

Number cooling
--------------

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

.. index:: Flowchart;Number Cooling



.. tip:: 

   :ref:`use-action-search-to-navigate-automate`

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 Global Settings.


During the cooling period, the number can't 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 is removed from the cooling
period, it is 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 & Reserved Number Management** form allows a Provider administrator to manually add numbers to a cooling
period (which removes these numbers from the list of available numbers), or to manually
remove numbers from a cooling period (which returns these numbers to the list of
available numbers).


.. raw:: html 

   <p>
      <a href="https://documentation.voss-solutions.com/videos/Manage-Number-Cooling.mp4" target="_blank">Video: <i class="material-icons">videocam</i><br>
      <img src="https://documentation.voss-solutions.com/videos/Manage-Number-Cooling.png" alt="Manage-Number-Cooling-video" style="height:135px;width:240px;border:1px solid black"></a>
   </p>


.. raw:: html 

   <p>
      <a href="https://documentation.voss-solutions.com/videos/Enable-Number-Cooling.mp4" target="_blank">Video: <i class="material-icons">videocam</i><br>
      <img src="https://documentation.voss-solutions.com/videos/Enable-Number-Cooling.png" alt="Enable-Number-Cooling-video" style="height:135px;width:240px;border:1px solid black"></a>
   </p>


.. rubric:: Related topics

* :ref:`list-number-inventory-overview`
* :ref:`run-dni-audit-tool`
* 
  .. raw:: latex

     Number Cooling Auto Expiry Schedule in the Advanced Configuration Guide

  .. raw:: html
  
     <a href="concepts-number-cooling-auto-expiry-schedule.html">Number Cooling Auto Expiry Schedule</a>

* 
  .. raw:: latex

     Global Settings in the Core Feature Guide

  .. raw:: html
  
     <a href="concepts-global-settings.html">Global Settings</a>



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

1. Navigate to the required hierarchy level (Provider, Customer or Site) from which you
   want to add numbers to a cooling period.
#. Go to **Cooling & Reserved Number Management**. 
#. At **Select action**, choose **Apply cooling**.
#. Optionally, fill out a cooling duration in days (max = 999) to apply to the selected
   numbers. 
   
   .. note:: 
      
      This value overrides the value set in their global settings. If this field is left blank, the 
      cooling duration set in :ref:`global-settings` for each number will apply.

#. Configure values in **Filters** to define the numbers to include 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:: 
      
      The **Available** field displays only unused and available numbers. Used numbers don't display. 

#. 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.
#. Go to **Cooling & Reserved Number Management**. 
#. From the **Select action** drop-down, choose **Remove from cooling**.
#. Configure values at **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.