---
sourceDocument: Interfaces conversacionais de Yokohama
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/pt-BR/yokohama/conversational-interfaces

 Release :

    - yokohama

ft:locale :

    - pt-BR

ft:publication_title :

    - Interfaces conversacionais de Yokohama

ft:clusterId :

    - convint

bundleId :

    - convint

workflow :

    - Platform


---

# Usando geolocalização em Virtual Agent

# Usando geolocalização em Virtual Agent {#ariaid-title1}

* Versão de lançamento: Yokohama
* 
* Atualizado 30 de jan. de 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 2 min. de leitura

Os autores de tópico podem incluir um bloco de tópico pré-criado chamado Geolocalização em conversas com usuários. O bloco de tópico Geolocalização recupera as coordenadas de latitude e longitude do local do usuário.

Os autores de tópico podem adicionar este bloco de tópico a fluxos de conversa maiores. Com a permissão do usuário, o bloco de tópicos recupera as coordenadas de localização de latitude e longitude do usuário. Conhecer essas coordenadas pode ajudar os autores de tópicos a responder a solicitações ou problemas do cliente com mais rapidez e eficiência.

Por exemplo, você pode precisar enviar um técnico para um local do cliente para resolver um incidente. Para responder rapidamente ao cliente, você precisa saber quais técnicos estão localizados nas proximidades para que você possa enviar o técnico apropriado para o local do cliente.

Para obter informações gerais sobre como a geolocalização é usada no ServiceNowplataforma, consulte [Geolocalização](https://www.servicenow.com/docs/access?context=c_Geolocation&version=yokohama&pubname=yokohama-servicenow-platform&ft:locale=en-US).

## Compartilhar detalhes do local {#va-geolocation__id_xy1_vmw_ypb}

A primeira vez que um usuário, como um técnico de campo, usa o bloco de tópico de geolocalização em uma conversa, ele é perguntado se deseja compartilhar detalhes sobre sua localização.

{#va-geolocation__table_epl_33n_xrb__entry__2}

| Opção do usuário | Resposta do bloco de tópicos |
|-|-|
| Sim | O bloco de tópicos envia as coordenadas de latitude e longitude do usuário do servidor para o dispositivo do usuário. Se os usuários quiserem permitir o. ServiceNowpara acessar o local, os usuários podem ver prompts específicos do sistema operacional ou específicos do navegador. Os exemplos desses prompts incluem o seguinte: * (Sempre) * Permitir (somente uma vez) * Bloquear (não permitir) {#va-geolocation__ul_fry_3jn_xrb} Dependendo da resposta do usuário, ele pode ver esse prompt uma ou mais vezes ou nunca vê-lo. |
| Não | O bloco de tópico não recupera coordenadas do usuário e exibe uma mensagem de erro relevante para que o autor do tópico resolva. O erro é registrado como um parâmetro de saída. Para obter detalhes, consulte [Parâmetros de bloco de tópicos de geolocalização](https://servicenow-prod.fluidtopics.net/auOsQQoPvm3_w3ewte3CFQ#va-platform-topicblocks__geolocation-topic-block-properties). |
[Tabela 1. Fluxo de bloco de tópicos de geolocalização]

{#va-geolocation__table_epl_33n_xrb}

## Modifique o bloco de tópicos de geolocalização {#va-geolocation__section_ymx_klw_ypb}

Se você for um autor de tópico ou um administrador, poderá modificar o fluxo de bloco de tópico de geolocalização, conforme aplicável. Basta duplicar o bloco de tópicos e renomeá-lo. Você pode usá-lo conforme necessário no fluxo de conversa maior que você está criando.  
A folha de propriedades do bloco de tópicos de geolocalização permite que os autores de tópicos especifiquem os mapeamentos de entrada e saída. Você também pode personalizar o prompt usando cápsulas de dados ou scripts. Por exemplo, você pode incluir uma explicação ou motivo para fazer a pergunta. Para obter informações sobre como usar cápsulas de dados e scripts, consulte [Designer do Virtual Agent controles](https://servicenow-prod.fluidtopics.net/XLB40FlvSx0Tcu9KBduDtA "R Virtual Agento tópico consiste em uma coleção de controles em um fluxo de tópicos. Use esses controles para coletar, processar e apresentar informações para seus usuários. Os controles também podem ler, criar e atualizar registros em sua instância.").Figura 1. Compartilhar prompt de local nas propriedades do bloco de tópicos de geolocalização

Use os mapeamentos de entrada para personalizar como Virtual Agentsolicita aos usuários permissão para compartilhar sua localização. A resposta é passada para o bloco de tópicos.  
Use os mapeamentos de saída para especificar as variáveis retornadas do bloco de tópicos na conversa. Figura 2. Propriedades de mapeamento de saída no bloco de tópico Geolocalização

Todas as variáveis são selecionadas por padrão. Mantenha as opções padrão ou selecione as variáveis que você deseja retornar do bloco de tópicos. No mínimo, você deve selecionar as coordenadas de latitude e longitude. No entanto, mensagens de erro, tipo de erro e detalhes de status podem ser úteis ao resolver problemas. Os mapeamentos de saída selecionados são armazenados como variáveis no servidor.  
Figura 3. Resultados do bloco de tópicos de geolocalização

Para obter mais informações sobre as propriedades do bloco de tópicos de geolocalização, consulte [Parâmetros de bloco de tópicos de geolocalização](https://servicenow-prod.fluidtopics.net/auOsQQoPvm3_w3ewte3CFQ#va-platform-topicblocks__geolocation-topic-block-properties).