.. _ms-tenant-dialplan:

Configure Microsoft tenant dialplan
------------------------------------

.. _21.1|VOSS-847:
.. _21.3|EKB-11892:



.. tip:: 

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


This procedure displays and edits existing Microsoft Teams tenant dialplans and adds a new Microsoft 
Teams tenant dialplan. 

.. note:: 
   
   A default tenant dialplan can be chosen in the site defaults. When adding a user via Quick Add User, 
   the default tenant dialplan can be overwritten if you choose another option. 


**Prerequisites**: 

* Add a Microsoft tenant


**Perform these steps**:

1. Log in to the Admin Portal. 
#. Go to **Tenant Dialplan**. 
#. View existing tenant dialplans. 
#. Choose an option: 
 
   * To edit an existing dialplan, click on a dialplan to open its configuration settings. Make your changes, 
     then save the dialplan. 
   * To add a new dialplan, click the Plus icon (+) to open the New Record screen. Go to step 5. 

#. On the **New Record** page, fill out details for the new Microsoft tenant dialplan: 

   * In the **Name** field, fill out a unique name for the dialplan.
   * In the **Simple Name** field, fill out a unique display name for the dialplan. 
   * In the **Description** field, describe the purpose and users of the dialplan. 
   * In the **External Access Prefix** field, define a prefix used to identify external calls. To enable this 
     prefix, select **Optimize Device Dialing**.
   * Select **Optimize Device Dialing** to enable the external access prefix. 
   * At **Normalization Rules**, click the Plus icon (+) to add a normalization rule: 

     * Provide a unique ID for the normalization rule, and a description. 
     * Define the priority order of this rule, for phone numbers associated with two or more 
       normalization rules. 
     * In the **Pattern** field, provide a regular expression that a dialed number must match 
       for the rule to be applied. The default is `^(\d{11})$`, which represents any set of 
       numbers up to 11 digits.
     * In the **Translation** field, define a regular expression to apply to the 
       number to convert it to E.164 format. The default is +$1, which prefixes the number with a Plus (+).
     * Select **Is Internal Extension** if the number should be seen as internal when the rule is applied (set to 
       True); else, clear the checkbox (False, default), so that the number is seen as external 
       when the rule is applied. 
     * To add additional normalization rules, click the Plus icon (+) and fill out values for the 
       next normalization rule. 

#. Click **Save** to create or update the tenant dialplan.  





.. rubric:: Related topics 

* 
  .. raw:: latex

     Microsoft tenant setup in the Core Feature Guide

  .. raw:: html
  
     <a href="microsoft/ms-tenant-setup.html"> Microsoft tenant setup</a> 
 
* 
  .. raw:: latex

     Introduction to Microsoft Teams dialplan management in the Core Feature Guide

  .. raw:: html
  
     <a href="concepts-intro-ms-dialplan-management.html">Introduction to Microsoft Teams dialplan management</a> 
 
* 
  .. raw:: latex

     Microsoft overview in the Core Feature Guide

  .. raw:: html
  
     <a href="concepts-microsoft-overview.html">Microsoft overview</a> 

*
  .. raw:: latex

     Sync to site with flow through in the Core Feature Guide

  .. raw:: html

     <a href="sync-ms-users-to-sites.html#sync-to-site-with-flow-through-provisioning">Sync to site with flow through</a>

* 
  .. raw:: latex

     Configure Automate for Microsoft services in the Core Feature Guide

  .. raw:: html
  
     <a href="config-automate-for-ms-services.html">Configure Automate for Microsoft services</a>