> O mapa do seu provedor: áreas de cobertura que a IA consulta, clientes e oportunidades no mapa, qualidade da localização e incidentes desenhados por região. # Conecta Maps O Conecta Maps é o mapa da sua operação. Nele você **desenha onde o provedor tem rede**, acompanha **onde estão os clientes e as oportunidades de venda** e marca **incidentes por região**. As áreas de cobertura que você publica aqui são o que a IA consulta quando alguém pergunta "vocês atendem no meu endereço?". > **Destaque.** > **Módulo adicional.** O Conecta Maps é contratado à parte do plano e ligado pela equipe da ConectaAI para a sua empresa. Se o item não aparece no seu menu, quem cuida do plano da empresa pode pedir pelo botão **Contrate agora**, no aviso do Conecta Maps que aparece ao entrar no painel. Ali aparece o valor para o seu plano; ao pedir, a equipe recebe o pedido e liga o módulo, e a cobrança começa no dia em que ele for ligado. Se preferir, fale com o [suporte](/suporte) ou com o seu contato comercial. ## Onde fica Menu **Operações → Conecta Maps**, rota `/operacoes/mapa`. Nos **30 dias** depois de o módulo ser liberado para a sua empresa, o item aparece no menu com a etiqueta **Novo** (com o grupo Operações recolhido, ela fica no grupo). Quem tem a permissão de visualizar **Áreas de cobertura** vê o mapa e a lista; desenhar, editar, arquivar e publicar exigem a permissão de **edição**. As camadas de clientes e a saúde do mapa aparecem para quem também pode ver **Contatos**. ## Aulas em vídeo Na primeira visita aparece o cartão **"Conheça o Conecta Maps"**, com aulas curtas. **Fechar** esconde só naquela visita; **Não mostrar novamente** para de abri-lo sozinho para você. O botão **Tutoriais**, ao lado do título da tela, reabre as aulas a qualquer hora. As mesmas aulas estão aqui: ## A tela O mapa ocupa o centro. A **busca** ("Cliente, CPF ou endereço") fica no canto superior esquerdo do mapa (no celular, acima dele). As ferramentas de desenho ficam no canto inferior esquerdo; o zoom e a escala, no inferior direito. **Tela cheia** abre o mapa sozinho. Ao lado do mapa, um painel com quatro abas. Trocar de aba não perde o que estava aberto nas outras: | Aba | O que tem | |-----|-----------| | **Camadas** | Clientes no mapa e oportunidades no mapa. | | **Áreas** | A lista de áreas, versões, operações entre áreas, importar arquivo, propostas e a declaração "Este mapa cobre toda a nossa operação". | | **Saúde** | Qualidade da localização dos clientes e confiança do mapa. | | **IA** | Testar um ponto, a ferramenta "Verificar cobertura", quais agentes usam o mapa e as perguntas que caíram fora ou incertas. O número ao lado de **IA** é quantas perguntas caíram fora ou incertas nos últimos 7 dias. | ### Mapa ou satélite No alto do mapa, à direita, **Mapa** e **Satélite** trocam o fundo. O satélite mostra a foto aérea (imagens da Esri), onde dá para ver casas e lotes ao desenhar ou conferir uma área. A escolha fica guardada no seu navegador. Se a imagem de satélite não carregar, o mapa volta sozinho para **Mapa** e avisa. ### Busca A busca acha, enquanto você digita, cliente (nome, número do contrato, ou CPF/CNPJ com todos os dígitos), CTO, lead, prospecção, negociação e área. Endereço e cidade buscam quando você confirma (`Enter` ou **Ir**). O botão **Filtros** escolhe o que a busca procura e filtra por status do acesso (online, offline) e situação do contrato. ## Áreas de cobertura Cada área é um polígono com **nome**, **tecnologia** (fibra, rádio ou outra), **cidade** e uma observação curta. No mapa, a cor diz a tecnologia; o rascunho aparece tracejado. ### Desenhar uma área 1. Clique em **Desenhar área**, no canto inferior esquerdo do mapa. 2. Clique no mapa em cada canto da região. **Voltar um ponto** (ou Ctrl+Z) tira o último; Esc cancela. 3. Clique no primeiro ponto, ou tecle Enter, para fechar. 4. Na janela **Nova área de cobertura**, dê o nome, a tecnologia e, se quiser, a cidade (em branco, ela vem do endereço do centro da área). Clicar fora dessa janela, ou teclar Esc, descarta o desenho. **Grudar nas bordas** vem ligado: o ponto encosta na borda de uma área vizinha quando passa perto, o que evita fresta entre bairros. Segure `Alt` (Option, no Mac) para soltar um ponto só. > **Nota.** > No celular dá para ver o mapa, buscar, testar pontos, publicar e **marcar a região de um incidente**. **Desenhar e editar áreas de cobertura ficam para o computador.** ### Editar, recortar e dividir Selecione a área (no mapa ou na lista) e abra **Editar**: - **Editar vértices**: arraste os pontos e clique em **Concluir edição**. **Desfazer** e **Refazer** valem para cada arraste. Para tirar um ponto, botão direito sobre ele. - **Recortar buraco**: tira um trecho de dentro da área, como um condomínio sem rede. - **Dividir por linha**: corta a área por um traço que começa e termina fora dela; as duas partes dividem a borda sem vão. Com uma área selecionada, o card **Operações na área** junta, subtrai ou recorta por outra área, e o card **Encaixe entre áreas** aponta sobreposições e frestas pequenas entre áreas (quem mora numa fresta ouve "não consigo confirmar"). Na lista, **Editar** troca nome, tecnologia e observação, e **Arquivar** tira a área do mapa (o aviso traz **Desfazer**; a área fica em **Arquivadas**, de onde volta). **Versões** mostra cada borda que a área já teve, com quem gravou e quando, e **Restaurar** volta uma borda antiga como versão nova. ### Rascunho e publicação > **Atenção.** > **Toda borda gravada é um rascunho.** A IA continua usando a versão **publicada** até você publicar a nova. A lista marca "Rascunho" ou "Alterada (não publicada)". **Revisar e publicar** desenha no mapa o que entra (verde) e o que sai (vermelho) do mapa da IA, com a área em km², os clientes afetados e as perguntas recentes que mudariam de resposta. **Publicar** põe a borda no ar. Nome, tecnologia, observação e cidade valem na hora, sem publicar; arquivar tira a área da IA na hora. ### Trazer um mapa que já existe **Importar arquivo** aceita **.kml**, **.kmz** (Google Earth, QGIS) e **.geojson**. Só polígonos viram área. Antes de gravar, a tela desenha a prévia no mapa e lista cada área para você renomear, escolher a tecnologia ou deixar de fora. Nada é gravado antes de clicar em **Importar**, e o que entra é rascunho. **Exportar** faz o caminho de volta, em KML ou GeoJSON: todas as áreas, as de uma cidade ou só a selecionada. Sai sempre a versão publicada. ### Propostas A **Caixa de entrada**, na aba **Áreas**, reúne propostas de área por cidade: - **Pelos bairros do IBGE**: você escolhe a cidade e marca os bairros. - **Pela rede do ERP**: toda semana o sistema propõe a cobertura em volta das suas CTOs e dos grupos de clientes. - **Pelos rótulos**: os clientes que quem atende marcou como "tem cobertura" e que caíram fora do mapa. **Abrir** mostra a área atual e a proposta lado a lado, pedaço por pedaço, com a evidência de cada um. Você aceita, rejeita ou ajusta cada pedaço e salva como rascunho ou publica. **Proposta não muda o que a IA responde** enquanto não for publicada. ## Como a IA usa o mapa Desenhar uma área não liga nada sozinho. A IA só consulta o mapa no agente que tiver a ferramenta **Verificar cobertura** marcada em [Ferramentas](/ambiente-ia/tools), e só com pelo menos uma área publicada. > **Nota.** > **A IA nunca confirma a instalação.** Com o endereço bem dentro de uma área, o cliente recebe uma mensagem fixa: está dentro da área de cobertura, e a confirmação final depende da viabilidade técnica, que o comercial confere. Perto da borda, ou com endereço impreciso, a resposta é "não consigo confirmar só por aqui" e o contato segue para o comercial. - **"Este mapa cobre toda a nossa operação"**: enquanto esta caixa, na aba **Áreas**, estiver desmarcada, a IA **nunca diz "fora da área"**: encaminha ao comercial. Marque só quando todas as cidades que vocês atendem tiverem área. Uma cidade atendida sem área passa a ouvir "fora da área". - **Endereço que não basta**: se o cliente ainda não disse onde é, ou o endereço é impreciso, a IA manda o botão **Enviar localização** (WhatsApp e Telegram) e confere o ponto no mapa. - **Ao telefone**: a ferramenta vale igual, mas a IA nunca diz "fora da área" para um endereço falado: oferece seguir pelo WhatsApp e encaminha ao comercial. - **Agente instruído a nunca confirmar cobertura**: a ferramenta fica calada nele: consulta o mapa, não diz o resultado e encaminha ao comercial. O painel **Quem usa o mapa** marca esse agente com "fica calada". - **Repasse para uma pessoa**: a nota do repasse leva a ficha de cobertura (o que o mapa disse, as áreas, a distância à borda e **Abrir no mapa**). Quando o ponto fica na borda ou logo fora dela, a conversa ganha a etiqueta **cobertura-na-borda**: é contato quente para o comercial. ### Testar um ponto Na aba **IA**, **Testar um ponto** responde o que a IA diria **hoje**, com o mapa publicado. Clique no mapa ou digite um endereço: o mapa desenha a incerteza do ponto, a margem e a distância até a borda mais próxima. Nada é gravado. > **Nota.** > Se o card da ferramenta disser **"travada"**, a liberação da resposta automática de cobertura ainda está com a equipe da ConectaAI: quem pergunta cobertura segue para o comercial. Desenhar áreas e testar pontos funcionam normalmente, e o que você declarar vale no dia da liberação. ## Clientes e oportunidades no mapa ### Clientes O card **Clientes no mapa**, na aba **Camadas**, mostra a base. Quando os clientes da parte visível do mapa cabem em 5.000, eles aparecem um a um, na posição real, já a partir do zoom 11; com mais do que isso, aparecem em círculos com a quantidade. A cor de cada cliente é o status do acesso. **Mostrar CTOs** desenha as caixas de atendimento quando o seu ERP as informa, a partir do zoom 15. ### Tecnologia do acesso A **forma** de cada cliente diz a tecnologia do acesso, lida do ERP: **círculo** é fibra, **losango** é rádio e **quadrado** cheio é outra tecnologia. Os botões de **Tecnologia**, no card, mostram quantos clientes de cada uma há na tela e escondem ou mostram cada tecnologia. É o que ajuda a desenhar a divisa entre uma região de fibra e uma de rádio. | ERP | De onde vem a tecnologia | |---|---| | ISPFY | O tipo de instalação do ponto de conexão | | Hubsoft e MK Solutions | A tecnologia do serviço | | IXC | O IXC não informa a tecnologia: o cliente com ONU ou CTO aparece como fibra, e os outros como **Sem informação** | | SGP | **Sem informação** | Quem o ERP não informa aparece como círculo, contado em **Sem informação**: o mapa não adivinha. A tecnologia aparece depois da próxima leitura de localização (uma vez por dia, ou **Atualizar localizações**). ### Passar o mouse e clicar Passar o mouse num cliente mostra o código dele no ERP e o nome ou a razão social, nunca o CPF/CNPJ. Clicar num cliente abre a ficha: contato, endereço, contratos, plano e o status do acesso, com **Atualizar agora** para pedir uma leitura nova ao ERP. O CPF/CNPJ aparece sempre mascarado; só quem pode editar assinantes vê o documento completo, e cada revelação fica na [auditoria](/configuracoes/auditoria). Da ficha você abre a conversa mais recente do cliente. Com uma área selecionada, o card conta quantos clientes estão dentro dela e com que precisão. ### Oportunidades O card **Oportunidades no mapa** mostra **leads**, **prospecções** e **negociações**, cada tipo com seu ícone. **Agrupar por proximidade** junta pontos próximos num círculo colorido pelo estágio mais avançado do grupo. > **Atenção.** > A camada de oportunidades lê o CRM do ERP e hoje funciona com o **IXC**. Com outro ERP, ou sem CRM habilitado, ela fica vazia. Isso é falta de sincronização, não falta de oportunidade. **Sincronizar agora**, no mesmo card, pede uma leitura na hora. ## Mapa de calor O **Mapa de calor** pinta o mapa por concentração: quanto mais pontos perto um do outro, mais quente a cor. Ele liga pelo botão **Mapa de calor**, sobre o mapa, ou pelo painel **Filtros** da busca; os dois mostram e mudam a mesma camada, na hora, sem recarregar a página. A **Fonte** é uma de cinco: | Fonte | O que esquenta | |---|---| | **Clientes** | A base, respeitando o status do acesso marcado em Filtros | | **Offline** | Só clientes offline | | **Leads e prospecções** | As oportunidades do CRM | | **Consultas de cobertura** | Quem ouviu "fora" ou "não sei" nos últimos 90 dias | | **Problemas** | Conversas de problema de conexão por cliente, mais os incidentes com área desenhada | A **Intensidade** tem três níveis. O calor é só visualização: nunca vira proposta de área nem muda o que a IA responde ao verificar cobertura. ### Problemas e Clientes com mais problemas Na fonte **Problemas**, escolha o **Período**: últimos 7, 30 ou 90 dias (30 é o padrão). Contam as conversas cujo assunto, classificado pela IA, é problema de conexão (sem internet, lentidão, instabilidade, suporte técnico), pela mesma régua da detecção automática de incidentes. Boleto, plano e cancelamento não contam. Cada cliente pesa pela quantidade de conversas (cinco já é o máximo), e cada incidente com área desenhada pesa no centro da área. Com essa fonte, o painel **Filtros** mostra **Clientes com mais problemas**: os 15 clientes com mais conversas de problema no período, do maior para o menor. Clicar num cliente abre a ficha dele no mapa; quem não tem ponto no mapa abre a ficha do cadastro. Embaixo da lista, a tela diz quantos dos clientes com problema têm ponto no mapa e entram no calor. > **Nota.** > **O que fica fora do calor:** cliente sem localização no mapa (depende da leitura de localização do ERP), conversa sem cadastro vinculado (também fica fora do ranking) e incidente sem área desenhada (bairro, lista ou empresa inteira). Os incidentes só entram no calor para quem pode ver Incidentes. Com o mapa afastado, o calor mostra regiões agrupadas, não clientes um a um. Abrir a lista fica registrado, por cliente, na trilha de quem viu clientes no mapa. O ranking vale para quem pode ver assinantes e áreas. ## Saúde do mapa ### Qualidade da localização O card mostra quanto da base tem **posição exata** e, por cidade, quantos clientes estão posicionados pela coordenada do ERP, só pela CTO, estimados pelo endereço ou sem posição; a cidade com mais clientes sem posição vem primeiro. A localização é lida do ERP uma vez por dia, para **IXC**, **ISPFY**, **Hubsoft**, **MK Solutions** e **SGP**. **Atualizar localizações** pede uma leitura agora. Com outro ERP, o card diz por que não há leitura. > **Nota.** > **O mapa vazio logo depois da liberação é normal.** A leitura de localização roda uma vez por dia, e a primeira vem depois de o módulo ser ligado. Para não esperar, clique em **Atualizar localizações**. ### Confiança do mapa Por cidade, **Dentro do mapa** diz quantos clientes com posição exata o mapa publicado cobre, e **Sem evidência** diz quanto do mapa não tem cliente nem CTO por perto. Desenhar o município inteiro dá 100% dentro, mas aparece aqui como área sem evidência. **Cidades com cliente e sem área** mostra onde falta desenhar. ## Incidentes pelo mapa **Desenhar área de incidente** marca a região afetada por uma queda ou manutenção; o mapa conta quantos clientes ficam dentro, e o incidente segue para [Incidentes](/operacoes/incidentes) com a resposta pronta. A IA avisa quem perguntar, e o aviso automático vai só para quem está dentro da região. **No celular**, o botão é **Marcar incidente**, no canto de baixo do mapa. Toque em cada canto da região afetada; enquanto você marca, a faixa no alto já mostra quantos clientes ficam dentro. Com três pontos ou mais, toque em **Concluir** (ou **Descartar** para recomeçar). Quando muitos acessos de uma mesma vizinhança ficam offline ao mesmo tempo, o mapa sugere uma **Zona provável de manutenção**. É sempre sugestão: **Criar incidente com esta zona** leva ao formulário com a região já desenhada, e **Dispensar** esconde a sugestão. ## Atalhos | Ação | Teclado | |------|---------| | Fechar o desenho ou concluir a edição | `Enter` | | Desfazer | `Ctrl`+`Z` (`⌘`+`Z` no Mac) | | Refazer | `Shift`+`Ctrl`+`Z` | | Cancelar o desenho ou a edição | `Esc` | | Aproximar o mapa numa página longa | `Ctrl` + rolagem | | Passar de área em área | `Tab`, e `Enter` seleciona | ## Veja também - [Incidentes](/operacoes/incidentes): o ciclo de vida do incidente e a resposta automática - [Tools](/ambiente-ia/tools): como marcar a ferramenta "Verificar cobertura" num agente - [Grupos e permissões](/configuracoes/grupos-e-permissoes): quem vê e quem edita as áreas