Cisco Webex Edge Audio for Only Expressway-E Customer Configuration Guide

Sign in to Webex Site Administration and go to Configuration > Common Site Settings > Audio Settings.

In the Allowed Call-in Numbers section, choose the Webex-provided global call-in numbers on which hosts and participants can call in to a meeting.

1. Uncheck the box to disable any global toll or toll-free call-in number that you don't want hosts and participants to use.

2. When you're done making changes, click Save.

In the Edge Audio Custom Global Call-in Numbers section, add custom dial-in numbers if you have them. These are numbers that your organization owns, which callers can use to call in from a specific country or region.

1. Choose the country or region and toll type from the drop-down menus.

2. Enter the digits of the number following the country or region code. You can also enter brackets, dashes, or dots to change how the number displays. You can enter up to 32 digits.

3. Optionally, change or replace the automatically generated phone label.

4. Click Save to add the entry to the call-in numbers list.

When you are done adding numbers, click Preview to see all your allowed call-in numbers. Make note of all of the phone numbers in a separate file.

Click Generate Lua Script, and then select Export.

In the Site Default Global Call-in Numbers section, choose up to two dial-in numbers to use as global defaults for your site.

1. Check the Assign default call-in numbers check box.

2. Select a call-in option from the list on the left and click Add >.

   You can order the default call-in numbers with the Move Up and Move Down buttons.

   If you disabled the Webex Default toll number in the Allowed Call-in Numbers section, select at least one toll option in this section.

3. Click Save.

   Your changes can take up to 30 minutes to propagate to the client.

In the Notifications section, decide whether to have Webex notify impacted hosts when you disable or delete a number that the hosts use as their default.

From the customer view in https://admin.webex.com, go to Services and under Meeting select Sites.

Select the site to configure with Edge Audio, and choose Configure Site.

Select Common Settings > Audio Settings.

In the Allowed Call-in Numbers section, choose the Webex-provided global call-in numbers on which hosts and participants can call in to a meeting.

1. Uncheck the box to disable any global toll or toll-free call-in number that you don't want hosts and participants to use.

2. When you're done making changes, click Save.

In the Edge Audio Custom Global Call-in Numbers section, add custom dial-in numbers if you have them. These are numbers that your organization owns, which callers can use to call in from a specific country or region.

1. Choose the country or region and toll type from the drop-down menus.

2. Enter the digits of the number following the country or region code. You can also enter brackets, dashes, or dots to change how the number displays. You can enter up to 32 digits.

3. Optionally, change or replace the automatically generated phone label.

4. Click Save to add the entry to the call-in numbers list.

When you are done adding numbers, click Preview to see all your allowed call-in numbers. Make note of all of the phone numbers in a separate file.

Click Generate Lua Script, and then select Export.

In the Site Default Global Call-in Numbers section, choose up to two dial-in numbers to use as global defaults for your site.

1. Check the Assign default call-in numbers check box.

2. Select a call-in option from the list on the left and click Add >.

   You can order the default call-in numbers with the Move Up and Move Down buttons.

   If you disabled the Webex Default toll number in the Allowed Call-in Numbers section, select at least one toll option in this section.

3. Click Save.

   Your changes can take up to 30 minutes to propagate to the client.

In the Notifications section, decide whether to have Webex notify impacted hosts when you disable or delete a number that the hosts use as their default.

In Unified CM Administration, go to Device > Device Settings > SIP Normalization Script.

Select Add New to create a new SIP Normalization Script.

Give the script a name that clearly identifies it, such as “your_site_name_webex_edge_audio”.

Select Import File, and select the Lua script that you exported earlier.

Set Memory Threshold to 200.

Set Lua Instruction Threshold to 3000.

Click Save.

From Unified CM Administration, go to Device > Device Settings > SIP Profile, and select Find.

Select Standard SIP Profile For Cisco VCS.

Select Copy.

Change the Name to identify the new version. For example, add EO_Profile to the name.

Uncheck the Allow iX Application Media check box.

Set Early Offer support for voice and video calls to Best Effort (no MTP inserted).

Save your SIP Profile.

From Cisco Unified CM Administration, go to System > Security > SIP Trunk Security Profile, and select Add New.

Name the SIP trunk security profile.

Set Device Security Mode to Encrypted or Non- secure, based on your deployment needs.

Enter a port value for the Incoming Port that doesn't conflict with other entries.

Save your profile.

From Unified CM Administration, go to System > Enterprise Parameters.

Choose Enabled for Advertise G.722 Codec and save your change.

Go to System > Region Information > Region and click Add New.

Name the region, and save the change.

Select Factory Default lossy for the Audio Codec Preference List.

Select 64 kbps (G.722, G.711) for the Maximum Audio Bit Rate.

Save your changes.

From Cisco Unified CM Administration, go to Device > Trunk, and select Add New.

For Trunk Type, select SIP Trunk, and then choose Next.

Enter a Device Name.

Under Destination, enter the Destination Address and the Destination Port for your Expressway-CCUBEExpressway-E.

Set the SIP Trunk Security Profile to the trunk that you created in the Create a SIP Trunk Security Profile task.

Set the SIP Profile to the SIP profile that you created in the (Optional) Set Early Offer Support for Voice and Video Calls task.

For the DTMF Signaling Method, select RFC 2833.

For Normalization Script, select the Normalization Script that you created in the Create SIP Normalization Script from the Webex LUA Script task.

Save the trunk.

From Cisco Unified CM Administration, go to Call Routing > Route/Hunt > Route Group.

Select Add New.

Name the route group.

For Available Devices, select the Edge Audio trunk that you created.

Select Add to Route Group.

Save the route group.

From Cisco Unified CM Administration, go to Call Routing > Route/Hunt > Route List.

Select Add New.

Name the route list and give it a description.

For Cisco Unified Communications Manager Group, select an appropriate value for your configuration, and then save the change.

Under Route List Member Information, select Add Route Group, and choose the route group that you created.

Save the route list.

From Cisco Unified CM Administration, go to Call Routing > Route/Hunt > Route Pattern, and select Add New.

For Route Pattern, enter a phone number over which users dial in to their Webex meetings.

For Gateway/Route List, select the route list that you created in the previous task.

Save your changes.

Repeat these steps for each of the remaining phone numbers that you saved earlier.

Sign in to the Expressway-CExpressway-E configuration page and go to Configuration > Zones > Zones, and select Add New.

Name the zone.

For Type, select Neighbor.

Under H.323, set the Mode to Off.

Under SIP, set these properties:

Under Location, enter the Unified CM peer information.

Under Advanced, set these properties:

Click Create Zone.

Sign in to the Expressway-E configuration page, go to Configuration > Zones > Zones, and select New.

For Type, select Webex.

Click Create zone.

Find the numeric zone ID for the Webex zone by selecting it from the zone list. The numeric zone ID appears in your browser address bar, for example, "editzone?id=3".

Using the admin CLI with numeric zone ID, set the Webex Zone to use a Force Encrypted media encryption configuration. For example, if the zone ID is 3, you use this command:

xConfiguration Zones Zone 3 DNS SIP Media Encryption Mode: "On"

Sign in to the Expressway-E configuration page, go to Configuration > Zones > Zones, and select Create Zone.

Name the zone.

For Type, select DNS.

Under H.323, set the Mode to Off.

For TLS verify mode, select On.

For TLS verify subject name, enter sip.webex.com.

For TLS verify inbound mapping, select On.

Set the Media encryption mode to Auto.

Set the Media encryption mode to Force Encrypted.

Under Advanced, set Zone profile to Custom.

For SIP parameter preservation, select On.

Save your changes.

Sign in to the Expressway-E configuration page, go to Configuration > Dial plan > Search rules, and select New.

Name the search rule and assign it a priority, if necessary.

Set these properties:

Click Create search rule.

Sign in to the Expressway-E configuration page and go to Maintenance > Security > Ciphers.

For SIP TLS ciphers, enter this cipher:

EECDH:EDH:HIGH:-AES256+SHA:!MEDIUM:!LOW:!3DES:!MD5:!PSK:!eNULL:+ADH

For SIP minimum TLS version, select TLS v1.2.

Save your changes.

Sign in to the Expressway-E configuration page and go to Configuration > Protocols > SIP.

For Mutual TLS mode, select On.

Set the Mutual TLS port to 5062.

Save your changes.

Sign in to the Expressway-E configuration page and go to Configuration > Protocols > SIP.

Scroll to Session refresh interval (seconds), and set the value to 14400.

Save your change.

Sign in to the Expressway-E configuration page, go to Configuration > Dial Plan > Search rules, and select New.

Name the rule and assign it a priority, if necessary.

Set these properties:

Select Create search rule.

Sign in to Cisco Webex Site Administration, and go to Configuration > Common Site Settings > Audio Settings.

In the Edge Audio Allowed Callback Numbers section, select the Country/Region for which to apply callback settings, and then enter the domain name for the Expressway DNS SRVCUBE DNS SRV .

Click Add.

To show connectivity check details, click on the status indicator to display the Verify SIP Destination page.

Choose Apply Settings when you're done adding all the callback settings.

From the customer view in admin.webex.com, go to Services, and under Meeting, select Sites.

Select the site for which to configure Edge Audio, and choose Configure Site.

Select Common Settings > Audio Settings.

In the Edge Audio Allowed Callback Numbers section, select the Country/Region for which to apply callback settings, and then enter the domain name for the Expressway DNS SRVCUBE DNS SRV .

Click Add.

To show connectivity check details, click on the status indicator to display the Verify SIP Destination page.

Choose Apply Settings when you're done adding the callback settings.

Open the Lua Script in a text editor.

Scroll to the Update Request URI with Edge Audio URL and site uuid section and choose.

• One IVR language for all phone numbers—This example shows where to place the locale tag in the LUA script. This code uses the French (fr_FR) locale tag. Use the language that you want for your IVR:

  -- Update Request URI with Webex Express URL and site uuid
  if phoneNumber == "NUMBER_NEEDS_CUSTOM_LANUAGE" then
  local newRequestURI = string.gsub(requestURI, "sip:(.+)@(.*)", "sip:%1@cca.example.webex.com;locale=fr_FR;x-cisco-site-uuid=6f861ef80b622085e053000000000000”)
  msg:setRequestUri(newRequestURI)
  end

• One IVR language for one phone number, and a different language for all other phone numbers—This example shows where to place the locale tag in the LUA script for one number. This code uses the French (fr_FR) locale tag. Then, beneath the else tag, add the locale tag for the language that plays for all other IVR prompts.

   -- Update Request URI with Webex Express URL and site uuid
      if phoneNumber == "NUMBER_NEEDS_CUSTOM_LANUAGE" then 
          local newRequestURI = string.gsub(requestURI, "sip:(.+)@(.*)", "sip:%1@cca.example.webex.com;locale=fr_FR;x-cisco-site-uuid=6f861ef80b622085e053000000000000”)
          msg:setRequestUri(newRequestURI)
      else
          local newRequestURI = string.gsub(requestURI, "sip:(.+)@(.*)", "sip:%1@cca.example.webex.com;x-cisco-site-uuid=6f861ef80b622085e053000000000000")
          msg:setRequestUri(newRequestURI)
      end

• Multiple IVR languages for different phone numbers—This example shows where to place the locale tag in the LUA script. This code uses French (fr_FR) as the first assigned language. Beneath the first entry, add an elseif code block that uses the locale tag for the assigned to the next number. Finally, add an else code block that uses the locales tag for all IVR prompts.

  Use this
      -- Update Request URI with Webex Express URL and site uuid
      if phoneNumber == "NUMBER1_NEEDS_CUSTOM_LANUAGE" then 
          local newRequestURI = string.gsub(requestURI, "sip:(.+)@(.*)", "sip:%1@cca.example.webex.com;locale=fr_FR;x-cisco-site-uuid=6f861ef80b622085e0537326e00a3c4f")
          msg:setRequestUri(newRequestURI)
      elseif phoneNumber == "NUMBER2_NEEDS_CUSTOM_LANUAGE" then
          local newRequestURI = string.gsub(requestURI, "sip:(.+)@(.*)", "sip:%1@cca.example.webex.com;locale=en_US;x-cisco-site-uuid=6f861ef80b622085e0537326e00a3c4f")
          msg:setRequestUri(newRequestURI)
      else
          local newRequestURI = string.gsub(requestURI, "sip:(.+)@(.*)", "sip:%1@ccax.qa.webex.com;x-cisco-site-uuid=6f861ef80b622085e0537326e00a3c4f")
          msg:setRequestUri(newRequestURI)
      end
  

Save the Lua script and send it to your customer to upload to their Unified CM.