Este arquivo mostra como criar um grupo de locais na Inngage Context Cloud: nomear o grupo e incluir os pontos geográficos pesquisando cada um no Mapa Interativo. É o caminho manual de cadastro — a alternativa à importação por planilha.
Antes de começar
- Add-on GeoPush contratado. O menu GeoPush só aparece no painel quando o add-on está habilitado na conta.
- Critério de agrupamento definido. O grupo é a unidade que você seleciona ao criar uma geofence, então decida antes o que ele reúne: região, bandeira, tipo de ponto.
- Nome, endereço ou coordenadas dos pontos em mãos. A busca do mapa aceita as três formas.
Passos
- No painel da Context Cloud, acesse GeoPush > Locais.
- Abra a tela Criar Grupo de Localização. A Context Cloud exibe a página Novo Grupo de Locais.
- No card Informações do Grupo de Locais, preencha Nome do Grupo com um nome que identifique o agrupamento.
- Preencha Descrição com o critério que define o grupo.
- Em Tags da Mensagem, selecione as tags aplicáveis ao grupo.
- No card Visualização Geográfica, use o campo de busca do Mapa Interativo para localizar o primeiro ponto. Digite o nome do estabelecimento, o endereço ou as coordenadas.
- Clique na sugestão correspondente ao ponto desejado, ou clique em Pesquisar para executar a busca. O local é plotado no mapa com um marcador e o contador do botão Adicionar Todos aumenta em uma unidade.
- Repita a busca para cada ponto que você quer incluir no grupo. Os locais selecionados vão se acumulando no mapa.
- Clique em Adicionar Todos para transferir os locais selecionados para a lista Localizações.
Campos do grupo
O card Informações do Grupo de Locais, na tela Novo Grupo de Locais, tem três campos:
| Campo | Obrigatório | O que informar |
|---|---|---|
| Nome do Grupo | Sim | Nome que identifica o agrupamento no momento de criar uma geofence (ex.: Lojas em São Paulo) |
| Descrição | Sim | Texto livre descrevendo o critério do grupo |
| Tags da Mensagem | Não | Seleção a partir de uma lista de tags existentes |
Como pesquisar um local no Mapa Interativo
O campo de busca do Mapa Interativo consulta a base de locais do Google e aceita três formas de entrada:
| Forma de busca | Como digitar | Comportamento |
|---|---|---|
| Nome do estabelecimento | Cristo Redentor | A lista de sugestões aparece conforme você digita, com o nome na primeira linha e o endereço na segunda |
| Endereço | Av. Paulista, 1811 | Mesmo comportamento de sugestões; use o endereço quando o ponto não tem nome comercial |
| Coordenadas | -22.9519, -43.2105 — latitude e longitude separadas por vírgula | Clique em Pesquisar; a busca resolve para o local correspondente àquelas coordenadas |
Dois pontos que evitam erro de cadastro:
- Locais homônimos aparecem repetidos na lista. Use a segunda linha de cada sugestão — logradouro, bairro, cidade e estado — para distinguir a unidade correta antes de clicar.
- As coordenadas gravadas são as do local retornado, não exatamente as que você digitou. Uma busca por
-22.9519, -43.2105grava as coordenadas próprias do ponto encontrado, que podem diferir nas últimas casas decimais.
Os dois contadores do Mapa Interativo
O Mapa Interativo tem dois contadores, e eles significam coisas diferentes. Confundi-los é a causa mais comum de dúvida nessa tela:
| Elemento | O que o número indica |
|---|---|
| Adicionar Todos (N) | Quantos locais foram encontrados na busca e estão plotados no mapa, aguardando inclusão |
| Localizações (N) | Quantos locais já foram efetivamente incluídos no grupo |
Enquanto você apenas pesquisa e seleciona resultados, o local existe só como marcador no mapa: o painel Localizações continua exibindo Nenhuma localização adicionada. A inclusão só acontece no clique em Adicionar Todos, e o botão deixa de aparecer quando não há locais pendentes.
Como validar
Após clicar em Adicionar Todos, cada ponto incluído aparece no painel Localizações como um item com:
- o nome do local;
- Lat e Lng — as coordenadas do ponto;
- o endereço completo, com bairro, cidade, estado, CEP e país;
- um ícone de lixeira, para remover o local do grupo.
O contador do título Localizações deve refletir o total de pontos da lista. Se ele continuar em zero, os locais foram apenas plotados no mapa e não incluídos.
Problemas comuns
- O painel mostra "Nenhuma localização adicionada" mesmo com o marcador no mapa → a inclusão não foi confirmada → clique em Adicionar Todos para transferir os locais plotados para a lista.
- O local não aparece nas sugestões da busca → o ponto não tem cadastro na base do Google pelo nome usado → pesquise pelo endereço completo ou pelas coordenadas.
- Foi adicionada a unidade errada de uma rede → duas sugestões tinham o mesmo nome → remova o item pelo ícone de lixeira no painel Localizações e repita a busca conferindo o endereço na segunda linha da sugestão.
- Muitos pontos para cadastrar um a um → o cadastro manual não é o caminho indicado nesse volume → use a importação por planilha do módulo Locais

