Builder · Atualizado em 06/10/2026
Como usar localização no Builder
Peça a localização do contato ou envie as coordenadas de um endereço, com os limites de latitude e longitude aceitos pelo Pipe.
O Builder tem dois conteúdos de localização, com propósitos opostos: um pede a localização ao contato, o outro entrega um ponto no mapa.
Quando usar
- Enviar localização: para mostrar onde fica uma loja, um ponto de retirada ou um evento.
- Pedir localização: para saber onde o contato está, por exemplo, para indicar a unidade mais próxima.
Pré-requisitos
- Acesso de edição a um fluxo no Builder.
- Para Enviar localização, as coordenadas decimais do ponto (latitude e longitude).
- Para Pedir localização, um bloco com Entrada do usuário (veja Como pedir uma resposta no Builder) para receber a resposta.
Passo a passo: enviar um ponto no mapa
- No canvas, clique no bloco e abra a aba Conteúdo.
- Clique em + Adicionar conteúdo e escolha Enviar localização.
- No cartão, preencha Latitude, por exemplo
-23.5505. - Preencha Longitude, por exemplo
-46.6333. - Confira se o cartão não ganhou borda vermelha.
- Teste no painel e no canal.
Passo a passo: pedir a localização do contato
- No bloco, clique em + Adicionar conteúdo e escolha Pedir localização.
- No cartão, edite o campo "Texto do pedido". O Pipe sugere "Envie sua localização."
- Garanta que o bloco tenha uma Entrada do usuário configurada para Aguardar resposta.
- Opcionalmente, preencha Variável na Entrada do usuário para guardar a resposta.
- Em Condições de saída, defina o destino da conversa depois da resposta.
Campos da tela
| Cartão | Campo | Regra |
|---|---|---|
| Enviar localização | Latitude | Número entre -90 e 90 |
| Enviar localização | Longitude | Número entre -180 e 180 |
| Pedir localização | Texto do pedido | Obrigatório |
Exemplo na Loja Girassol
A Loja Girassol envia uma Imagem da fachada e, em seguida, um cartão Enviar localização com as coordenadas de uma loja fictícia. Em outro caminho do fluxo, o bloco Unidade mais próxima usa Pedir localização com o texto "Compartilhe sua localização para indicarmos a loja mais perto".
Resultado esperado
- No envio, o contato recebe um ponto de mapa no canal.
- No pedido, o contato vê o texto e responde. Quando o contato compartilha um ponto, o Pipe registra a resposta como o nome do local, se houver, ou como "latitude, longitude".
Boas práticas
- Antes de pedir a localização, explique por que precisa dela.
- Use a variável da Entrada do usuário para reaproveitar a resposta depois.
- Teste com coordenadas reais para ver se o ponto cai no lugar esperado.
Limitações
- O Pipe só valida os limites numéricos; não confere se o ponto corresponde ao endereço que você pretendia.
- Pedir localização envia somente texto: o compartilhamento depende do canal e do aplicativo do contato.
- Não há campo para nome ou endereço do ponto enviado: o cartão leva apenas latitude e longitude.
Problemas comuns
- "O campo 'latitude' é obrigatório na localização": o campo está vazio ou não é número.
- "A latitude deve estar entre -90 e 90": confira o sinal e a vírgula. Use ponto como separador decimal.
- "Pedir localização: texto obrigatório": o campo "Texto do pedido" está vazio.
- O contato respondeu em texto e o fluxo não entendeu: use uma condição de saída que trate também respostas sem ponto no mapa.
Próximos passos
Perguntas frequentes
Qual a diferença entre Pedir localização e Enviar localização?
Pedir localização manda uma pergunta ao contato. Enviar localização manda ao contato um ponto no mapa, com latitude e longitude que você informou.
Que valores de latitude e longitude são aceitos?
Latitude entre -90 e 90; longitude entre -180 e 180. Fora disso o painel recusa.
Onde encontro as coordenadas da minha loja?
Em qualquer aplicativo de mapas, ao tocar e segurar no ponto do endereço. Cole os dois números nos campos Latitude e Longitude.
O Pedir localização abre o mapa para o contato?
O Pipe envia o texto do pedido. A forma de compartilhar a localização depende do aplicativo do contato.
Esse artigo foi útil?
Obrigado pelo retorno!