add UK and CA to emergency calling

Author: boris-bazilevskiy

articles/communication-services/concepts/telephony/emergency-calling-concept.md

@@ -17,48 +17,48 @@ ms.subservice: pstn
 
 ## Overview  
 
-Azure Communication Calling SDK can be used to add Enhanced 911 dialing and Public Safety Answering Point (PSAP) call-back support to your applications in the United States (US) & Puerto Rico. The capability to dial 911 and receive a call-back may be a requirement for your application. Verify the E911 requirements with your legal counsel.
+Azure Communication Calling SDK can be used to add Enhanced Emergency dialing and Public Safety Answering Point (PSAP) call-back support to your applications in the United States (US), Puerto Rico (PR), the United Kingdom (GB), and Canada (CA). The capability to dial 911 (in US, PR, and CA) and 999 or 112 (in GB) and receive a call-back may be a requirement for your application. Verify the Emergency Calling requirements with your legal counsel.
 
-Calls to 911 are routed over the Microsoft network. Microsoft assigns a temporary phone number as the Call Line Identity (CLI) when 911 calls from the US & Puerto Rico are placed. Microsoft temporarily maintains a mapping of the phone number to the caller's identity. If there's a call-back from the PSAP, we route the call directly to the originating 911 caller. The caller can accept incoming PSAP call even if inbound calling is disabled.
+Calls to an emergency number are routed over the Microsoft network. Microsoft assigns a temporary phone number as the Call Line Identity (CLI) when an emergency call from the US, PR, GB, or CA are placed. Microsoft temporarily maintains a mapping of the phone number to the caller's identity. If there is a call-back from the PSAP, we route the call directly to the originating caller. The caller can accept incoming PSAP call even if inbound calling is disabled.
 
-The service is available for Microsoft phone numbers. It requires that the Azure resource from where the 911 call originates has a Microsoft-issued phone number enabled with outbound dialing (also referred to as ‘make calls').  
+The service is available for Microsoft phone numbers. It requires that the Azure resource from where the emergency call originates has a Microsoft-issued phone number enabled with outbound dialing (also referred to as ‘make calls').  
 
-Azure Communication Services direct routing is currently in public preview and not intended for production workloads. So E911 dialing is out of scope for Azure Communication Services direct routing.
+Azure Communication Services direct routing is currently in public preview and not intended for production workloads. So emergency dialing is out of scope for Azure Communication Services direct routing.
 
 ## The call flow
 
-1. An Azure Communication Services user identity dials 911 using the Calling SDK from the USA or Puerto Rico
+1. An Azure Communication Services user identity dials emergency number using the Calling SDK from the USA or Puerto Rico
 1. Microsoft validates the Azure resource has a Microsoft phone number enabled for outbound dialing
-1. Microsoft Azure Communication Services 911 service replaces the user’s phone number `alternateCallerId` with a temporary unique phone number. This number allocation remains in place for at least 60 minutes from the time that 911 is first dialed
+1. Microsoft Azure Communication Services emergency service replaces the user’s phone number `alternateCallerId` with a temporary unique phone number. This number allocation remains in place for at least 60 minutes from the time that emergency number is first dialed
 1. Microsoft maintains a temporary record (for approximately 60 minutes) of the user’s identity to the unique phone number
-1. The 911 call will be first routed to a call center where an agent will request the caller’s address
-1. The call center will then route the call to the appropriate PSAP in the USA or Puerto Rico
-1. If the 911 call is unexpectedly dropped, the PSAP then makes a call-back to the user
-1. On receiving the call-back within 60 minutes, Microsoft will route the inbound call directly to the user identity, which initiated the 911 call
+1. The emergency call will be first routed to a call center where an agent will request the caller’s address
+1. The call center will then route the call to the appropriate PSAP in a proper region
+1. If the emergency call is unexpectedly dropped, the PSAP then makes a call-back to the user
+1. On receiving the call-back within 60 minutes, Microsoft will route the inbound call directly to the user identity, which initiated the emergency call
 
 ## Enabling Emergency calling
 
-Emergency dialing is automatically enabled for all users of the Azure Communication Client Calling SDK with an acquired Microsoft telephone number that is enabled for outbound dialing in the Azure resource. To use E911 with Microsoft phone numbers, follow the steps:
+Emergency dialing is automatically enabled for all users of the Azure Communication Client Calling SDK with an acquired Microsoft telephone number that is enabled for outbound dialing in the Azure resource. To use emergency calling with Microsoft phone numbers, follow the steps:
 
 1. Acquire a Microsoft phone number in the Azure resource of the client application (at least one of the numbers in the Azure resource must have the ability to ‘Make Calls’) 
 
 1. Use the APIs in the calling SDK to set the country code of the user
 
     1. Microsoft uses the ISO 3166-1 alpha-2 standard
 
-    1. Microsoft supports a country US and Puerto Rico ISO codes for 911 dialing
+    1. Microsoft supports a country US, PR, GB, and CA ISO codes for emergency number dialing
 
     1. If the country code isn't provided to the SDK, the IP address is used to determine the country of the caller
 
-        1. If the IP address can't provide reliable geo-location, for example the user is on a Virtual Private Network, it's required to set the ISO Code of the calling country using the API in the Azure Communication Services Calling SDK. See example in the E911 quick start
+        1. If the IP address can't provide reliable geo-location, for example the user is on a Virtual Private Network, it's required to set the ISO Code of the calling country using the API in the Azure Communication Services Calling SDK. See example in the emergency calling quick start
 
         1. If users are dialing from a US territory (for example Guam, US Virgin Islands, Northern Marianas, or American Samoa), it's required to set the ISO code to the US
 
-    1. If the caller is outside of the US and Puerto Rico, the call to 911 won't be permitted
+    1. If the caller is outside of the supported countries, the call to 911 won't be permitted
 
-1. When testing your application dial 933 instead of 911. 933 is enabled for testing purposes; the recorded message will confirm the phone number the emergency call originates from. You should hear a temporary number assigned by Microsoft, which isn't the `alternateCallerId` provided by the application
+1. When testing your application in the US, dial 933 instead of 911. 933 is enabled for testing purposes; the recorded message will confirm the phone number the emergency call originates from. You should hear a temporary number assigned by Microsoft, which isn't the `alternateCallerId` provided by the application
 
-1. Ensure your application supports [receiving an incoming call](../../how-tos/calling-sdk/manage-calls.md#receive-an-incoming-call) so call-backs from the PSAP are appropriately routed to the originator of the 911 call. To test inbound calling is working correctly, place inbound VoIP calls to the user of the Calling SDK
+1. Ensure your application supports [receiving an incoming call](../../how-tos/calling-sdk/manage-calls.md#receive-an-incoming-call) so call-backs from the PSAP are appropriately routed to the originator of the emergency call. To test inbound calling is working correctly, place inbound VoIP calls to the user of the Calling SDK
 
 The Emergency service is temporarily free to use for Azure Communication Services customers within reasonable use, however, billing for the service will be enabled in 2022. Calls to 911 are capped at 10 concurrent calls per Azure resource.
 

articles/communication-services/includes/emergency-calling-notice-include.md

@@ -7,6 +7,6 @@ ms.author: bobazile
 ms.custom: emergency_calling
 ---
 > [!IMPORTANT]
-> **Azure Communication Services supports emergency calling to 911 in the United States and Puerto Rico only.**
+> **Azure Communication Services supports emergency calling to emergency numbers in the United States, Puerto Rico, Canada, and the United Kingdom only.**
 >
->Azure Communication Services’ Voice Calling (PSTN) can be used for dialing 911 from users in the United States and Puerto Rico. Dialling 911 from outside of the United States & Puerto Rico or dialling emergency services in countries other than the United States & Puerto Rico is not supported.  
+>Azure Communication Services’ Voice Calling (PSTN) can be used to dial emergency number 911 by users in the United States, Puerto Rico, and Canada and to dial emergency numbers 999 and 112 by users in the United Kingdom. Dialing emergency numbers from outside of the countries listed above or dialing emergency services in countries other than the countries listed above is not currently supported.

articles/communication-services/quickstarts/telephony/includes/emergency-calling-android.md

@@ -12,15 +12,15 @@ ms.author: zehangzheng
 - A working [Communication Services calling Android app](../pstn-call.md).
 
 ## Important considerations
-- The capability to dial 911 and receive a call-back may be a requirement for your application. Verify the E911 requirements with your legal counsel. 
+- The capability to dial an emergency number and receive a call-back may be a requirement for your application. Verify the emergency calling requirements with your legal counsel. 
 - Microsoft uses country codes according to ISO 3166-1 alpha-2 standard 
 - If the country ISO code is not provided to the SDK, the IP address will be used to determine the country of the caller. 
 - In case IP address cannot provide reliable geolocation, for example the user is on a Virtual Private Network, it is required to set the ISO Code of the calling country using the API in the Azure Communication Services Calling SDK. 
 - If users are dialing from a US territory (for example Guam, US Virgin Islands, Northern Marianas, or American Samoa), it is required to set the ISO code to the US   
-- Supported ISO codes are US and Puerto Rico only
-- Azure Communication Services direct routing is currently in public preview and not intended for production workloads. So E911 dialing is out of scope for Azure Communication Services direct routing.
-- The 911 service is temporarily free to use for Azure Communication Services customers within reasonable use, however billing for the service will be enabled in 2022.   
-- Calls to 911 are capped at 10 concurrent calls per Azure Resource.     
+- Supported ISO codes are US, PR, CA, and GB only
+- Azure Communication Services direct routing is currently in public preview and not intended for production workloads. So emergency dialing is out of scope for Azure Communication Services direct routing.
+- The emergency calling service is temporarily free to use for Azure Communication Services customers within reasonable use, however billing for the service will be enabled in 2022.   
+- Calls to an emergency number are capped at 10 concurrent calls per Azure Resource.       
 
 
 ## Setting up
@@ -118,7 +118,7 @@ private void emergencyCall() {
 }
 ```
 > [!IMPORTANT]
-> 933 is a test emergency call service, used to test emergency calling services without interrupting live production emergency calling handling 911 services.  911 must be dialled in actual emergency situations.
+> 933 is a test emergency call service, used to test emergency calling services without interrupting live production emergency calling handling 911 services.  911 must be dialed in actual emergency situations.
 
 ## Launch the app
 

articles/communication-services/quickstarts/telephony/includes/emergency-calling-ios.md

@@ -12,15 +12,15 @@ ms.author: zehangzheng
 - A working [Communication Services calling iOS app](../pstn-call.md).
 
 ## Important considerations
-- The capability to dial 911 and receive a call-back may be a requirement for your application. Verify the E911 requirements with your legal counsel. 
+- The capability to dial an emergency number and receive a call-back may be a requirement for your application. Verify the emergency calling requirements with your legal counsel. 
 - Microsoft uses country codes according to ISO 3166-1 alpha-2 standard 
 - If the country ISO code is not provided to the SDK, the IP address will be used to determine the country of the caller. 
 - In case IP address cannot provide reliable geolocation, for example the user is on a Virtual Private Network, it is required to set the ISO Code of the calling country using the API in the Azure Communication Services Calling SDK. 
 - If users are dialing from a US territory (for example Guam, US Virgin Islands, Northern Marianas, or American Samoa), it is required to set the ISO code to the US   
-- Supported ISO codes are US and Puerto Rico only
-- Azure Communication Services direct routing is currently in public preview and not intended for production workloads. So E911 dialing is out of scope for Azure Communication Services direct routing.
-- The 911 service is temporarily free to use for Azure Communication Services customers within reasonable use, however billing for the service will be enabled in 2022.   
-- Calls to 911 are capped at 10 concurrent calls per Azure Resource.     
+- Supported ISO codes are US, PR, CA, and GB only
+- Azure Communication Services direct routing is currently in public preview and not intended for production workloads. So emergency dialing is out of scope for Azure Communication Services direct routing.
+- The emergency calling service is temporarily free to use for Azure Communication Services customers within reasonable use, however billing for the service will be enabled in 2022.   
+- Calls to an emergency number are capped at 10 concurrent calls per Azure Resource.    
 
 
 ## Setting up
@@ -105,7 +105,7 @@ func emergencyCall() {
     }
 ```
 > [!IMPORTANT]
-> 933 is a test emergency call service, used to test emergency calling services without interrupting live production emergency calling handling 911 services.  911 must be dialled in actual emergency situations.
+> 933 is a test emergency call service, used to test emergency calling services without interrupting live production emergency calling handling 911 services.  911 must be dialed in actual emergency situations.
 
 ## Launch the app
 

articles/communication-services/quickstarts/telephony/includes/emergency-calling-javascript.md

@@ -12,15 +12,15 @@ ms.author: zehangzheng
 - A working [Communication Services calling web app](../pstn-call.md).
 
 ## Important considerations
--	The capability to dial 911 and receive a call-back may be a requirement for your application. Verify the E911 requirements with your legal counsel. 
+- The capability to dial an emergency number and receive a call-back may be a requirement for your application. Verify the emergency calling requirements with your legal counsel. 
 - Microsoft uses country codes according to ISO 3166-1 alpha-2 standard 
--	If the country ISO code is not provided to the SDK, the IP address will be used to determine the country of the caller. 
--	In case IP address cannot provide reliable geolocation, for example the user is on a Virtual Private Network, it is required to set the ISO Code of the calling country using the API in the Azure Communication Services Calling SDK. 
--	If users are dialing from a US territory (for example Guam, US Virgin Islands, Northern Marianas, or American Samoa), it is required to set the ISO code to the US   
--	Supported ISO codes are US and Puerto Rico only
--	Azure Communication Services direct routing is currently in public preview and not intended for production workloads. So E911 dialing is out of scope for Azure Communication Services direct routing.
--	The 911 service is temporarily free to use for Azure Communication Services customers within reasonable use, however billing for the service will be enabled in 2022.   
--	Calls to 911 are capped at 10 concurrent calls per Azure Resource.   
+- If the country ISO code is not provided to the SDK, the IP address will be used to determine the country of the caller. 
+- In case IP address cannot provide reliable geolocation, for example the user is on a Virtual Private Network, it is required to set the ISO Code of the calling country using the API in the Azure Communication Services Calling SDK. 
+- If users are dialing from a US territory (for example Guam, US Virgin Islands, Northern Marianas, or American Samoa), it is required to set the ISO code to the US   
+- Supported ISO codes are US, PR, CA, and GB only
+- Azure Communication Services direct routing is currently in public preview and not intended for production workloads. So emergency dialing is out of scope for Azure Communication Services direct routing.
+- The emergency calling service is temporarily free to use for Azure Communication Services customers within reasonable use, however billing for the service will be enabled in 2022.   
+- Calls to an emergency number are capped at 10 concurrent calls per Azure Resource.
 
 
 ## Setting up
@@ -97,7 +97,7 @@ emergencyButton.addEventListener("click", () => {
 });
 ```
 > [!IMPORTANT]
-> 933 is a test emergency call service, used to test emergency calling services without interrupting live production emergency calling handling 911 services.  911 must be dialled in actual emergency situations.
+> 933 is a test emergency call service, used to test emergency calling services without interrupting live production emergency calling handling 911 services.  911 must be dialed in actual emergency situations.
 
 
 ## Run the code