Set up visitor location detection

Applies to: Dynamics 365 Contact Center—embedded, Dynamics 365 Contact Center—standalone, and Dynamics 365 Customer Service

You can configure your chat widget to detect a visitor's location based on their latitude and longitude. With location detection enabled, visitors receive a prompt in their web browser when they start to chat. If the visitor allows their location to be shared, it will passed through to the agent. Agents can then use this information to provide a personalized support experience.

To enable location detection, you must first get your Bing Maps API key and create a geo location provider record. After you create a geo location provider record, you must add it in the Location tab of the appropriate chat widgets to enable location detection. For information on how to get the Bing Maps API key, see Getting a Bing Maps Key.

Prerequisite

Make sure you have permissions on the secure columns. More information: Configure permissions to access secure columns

Create a geo location provider record

You can create a geo location provider record in the Customer Service admin center or Contact Center admin center app.

1. In the site map, select Customer Settings in Customer support. The Customer settings page appears.

2. In the Geo location section, select Manage. The Active Geo Location Providers page is displayed.

3. Select New to add a geo location provider record.

4. In the New Geo Location Provider pane, provide the following information:

   • Name: Name of the geo location record.

   • Bing Maps API key: API key of Bing Maps to get the visitor's location.

   

5. Select Save and Close.

Enable visitor location detection

If you're using Customer Service admin center or Contact Center admin center app, do the following:

1. Go to the chat channel settings of the chat widget in which you want to enable geo location.

2. On the Behaviors tab, for Customer location detection, set the toggle to On.

3. In the Geo location provider list, select the provider that you've configured.

4. Save the settings.

Privacy notice

Location data: If a user approves the browser request for detecting location, the app or website may collect and use precise data about the user’s location. Precise location data can be Global Position System (GPS) data, as well as data identifying nearby cell towers and Wi-Fi hotspots. The app or website collects latitude and longitude information from the user’s browser and sends it to Bing Maps for converting it into precise location data such as street, city, state, country, and zip code of the user. The app or website may also send location data to Microsoft Dynamics 365. A user may disable the location detection by turning off the location settings in their web browser settings. All use of Bing Maps is governed by the Bing Maps End User Terms of Use available at https://go.microsoft.com/?linkid=9710837 and the Bing Maps Privacy Statement available at https://go.microsoft.com/fwlink/p/?LinkID=248686. An administrator can turn off this visitor location feature by setting the “Request visitor location” to “No”, so that no further information will be sent to Bing Map from the app or website.

NOTE: Bing Maps is not provisioned in a dedicated data center for exclusive use by you and does not provide data segregation, such as for the Government Community Cloud. Your use of Bing Maps shall not be subject to any product-specific terms and conditions applicable to Dynamics 365 online for Government. If you do not wish to use the Visitor Location feature, then you must ensure that your administrator keeps the feature off.