SALES PITCHVoltar à página inicial

Documentação

Manual do usuário

SALES PITCH

Manual completo do usuário

Edição baseada no pacote v6 - 10 de outubro de 2026, atualizada em 6 de novembro de 2026 Plataformas: Windows, macOS e Android Base técnica: implementação atual do Sales Pitch; edição original baseada no pacote v6. Perfil do documento: manual operacional e referência do motor; descrições extraídas da implementação. Não utiliza backups, relatos de uso, métricas empíricas ou versões anteriores como evidência.

Importante: disponibilidade, velocidade e precisão de fontes externas variam. Este manual não garante que cada serviço responderá a todas as consultas ou que todas as funcionalidades tenham sido testadas em cada aparelho. Instaladores anteriores podem não conter as funções mais recentes.

Sumário

  1. Apresentação e princípios do Sales Pitch
  2. Conhecendo as telas
  3. Primeiros passos, aceite da política e manual interno
  4. Encontrar compradores - Eu vendo
  5. Encontrar fornecedores - Procura-se
  6. Localização: raio, bairro, cidade, estado e país
  7. Pesquisa rápida e pesquisas territoriais extensas
  8. Acompanhamento, pausa, cancelamento e erros
  9. Resultados, filtros, seleção e mapa
  10. Perfil de empresa, contatos e pontuações
  • 10.4. Consultar avaliações públicas
  1. Localizador de decisores
  2. Agenda e atualização de empresas salvas
  3. Histórico de pesquisas
  4. Exportação de resultados e backups
  5. Configurações e regras personalizadas
  6. Dicionários, categorias e inferências automáticas
  • 16.6. Aprendizagem simbólica (Meta-PGT)
  1. Dados, fontes externas e privacidade
  2. Limitações e boas práticas de prospecção
  3. Solução de problemas
  4. Glossário e referência das funcionalidades
  5. Política de Uso Responsável incluída na v6

1. Apresentação e princípios do Sales Pitch

O Sales Pitch é um aplicativo local de descoberta e prospecção comercial B2B. Sua proposta é ajudar a localizar empresas, avaliar possíveis relações entre oferta e demanda, reunir contatos públicos e organizar oportunidades de negócio em uma agenda. O aplicativo utiliza categorias e regras de correspondência para orientar a pesquisa empresarial.

O programa possui dois modos complementares: Eu vendo, para descobrir empresas que possivelmente precisam dos produtos ou serviços oferecidos; e Procura-se, para localizar empresas que potencialmente podem fornecer aquilo de que o usuário necessita. Um resultado indica compatibilidade estimada, e não intenção comprovada de compra ou disponibilidade contratual.

O núcleo utiliza dicionários, categorias do OpenStreetMap (OSM), regras e inferências determinísticas. Não utiliza IA generativa nem aprendizado de máquina para calcular as relações comerciais. O motor pode receber novas regras, ampliar termos por atualização e inferir relações secundárias, mas não aprende automaticamente com o sucesso ou fracasso de negociações.

A interface é compartilhada entre as versões instaladas: Electron no Windows e macOS; Capacitor/WebView no Android. Este manual cobre os caminhos instalados de Electron e Capacitor presentes no pacote. A existência de componentes de desenvolvimento web não comprova uma distribuição web pública.

O que o Sales Pitch oferece

  • Localização de possíveis compradores e fornecedores em uma região escolhida.
  • Avaliação da compatibilidade comercial e da qualidade das evidências de contato.
  • Enriquecimento com fontes públicas e análise de páginas empresariais acessíveis.
  • Pesquisa opcional de possíveis decisores, com justificativas e níveis de confiança.
  • Mapas, filtros, Agenda, Histórico e exportação de resultados.
  • Backup local, regras personalizadas e atualização periódica do catálogo comercial.

O que ele não promete

O Sales Pitch não é uma lista completa de todas as empresas de uma região, não assegura a exatidão de cada dado cadastral e não verifica se uma organização está efetivamente comprando. Também não substitui a confirmação humana da identidade de contatos, a qualificação comercial e as obrigações jurídicas de quem utiliza informações pessoais.

2. Conhecendo as telas

A navegação principal possui nove entradas. Em telas largas, aparece na barra lateral; em telas compactas, a navegação é reorganizada na parte superior.

TelaFinalidade
HomeApresentação dos dois modos e atalhos para Agenda, Resultados recentes e Mapa.
Eu vendoInformar sua oferta e encontrar possíveis compradores.
Procura-seInformar sua necessidade e encontrar possíveis fornecedores.
ResultadosAcompanhar a busca, filtrar, selecionar, visualizar no mapa e exportar.
AgendaConsultar e organizar empresas salvas, favoritos, listas e categorias comerciais.
MapaExibir no mapa empresas da pesquisa atual ou da Agenda.
HistóricoRevisitar pesquisas anteriores e suas contagens registradas.
ManualLer capítulos e pesquisar trechos por palavras.
ConfiguraçõesAjustar o mecanismo, consultar categorias, editar regras e gerir backups.

No perfil individual de uma empresa, acessado a partir dos resultados ou da Agenda, ficam disponíveis os detalhes cadastrais, fontes, pontuações, contatos, pesquisa de decisores e organização comercial.

3. Primeiros passos, aceite da política e manual interno

3.1. Primeira abertura e aceite

Antes de liberar as telas, o aplicativo verifica se existe aceite da versão atual da Política de Uso Responsável. Na v6, a política é a versão 1.0. Role o texto até o final e acione Li e concordo com a política de uso. O registro contém versão e data/hora no armazenamento local do dispositivo. Se esse armazenamento for apagado ou a versão da política mudar, o aceite será solicitado novamente. O código não comprova leitura efetiva: verifica o fim da rolagem.

3.2. Manual dentro do aplicativo

Abra Manual na navegação. Os capítulos permitem saltar para uma seção. A pesquisa ignora diferenças de maiúsculas e acentos e usa palavras com mais de um caractere; todas devem aparecer no título ou corpo da mesma seção. Mostra até 30 trechos, priorizando correspondências no título. Clique no trecho para ir à seção; o botão de limpar retorna à navegação por capítulos.

O arquivo de ajuda incluído no pacote v6 ainda identifica sua própria edição como v4. Este documento revisa a descrição a partir da implementação v6; não altera o executável nem o arquivo de ajuda do aplicativo instalado.

3.3. Pesquisa em seis etapas

  1. Abra Eu vendo ou Procura-se, conforme a finalidade.
  2. Digite o produto ou serviço em termos claros. Para vários termos, separe-os por vírgulas: CNC, corte a laser, usinagem.
  3. Escolha estado e cidade quando aplicáveis. Selecione cidade inteira, raio, estado inteiro ou país inteiro (a pesquisa por país existe somente no Windows e no Mac).
  4. Confira as categorias comerciais relacionadas sugeridas pelo dicionário. Ative Pesquisa rápida se desejar priorizar até dez candidatos.
  5. Clique em Encontrar compradores ou Encontrar fornecedores. A tela de Resultados mostra o andamento e atualiza informações progressivamente.
  6. Abra os perfis, confira evidências e contatos, salve oportunidades na Agenda e exporte o conjunto desejado.

Sugestão de uso: comece com uma necessidade específica e uma região limitada. Amplie a área e os termos apenas quando os resultados iniciais forem insuficientes.

4. Encontrar compradores - Eu vendo

Em Eu vendo, informe o que sua empresa oferece. O Sales Pitch associa os termos digitados a atividades que, segundo as regras comerciais, podem consumir ou contratar essa oferta.

Exemplo: uma empresa que presta serviços de CNC pode pesquisar CNC e encontrar categorias industriais ou de marcenaria consideradas comercialmente relacionadas. Isso não significa que todos os estabelecimentos encontrados tenham uma demanda atual.

O painel à direita do formulário apresenta, quando houver correspondência:

  • Relação direta (+30): uma categoria ligada diretamente à oferta pelo dicionário.
  • Relação secundária (+15): uma compatibilidade mais fraca, inclusive estimada quando aplicável.
  • Sem relação no dicionário: indica que determinado termo não pôde ser associado a regras disponíveis; o usuário pode criar uma regra em Configurações.

O painel é uma prévia de categorias a consultar, não uma lista garantida de empresas encontradas. O motor usa um conjunto limitado de regras para compor a consulta real.

5. Encontrar fornecedores - Procura-se

Em Procura-se, informe o produto ou serviço que deseja obter. O programa busca possíveis empresas fornecedoras, prestadores ou distribuidores de categorias compatíveis.

Exemplo: embalagens personalizadas, caixas kraft pode conduzir a gráficas e fornecedores relacionados, conforme os dados e as regras existentes.

Além das relações do dicionário, o modo Procura-se dispõe de correspondência por nome e descrição da empresa para ajudar quando uma expressão não está cadastrada. Esse recurso não substitui a verificação do portfólio comercial de cada empresa.

As mesmas opções territoriais, filtros, Agenda, exportação e pesquisa individual de decisores podem ser utilizadas nos dois modos. O contexto da pesquisa de decisores é adaptado: comprador para Eu vendo e fornecedor para Procura-se.

6. Localização: raio, bairro, cidade, estado e país

Este capítulo é essencial para entender a abrangência real da pesquisa. O controle de raio só interfere na opção “Pesquisar em um raio”. Nas outras três modalidades ele fica desativado e não determina a região pesquisada.

ModalidadeComo o aplicativo delimita a pesquisa
Pesquisar em um raioUtiliza um ponto central e uma distância de 1 a 50 km em linha reta.
Pesquisar nesta cidadeUtiliza os limites administrativos geográficos resolvidos para a cidade; quando necessários, usa aproximações territoriais obtidas do serviço de geocodificação.
Pesquisar no estado inteiroDivide o território resolvido em regiões de consulta, respeitando os limites operacionais.
Pesquisar no país inteiro (Windows e Mac)Divide o país em blocos geográficos, como no estado, e para ao atingir o máximo de resultados.

6.1. Localização manual: centro geográfico estimado do bairro

Quando o usuário digita manualmente um bairro e escolhe “Pesquisar em um raio”, o Sales Pitch toma como referência o ponto central geográfico estimado desse bairro, devolvido pelo serviço de geocodificação. O raio é calculado a partir dessa coordenada de referência - não a partir da posição real ou do endereço particular do usuário.

Esse ponto é uma estimativa geográfica representativa: não deve ser confundido com o centro geométrico matematicamente exato do perímetro administrativo do bairro. Sua precisão depende do cadastro geográfico e da resposta do serviço externo.

Exemplo prático: se o usuário informar manualmente Tatuapé, São Paulo, Brasil e selecionar 10 km, o sistema procurará estabelecimentos a até aproximadamente 10 km em linha reta do ponto central estimado para o Tatuapé. A pesquisa pode incluir outros bairros ou municípios dentro desse raio.

Caso não seja possível resolver a localização, confira a escrita de bairro, cidade, estado e país. Em situações de ambiguidade, especifique melhor o local ou escolha uma modalidade territorial mais adequada.

6.2. Localização automática no Windows e no macOS

A versão desktop pode sugerir localização aproximada por endereço IP, por meio de serviços externos de geolocalização. Quando o usuário escolhe usar essa posição, o aplicativo seleciona a pesquisa por raio e utiliza as coordenadas aproximadas retornadas.

A localização por IP pode apontar para outra área da cidade, município vizinho ou ponto associado ao provedor de acesso. Ela não equivale a GPS e não garante identificação do bairro. O usuário pode rejeitar a sugestão ou informar uma localização manualmente.

6.3. Localização automática no Android

No Android, Usar minha localização solicita uma leitura pontual dos serviços de localização do aparelho, mediante permissão. Havendo coordenadas válidas, o programa passa a usá-las como centro da pesquisa por raio. O preenchimento textual de cidade, estado e bairro pode ser complementado por geocodificação reversa.

O fluxo examinado não acompanha a posição continuamente em segundo plano. Se a localização do dispositivo falhar, estiver desativada ou não for autorizada, o usuário poderá informar o local manualmente. Na versão nativa Android, a detecção automática por IP não é o método configurado para essa tela.

6.4. Raio em linha reta e limites de precisão

O sistema calcula a distância geográfica entre coordenadas, não a distância por estradas, tempo de deslocamento ou trajeto de entrega. Por isso, uma empresa a 8 km em linha reta pode estar muito mais distante por vias urbanas.

Na modalidade de raio, o programa monta uma região retangular em volta do centro e a divide em pedaços menores, como já faz a busca por cidade. Cada pedaço é consultado separadamente, o que evita que uma consulta única muito grande seja cortada pelo servidor ou pela rede do celular (principalmente no 4G). Depois, descarta localmente os estabelecimentos além da distância definida. O círculo, o corte pela distância e a ordem por proximidade continuam iguais. Já as buscas por cidade, estado e país usam limites territoriais e subdivisões, sem reaproveitar indevidamente o centro do IP ou GPS como substituto do território administrativo.

6.4.1. Segunda tentativa automática pelo centro da cidade

Quando a pesquisa usa a localização automática (GPS no Android ou IP no Windows/Mac) e termina com erro sem encontrar nenhuma empresa, o aplicativo tenta de novo sozinho pelo centro da cidade identificada — o mesmo caminho da localização digitada. A tela mostra “Tentando de novo pelo centro da cidade…”. A distância de cada empresa continua sendo medida a partir da posição original do usuário.

6.5. Rotas até a empresa (exclusivo do Android)

Esta função existe somente na versão Android. As versões Windows e Mac não mostram rotas; nelas aparece apenas a distância em linha reta.

No Android, o perfil de cada empresa traz a caixa Rota até a empresa. A rota nunca é calculada automaticamente — nem na lista de resultados, nem nas 10 melhores. Ela só é consultada quando o usuário toca em Calcular rota da minha localização.

  • Ponto de partida: no Android, a rota é sempre calculada da posição atual do usuário até o local. Ao tocar no botão, o app aciona o GPS momentaneamente (uma única leitura, sem acompanhamento em segundo plano). Isso vale em todos os tipos de pesquisa — cidade, raio ou estado. Se a localização do aparelho estiver desligada, o app avisa e não calcula a rota.
  • Resultado: distância real por vias (km) e tempo estimado de carro, com o trajeto desenhado no mapa entre o marcador de início e a empresa.
  • Atalhos: botões Google Maps e Waze abrem o trajeto no aplicativo de navegação.
  • Fonte: serviço público de rotas do OpenStreetMap (OSRM). Se ele não responder, a distância em linha reta continua disponível.

Na tela de resultados, a opção Mais próximos primeiro ordena os leads da menor para a maior distância em linha reta, em todas as versões.

6.6. Pesquisa por país (exclusiva do Windows e do macOS)

Esta modalidade existe somente nas versões Windows e macOS. A versão Android não oferece a pesquisa por país: nela, as opções são raio, cidade e estado.

Ao selecionar Pesquisar no país inteiro, o aplicativo divide o território nacional resolvido em blocos geográficos de cerca de 1.500 km², como na pesquisa por estado, e percorre esses blocos com os mesmos limites de candidatos e de regras por consulta usados nas pesquisas por cidade e estado. As bordas do país são conferidas localmente, no próprio computador. O controle de raio permanece desativado nessa modalidade.

A abrangência nacional aumenta muito o tempo de execução e, assim como nas pesquisas por cidade e estado, não equivale a um levantamento completo de todas as empresas do país: depende do cadastro do OpenStreetMap, dos limites operacionais do motor e da resposta dos servidores consultados. Para a prospecção do dia a dia, raio, cidade ou estado costumam ser mais rápidos; reserve a pesquisa por país para levantamentos exploratórios amplos, feitos no computador.

7. Pesquisa rápida e pesquisas territoriais extensas

7.1. Pesquisa rápida: Top 10

A opção Pesquisa rápida seleciona até dez candidatos quando o conjunto obtido tem mais de dez itens. Prioriza os aprovados no rigor vigente. Para completar vagas, pode incluir candidatos ainda não aprovados, mas aceitos no modo Flexível, sem contradições e com site pendente de análise; esse site pode fornecer evidências adicionais. A tela continua aplicando o filtro de rigor, portanto pode exibir menos de dez empresas.

A seleção antecede a análise dos sites; não há uma nova seleção global automática para preencher vagas após o enriquecimento. Quando a aquisição retorna dez ou menos candidatos, o corte Top 10 não é aplicado, mas os filtros de exibição continuam válidos.

Os “dez melhores” são os dez melhor classificados entre os candidatos efetivamente obtidos naquela consulta. Não há garantia de que representem as dez melhores empresas de todo o mercado ou território.

7.2. Cidade, estado e país

Nas pesquisas territoriais extensas, o motor pode dividir a área em blocos geográficos; blocos problemáticos podem ser novamente subdivididos. O algoritmo controla o número de candidatos, mantém resultados parciais e evita repetir regiões já processadas dentro da mesma execução.

No código, a malha inicial se ajusta à área da região: cidades menores usam poucos blocos e territórios extensos (estados e países) são divididos em blocos de cerca de 1.500 km² (a grade pode passar de 100 blocos em estados grandes). Blocos podem ser subdivididos em quatro até três níveis. Há até duas tarefas de blocos simultâneas, e cada tarefa pode acionar os servidores alternativos. O orçamento territorial é de 60 elementos na pesquisa rápida; na normal, é o maior entre máximo configurado + 50 e 1,5 vezes esse máximo arredondado. O orçamento é condição de parada, não cota exata de empresas aprovadas. Consultas territoriais idênticas podem ser reutilizadas por dez minutos na mesma sessão.

A divisão territorial auxilia a lidar com limitações práticas dos servidores, mas não transforma uma pesquisa estadual ou nacional em levantamento completo de todas as empresas do território pesquisado. O próprio código utiliza limites de candidatos e de regras por consulta. Regiões populosas podem exigir mais tempo.

Recomendação: para prospecção do dia a dia, prefira raio ou cidade. Use estado quando a análise exploratória justificar maior duração e cobertura limitada. A pesquisa por país, disponível apenas no Windows e no Mac, exige ainda mais tempo e segue os mesmos limites.

8. Acompanhamento, pausa, cancelamento e erros

Após iniciar uma pesquisa, a tela Resultados informa as etapas e apresenta indicadores como empresas encontradas, empresas analisadas, sites encontrados, sites analisados, telefones, WhatsApps, e-mails, resultados compatíveis e erros. Quando disponível, também mostra o servidor Overpass utilizado e seu tempo de resposta. O indicador “compatíveis” do progresso conta Match Score de pelo menos 30; ele não equivale ao total aprovado pelo rigor e demais filtros da tabela.

Há três controles importantes:

  • Pausar: suspende o início de novas etapas de trabalho; atividades já em andamento podem terminar.
  • Continuar: retoma uma pesquisa anteriormente pausada.
  • Cancelar: interrompe o processamento. Resultados já apresentados e armazenados podem permanecer disponíveis, inclusive pelo Histórico.

O programa utiliza múltiplos endpoints do Overpass, com tentativas alternativas e mensagens de falha por servidor. Se um servidor estiver lento, o programa poderá tentar outro. Ainda assim, interrupções na rede ou indisponibilidade generalizada podem levar a uma pesquisa incompleta ou sem resultados.

As mensagens de “Ver erros” servem para distinguir problemas de consulta territorial, análise de sites e bloqueios dos próprios sites. Um erro ao analisar uma página empresarial não significa necessariamente que a empresa deixou de ser localizada no OSM. No Android, quando a consulta falha, a mensagem mostra o motivo real depois de “nativo:”.

São usados cinco servidores do mapa: overpass.private.coffee, overpass-api.de e overpass.kumi.systems como prioritários, e lz4 e z.overpass-api.de como reserva. Os reservas entram depois de 20 segundos sem resposta ou quando os prioritários falham.

8.1. Aviso de fim de pesquisa e segundo plano

Ao terminar uma pesquisa, o aplicativo toca um “ding” de máquina de escrever, criado pelo próprio programa (não depende de arquivo nem de internet).

  • Windows e Mac: a pesquisa continua com o aplicativo minimizado. No fim aparece um aviso do sistema com o número de empresas, telefones e e-mails encontrados.
  • Android: o ding toca no fim da pesquisa com o aplicativo aberto na tela. Se você sair do aplicativo, o Android pode pausar a pesquisa, que continua quando você voltar. Não há aviso na barra de notificações.

9. Resultados, filtros, seleção e mapa

A tabela de Resultados reúne empresas encontradas e suas informações resumidas. As colunas incluem nome, categoria, cidade, distância (quando aplicável), pontuações, telefones, WhatsApp, e-mail, site, fontes e data da última verificação.

9.0. Rigor da relevância

O seletor Rigor na tela Resultados oferece três modos. O padrão efetivo, quando nenhuma escolha foi salva, é Equilibrado. A escolha é persistida nas configurações e também influencia a prioridade de cortes de candidatos nas pesquisas seguintes.

ModoProcura-se: possíveis fornecedoresEu vendo: possíveis compradores
FlexívelAceita algum nível de evidência, desde que não haja contradição ou exclusão reconhecida.Aceita necessidade inferida ou conceito satisfeito, sem contradição.
EquilibradoExige atividade evidenciada ou regra primária; associação somente inferida sem atividade confirmada não basta.Aceita necessidade específica, operacional ou ampla; rejeita a fraca.
RigorosoExige evidência da atividade e ausência de conceitos obrigatórios faltantes ou contradições.Exige ausência de conceitos obrigatórios faltantes e necessidade específica; a operacional também exige regra primária.

Mudar o rigor refiltra os candidatos que continuam armazenados; não inicia outra consulta nem apaga empresas escondidas. Candidatos descartados anteriormente por limites da aquisição não são recuperados só por trocar esse seletor. Se nada passar, a tela oferece Ampliar para Equilibrado ou Ampliar para Flexível. Um telefone disponível não torna uma empresa mais relevante.

9.1. Filtros disponíveis

FiltroO que permite
RigorAplicar os critérios Flexível, Equilibrado ou Rigoroso.
Match mín.Exibir somente empresas acima de uma pontuação mínima de compatibilidade.
Confiança mín.Definir uma pontuação mínima para a confiança dos contatos.
Distância máx. kmLimitar por distância quando houver dado geográfico.
Cidade / Estado / CategoriaFiltrar por texto cadastral ou atividade.
Com algum contatoExibir empresas com telefone, WhatsApp ou e-mail.
Telefone / WhatsApp / E-mail / SiteExigir a presença dos respectivos canais.
Contato verificadoExigir ao menos um contato que apareça em mais de uma fonte.

Os filtros não alteram os dados da pesquisa original; apenas controlam o subconjunto mostrado. O indicador de contagem exibe quantos itens passaram pelos critérios em relação ao total disponível.

9.2. Selecionar, abrir e exportar

Marque empresas individualmente, ou selecione o conjunto filtrado, para exportar somente as desejadas. Clique no nome de uma empresa para abrir seu perfil. A opção Exportar oferece os formatos CSV, XLSX e JSON, tanto para resultados filtrados quanto para empresas selecionadas.

9.3. Uso do mapa

O mapa Leaflet usa cartografia do OpenStreetMap. A visualização pode ser ocultada na tela de resultados. Ao selecionar uma empresa na tabela ou no mapa, a interface procura destacar a mesma empresa no outro componente.

A tela independente Mapa permite alternar entre os resultados da pesquisa atual e as empresas da Agenda. A precisão dos marcadores depende das coordenadas existentes nas fontes consultadas.

10. Perfil de empresa, contatos e pontuações

O perfil empresarial reúne dados cadastrais, categoria/subcategoria, endereço, coordenadas, distância, identificação no OSM, datas de descoberta/verificação, contatos públicos, evidências, divergências e histórico das páginas analisadas.

10.1. Match Score

O Match Score (0-100) estima a compatibilidade comercial entre a empresa e os termos pesquisados. O código considera sinais como categoria diretamente relacionada, categoria secundária, termos encontrados no site, nome/descrição compatíveis, indicadores de atuação B2B e páginas comerciais. A pontuação é limitada a 100.

10.1.1. Componentes do Match Score

SinalPontos
Alguma regra primária identificada+30
Somente regra secundária identificada+15
Algum termo identificado no site+20
Procura-se: termo compatível no nome/descrição/produto+20
Eu vendo: duas ou mais categorias primárias distintas+20
Indicador B2B no site+10
Página comercial identificada+5
Contradição ou exclusão reconhecida-30
Procura-se: conceitos obrigatórios não evidenciados-10 por conceito, até -20
Procura-se: somente relação inferida sem atividade evidenciada-15

A avaliação de compradores adiciona +10 para necessidade específica, +5 para operacional sem condição faltante, -5 para operacional com condição não confirmada ou para necessidade ampla, e -15 para fraca. O resultado fica entre zero e 100. Relação contextual/indireta sem conceito satisfeito é limitada a 59; necessidade fraca, a 39. Os componentes aparecem em Por que este resultado apareceu? no perfil.

10.1.2. Interpretação contextual

A implementação normaliza maiúsculas e acentos, reduz palavras a radicais e utiliza grupos finitos de equivalência. Distingue equivalência, hierarquia e relação contextual: por exemplo, pizzaria pode evidenciar alimentação, mas alimentação genérica não comprova pizzaria; associação entre buffet e restaurante é contextual, não equivalência.

No interpretador, o primeiro conceito útil é tratado como atividade/produto; conceitos seguintes são qualificadores e, após para/pra, são marcados como público ou contexto de uso. Palavras genéricas de papel empresarial, como fabricante e fornecedor, são ignoradas nessa etapa. Em Procura-se, todos os conceitos interpretados são obrigatórios no modo Rigoroso; em Eu vendo, o produto oferecido não precisa aparecer na empresa compradora, mas conceitos de público após para/pra precisam ser evidenciados nesse modo.

Há suporte interno a exclusões com -palavra, sem, exceto e menos. As expressões de exclusão são limitadas e reconhecidas a partir das evidências disponíveis. A separação de termos por vírgula acontece antes dessa avaliação; cada termo é interpretado e conceitos faltantes podem se acumular. Não há compreensão irrestrita de linguagem natural nem garantia de que palavras negativas não influenciem a montagem inicial das regras de consulta.

As evidências vêm de etiquetas OSM selecionadas, nome da empresa e termos registrados pela análise de site. O código inclui conflitos específicos, como oficina de carros sem indício de motos e clínica humana sem indício de veterinária. Uma evidência positiva prevista nas regras pode desfazer o conflito. A ausência de evidência pode significar cadastro incompleto, não ausência real do serviço.

Para compradores, a necessidade recebe força específica, operacional, ampla ou fraca, com confiança estimada Alta, Moderada, Baixa ou Insuficiente. A tabela de relações inclui, por exemplo, farinha para padarias/pizzarias/confeitarias e lavanderia para hotéis/hospitais; regras do dicionário e catálogo complementam essa análise. A explicação identifica a origem e eventual condição de uso não confirmada. Esses nomes são categorias heurísticas, não probabilidades medidas.

10.2. Contact Confidence

O Contact Confidence (0-100) estima a confiabilidade dos canais de contato da empresa, considerando em quais fontes aparecem e se existem confirmações cruzadas. Sinais utilizados incluem contato em site oficial, OSM, cadastro empresarial, Wikidata, coincidência entre fontes e atividade da página.

Atenção: Match Score e Contact Confidence não são probabilidades estatísticas de acerto. Uma nota alta não garante interesse de compra, qualidade de fornecedor, atualidade de telefone ou intenção de resposta.

A pontuação agregada soma contato no site (+50), CNPJ (+40), OSM (+25), Wikidata (+15), confirmação em fontes distintas (+25 para telefone/WhatsApp ou +20 para outro contato) e página ativa (+5), até 100. A confiança individual usa a fonte mais forte: site 80, CNPJ 85, OSM 60 e Wikidata 70; múltiplas fontes elevam o contato a 95. Não equivale a validar que o canal está atualmente funcionando.

10.3. Origem e divergência dos contatos

O aplicativo identifica a origem dos contatos, quando disponível, com fontes como OSM, site oficial, cadastro empresarial e Wikidata. Telefones ou e-mails diferentes em fontes diferentes podem aparecer como informações divergentes.

O usuário deve comparar as evidências e confirmar o canal antes de uma ação comercial importante. A ausência de e-mail ou telefone significa apenas que não foi identificado pelas fontes consultadas naquela pesquisa.

10.4. Consultar avaliações públicas

No perfil de cada empresa há o bloco Consultar avaliações públicas, com um botão para o Yelp. O site abre com o nome e a cidade da empresa já preenchidos — você não precisa digitar nada. No Android e no computador, a página abre no navegador do aparelho; na versão web, em nova aba.

O Sales Pitch apenas abre a pesquisa: ele não lê, não copia e não importa as avaliações desses sites. Confira se o endereço exibido corresponde ao mesmo estabelecimento, pois empresas com nomes parecidos ou filiais diferentes podem aparecer juntas.

11. Localizador de decisores

O Localizador de Decisores é um recurso opcional por empresa. Ele não é executado automaticamente durante toda busca comercial; o usuário precisa abrir um perfil e acionar Encontrar decisor.

O mecanismo combina, conforme a disponibilidade, informações empresariais públicas, quadro de sócios e administradores obtido de fontes cadastrais, páginas institucionais e resultados de buscadores. Ele procura pessoas potencialmente relevantes para compras ou negociações de fornecimento, conforme o modo da pesquisa.

11.1. Como usar

  1. Abra o perfil de uma empresa.
  2. Localize o bloco Localizador de Decisores.
  3. Clique em Encontrar decisor e acompanhe as mensagens de andamento.
  4. Confira nome, cargo, pontuação, LinkedIn público e as evidências sob Por que esta pessoa?.
  5. Se desejar uma nova pesquisa, use Refazer do zero e confirme a ação.

Quando existe um resultado anterior, o aplicativo pode preservar informações úteis no armazenamento mesmo que uma nova tentativa não encontre elementos adicionais. Por isso, compare sempre a data da busca e as evidências mostradas.

11.2. Como interpretar a confiança

Score da pessoaLegenda do aplicativoInterpretação recomendada
80-100Alta confiançaForte candidato, ainda sujeito à confirmação humana.
60-79ProvávelHá indícios relevantes; confirme vínculo e autoridade.
40-59PossívelUtilize como pista profissional.
0-39InsuficienteNão trate como decisor confirmado.

Pessoas com pontuação inferior a 40 podem aparecer na área de outros contatos encontrados (vínculo não confirmado) quando há dados públicos associados. Isso não representa confirmação de trabalho na empresa.

11.3. Contatos empresariais versus contatos pessoais

O telefone cadastral obtido da Receita Federal é apresentado como contato oficial da empresa, não como telefone pessoal automaticamente atribuído a um decisor. Os perfis públicos do LinkedIn identificam pessoas, mas também exigem verificação de vínculo profissional.

Quando um endereço eletrônico ou telefone aparece diretamente publicado em fonte profissional, o sistema poderá mostrá-lo conforme a implementação. O mecanismo não inventa e-mails nem números por combinação de nome e domínio.

11.4. Execução e limites de consulta

As buscas de decisores são enfileiradas, uma empresa por vez. Com sócios cadastrais encontrados, o código limita a etapa adicional a uma consulta prevista; sem eles, a até três consultas previstas. Pode haver tentativas em provedores alternativos e uma etapa separada para descobrir CNPJ. O resultado é reduzido aos cinco candidatos com maior score.

A lista de provedores tem ordem fixa: DuckDuckGo HTML, DuckDuckGo Lite, Mojeek e Brave Search. Uma consulta bem-sucedida encerra as tentativas daquele termo; não há alternância obrigatória de provedor após cada sucesso. Provedor que sinaliza bloqueio fica suspenso por dez minutos na sessão. O intervalo mínimo é por domínio nos caminhos que utilizam o limitador, não uma promessa de pausa única global entre todas as APIs.

11.5. Fontes e limitações

O código utiliza pesquisas HTML públicas com provedores como DuckDuckGo HTML, DuckDuckGo Lite, Mojeek e Brave como opção de reserva, com intervalo mínimo de requisições por domínio e tratamento de bloqueios. A disponibilidade dessas fontes pode mudar sem aviso. Não há acesso autenticado a perfis privados do LinkedIn. Os perfis são identificados pelos resultados públicos dos buscadores; não há API oficial do LinkedIn implementada neste fluxo.

A pesquisa pode resultar em Decisor não identificado com confiança suficiente ou em bloqueio temporário das consultas. Isso não significa que a empresa não tenha um decisor, apenas que o método não conseguiu estabelecer evidências adequadas.

12. Agenda e atualização de empresas salvas

A Agenda é a carteira local de empresas escolhidas pelo usuário. Ela é diferente da tela Resultados, que pode conter dezenas ou centenas de candidatos ainda não qualificados.

12.1. Como organizar

Ao salvar uma empresa, o aplicativo registra seus dados disponíveis e atribui inicialmente um tipo coerente com a pesquisa: Potencial cliente ou Fornecedor. No perfil salvo, o usuário poderá:

  • Alterar o tipo comercial (por exemplo: Fabricante, Distribuidor, Prestador de serviço, Parceiro ou Cliente atual).
  • Marcar como Favorito.
  • Criar ou adicionar tags e listas.
  • Escrever anotações.
  • Definir um dos contatos disponíveis como contato principal.
  • Remover a empresa da Agenda quando não for mais necessária.

Na tela da Agenda, há busca por nome, contato, cidade, categoria, nota e outros campos; filtros por favoritos, tipo e lista; e exportação de grupos selecionados.

12.2. Verificar novamente

Para atualizar uma empresa já salva, abra seu perfil e use Verificar novamente. O aplicativo consulta o registro e, quando possível, o site. Em seguida, apresenta uma comparação entre informações anteriores e novas.

Para contatos novos, o usuário escolhe entre Adicionar novo contato, Substituir ou Manter anterior. A atualização evita substituir automaticamente todos os dados locais sem decisão do usuário.

Importante: remover uma empresa da Agenda não elimina necessariamente o mesmo registro guardado em resultados anteriores ou em backups/exportações. Para excluir definitivamente dados locais, considere o histórico e as cópias externas.

13. Histórico de pesquisas

A tela Histórico registra os termos buscados, modo, localização, abrangência, data, quantidades de empresas e contatos, resultados salvos e eventuais erros. O botão Ver resultados reabre os resultados preservados daquela execução.

Os registros de uma busca interrompida ou cancelada podem permanecer no Histórico com os dados parciais já gravados. Uma consulta antiga não é automaticamente atualizada; para informação recente, execute nova pesquisa ou revalide uma empresa salva. Registros antigos sem avaliação de relevância passam pelo filtro de rigor por compatibilidade; isso não equivale a validar suas evidências com as regras novas.

O armazenamento tende a crescer conforme o usuário acumula pesquisas e evidências. A limpeza manual e os backups devem ser planejados de acordo com a necessidade comercial e as obrigações legais de conservação.

14. Exportação de resultados e backups

14.1. Exportar resultados

Na tela Resultados ou Agenda, clique em Exportar e escolha o grupo e o formato desejado:

FormatoUtilização
CSVTabela simples; no código, usa ponto e vírgula como separador e codificação UTF-8 com BOM.
XLSXPlanilha compatível com Excel, gerada localmente pela biblioteca SheetJS.
JSONEstrutura completa dos objetos exportados, útil para conferência e integração técnica.

Quando houver informações de decisores, a exportação tabular pode incluir nome, cargo, LinkedIn, dados profissionais publicados, pontuação e fontes do primeiro candidato com score de pelo menos 40. Não exporta todos os candidatos em colunas separadas. O contato cadastral da empresa permanece separado do candidato no módulo de decisores.

A exportação de resultados/Agenda não é a mesma coisa que backup completo. A primeira é destinada a trabalhar com subconjuntos de empresas; a segunda preserva o estado local da aplicação.

14.2. Onde os arquivos são salvos?

Windows e macOS: o arquivo é gerado pelo mecanismo de download do aplicativo; o local efetivo depende do comportamento de gravação e das configurações do ambiente.

Android: o aplicativo tenta salvar os arquivos em Documentos/SalesPitch/, organizados em subpastas como Eu Vendo, Procura-se e Backup. Caso a gravação nesse destino falhe, existe um caminho alternativo no armazenamento associado ao aplicativo. Observe a notificação com a localização efetiva.

14.3. Gerar um backup completo

Abra Configurações > Backup > Exportar backup. O Sales Pitch cria um arquivo chamado de forma semelhante a sales-pitch-backup-AAAA-MM-DD.json.

O backup inclui, conforme os dados existentes, empresas da Agenda, histórico, resultados salvos, listas, configurações e regras personalizadas. O formato atual é JSON legível, sem compactação nem criptografia própria.

Não compartilhe backups publicamente: eles podem conter dados pessoais de contexto profissional, números de telefone, perfis públicos, anotações e informações que exigem tratamento responsável.

14.4. Importar backup na versão v6 - mesclagem conservadora

A versão v6 oferece Importar backup e pergunta se o usuário deseja juntar o backup aos dados atuais. Confirmando, a importação mescla as informações em vez de substituir indiscriminadamente a base local.

O comportamento identificado no código inclui:

  • Empresas inexistentes na Agenda atual são adicionadas.
  • Para empresas já existentes, preserva os dados locais principais e incorpora listas/tags ausentes, além de conservar um favorito já marcado e aproveitar notas quando as locais estiverem vazias.
  • Pesquisas novas do arquivo são incorporadas ao Histórico sem repetir IDs existentes.
  • Resultados de pesquisas locais com o mesmo identificador têm prioridade sobre os do arquivo importado.
  • Regras personalizadas são unidas por identificador ou nome do produto, sem duplicar regras idênticas.

O procedimento é uma mesclagem conservadora, não uma sincronização bidirecional completa. A importação não garante combinar automaticamente todas as alterações concorrentes de dois dispositivos.

As configurações e a pesquisa atual permanecem as da instalação local; a mesclagem não reaplica automaticamente as configurações contidas no backup.

Após a importação, o programa tenta atualizar o catálogo OSM, independentemente da idade do backup. A união é feita com o catálogo incorporado e o conteúdo remoto recém-obtido; não é garantia absoluta de conservar cada termo dinâmico de uma atualização anterior. Se o serviço remoto estiver indisponível, essa etapa poderá falhar e precisará ser repetida depois.

14.5. Por que o backup não guarda todo o catálogo OSM?

O catálogo OSM atualizado é armazenado separadamente no IndexedDB da instalação; ele não é copiado integralmente para cada backup JSON. Essa escolha mantém o backup concentrado nos dados do usuário e nas regras personalizadas. Ao restaurá-lo, o aplicativo procura atualizar o catálogo novamente.

Consequência prática: o backup preserva o trabalho e as personalizações, mas não é uma fotografia completa de cada sinônimo dinâmico existente no catálogo OSM no momento da exportação.

14.6. Exportação e importação independentes de regras

A seção Regras personalizadas do usuário também permite Exportar regras e Importar regras por JSON. Isso serve para transferir apenas o conhecimento personalizado entre instalações, sem precisar carregar todas as pesquisas e resultados.

14.7. Apagar todos os dados

A opção Apagar todos os dados redefine a base principal local do aplicativo mediante confirmação. O catálogo dinâmico e o aceite da política usam chaves separadas e não são apagados por essa ação. Faça um backup antes. A operação não apaga automaticamente arquivos que já foram exportados para outras pastas, dispositivos ou serviços.

15. Configurações e regras personalizadas

Em Configurações, o usuário ajusta parâmetros de análise e fontes complementares. Os valores-padrão identificados no código da v6 são:

ConfiguraçãoPadrãoSignificado
Máximo de páginas por site6Limita a quantidade principal de páginas examinadas.
Timeout12.000 msTempo máximo definido para determinadas requisições de análise.
Conexões simultâneas8Limite de tarefas de análise de páginas em paralelo, distinto da concorrência territorial.
Intervalo entre requisições400 msPausa configurada entre certas operações de análise.
Profundidade máxima1Limita o seguimento de links internos durante o rastreamento.
Máximo de empresas por pesquisa250Limite configurado de candidatos retidos, com regras específicas conforme o modo de pesquisa.

Alterar essas opções pode afetar velocidade, volume de dados, consumo de rede e a ocorrência de bloqueios. O fluxo de análise identifica bloqueios/CAPTCHA como falha e não implementa resolução de desafios ou login para esses sites.

Fontes complementares

  • Cadastro CNPJ: permite consultar informações cadastrais quando não foram encontrados contatos pelos meios principais. O uso depende da correspondência segura do nome da empresa.
  • Wikidata: pode complementar contatos e redes quando a referência ao site oficial for compatível com a empresa analisada.

Essas fontes não substituem as informações do OSM ou do site e podem estar incompletas ou defasadas.

Regras personalizadas

O dicionário editável permite Adicionar, Remover, editar nome do produto, palavras-chave e sinônimos e regras independentes para os modos Eu vendo e Procura-se. As regras comerciais são informadas em linhas no formato Rótulo|chave=valor usando tags OSM.

Exemplo ilustrativo de sintaxe: Gráfica|shop=copyshop. O editor também aceita regras pelo nome, como Gráfica|name~grafica.

Os modelos iniciais são editáveis. A opção Restaurar modelos repõe esses exemplos após confirmação, podendo substituir edições desse conjunto; use exportação de regras antes de restaurá-los.

16. Dicionários, categorias e inferências automáticas

16.1. Três camadas complementares

O motor trabalha com:

  1. Conhecimento comercial incorporado: perfis e relações predefinidas entre setores, produtos e serviços.
  2. Conhecimento personalizado: regras e sinônimos cadastrados pelo usuário.
  3. Conhecimento expansível: categorias e termos do catálogo OSM que podem ser incorporados por atualização e utilizados em inferências.

A ampliação do catálogo não modifica automaticamente a forma como o algoritmo pontua as empresas. O sistema continua determinístico e ensinável: amplia o repertório, aplica regras e produz novas associações, mas não aprende estatisticamente com vendas anteriores.

16.2. Atualização automática semanal

A atualização automática é ativada por padrão. O aplicativo tenta buscar, em intervalo semanal, o catálogo público de estabelecimentos OSM/iD traduzido para pt-BR, aplicando filtros para atividades comerciais elegíveis. É possível executar a atualização manualmente em Atualizar agora.

Quando há falha, a nota registra o problema. A inicialização permite nova tentativa após pelo menos 24 horas; não há agendador contínuo comprovado que dispare uma atualização exatamente nesse horário. O catálogo original incorporado continua como referência e não é apagado pela união com dados novos.

O contador de novidades compara as entradas do catálogo obtido com a base original incorporada ao aplicativo. Ele soma categorias novas e sinônimos adicionais de categorias existentes, sem necessariamente identificar novas relações comerciais efetivas.

O número exibido depende do catálogo obtido naquela instalação. O pacote não comprova quantas novidades foram incorporadas em uma execução real.

16.3. Inferências automáticas de relações

Categorias ainda não presentes nos ramos conhecidos podem herdar relações de um ramo comercial. A implementação compara radicais do nome oficial da categoria com os nomes do ramo e de suas categorias, exigindo a mesma família de chave OSM. Sinônimos soltos não decidem esse encaixe.

A afinidade mínima é de dois radicais em comum ou um radical distintivo presente em até dois ramos. Radicais distintivos recebem prioridade adicional. Se dois ramos empatarem, o encaixe específico é rejeitado. No lado de compradores, pode haver uma associação ampla por família para office, healthcare e industrial. Esse fallback amplo não é aplicado ao lado de fornecedores. Categorias consideradas inadequadas pela lista de exclusão não participam desse mecanismo.

Cada ramo recebe até oito regras inferidas. O motor registra internamente ramo de origem, motivo e força específica/ampla. Essas regras entram como relações secundárias; a avaliação de necessidade comercial também considera a falta de evidência direta e não as transforma automaticamente em demanda confirmada.

Na montagem da consulta, a ordem é: relações diretas, secundárias explícitas, inferidas específicas e inferidas amplas. Dentro de cada nível, alternam-se famílias OSM e descartam-se etiquetas duplicadas, até o limite de 30 regras. Esse limite vale para regras usadas na aquisição; as correspondências dos candidatos são avaliadas com o conjunto resolvido.

Quando catálogo ou definição dos ramos mudam, a chave do cache de inferências muda e as relações podem ser recalculadas. Adicionar termos e categorias amplia possibilidades, mas não garante que todas entrarão na próxima consulta nem que a precisão aumentará proporcionalmente.

16.4. Categorias em uso

Em Configurações > Categorias em uso, o usuário pode alternar entre compradores e fornecedores, filtrar categorias pelo nome e consultar quais relações são predefinidas ou estimadas. A opção Voltar ao catálogo original restaura o repertório OSM incorporado e descarta a versão dinâmica previamente obtida nessa instalação; não deve ser confundida com “Restaurar modelos” das regras personalizadas.

16.5. Diferença entre atualizar o catálogo e encontrar empresas novas

Mesmo sem nova atualização semanal do dicionário, uma pesquisa consulta os dados de estabelecimentos disponíveis nos serviços OSM. Portanto, uma nova empresa cadastrada no OSM pode surgir numa busca futura se sua atividade já for reconhecida pelo sistema.

A atualização semanal modifica o repertório de categorias e sinônimos reconhecíveis, enquanto cada pesquisa acessa a base de estabelecimentos, podendo reutilizar consultas territoriais idênticas do cache de dez minutos da sessão. São processos complementares e independentes.

16.6. Aprendizagem simbólica (Meta-PGT)

O Sales Pitch pode aprender relações comerciais novas com o uso, por um mecanismo simbólico e determinístico inspirado no Meta-DENDRAL — sem inteligência artificial, sem nuvem e sem envio de dados. Tudo fica só neste aparelho.

Autorização: a aprendizagem vem desligada. Ligue em Configurações > Aprendizagem simbólica; a data da autorização fica registrada. Desligar interrompe o aprendizado e o uso das regras na pontuação, mas guarda o que já foi aprendido para quando você religar. Importar um backup nunca liga nem desliga a aprendizagem.

Como funciona:

  1. Observação (INTSUM): depois de cada pesquisa, o sistema observa, em lotes de 25 empresas e sem travar a tela, a consulta, a modalidade, a categoria, as características e o nome de cada empresa.
  2. Geração (RULEGEN): só uma parte fixa das empresas (cerca de 70%) é usada para propor hipóteses, em nove famílias: produto → possível comprador, produto → possível fornecedor, categoria → setor, especialidade → categoria mais ampla, profissão → atividade, atividade → insumo, característica → necessidade, combinação de características → compatibilidade e denominação comercial → conceito. Relações já conhecidas, genéricas demais, ciclos e associações sensíveis são descartados. Até 40 hipóteses novas por pesquisa; as demais observações continuam reforçando as já existentes.
  3. Validação (RULEMOD): as outras ~30% das empresas, que não participaram da criação, servem de conferência independente. Uma regra só é aprovada sozinha com empresas distintas suficientes nos dois grupos (no mínimo 3; 4 para características, combinações e hierarquias; 5 para denominações). Sem isso, continua hipótese.
  4. Memória cumulativa: cada empresa conta uma única vez por consulta, mesmo que você repita a pesquisa ou reinicie o app. Uma pesquisa de hoje pode completar uma hipótese observada meses atrás, mesmo depois que ela saiu do histórico.
  5. Autocorreção: duas ou mais avaliações Irrelevante com precisão abaixo de 70% fazem a regra voltar a ser hipótese.

Avaliação opcional: no perfil da empresa, em "Esta empresa é relevante para você?", marque 👍 Relevante ou 👎 Irrelevante. A avaliação vale só para aquela pesquisa e modalidade — uma padaria relevante para quem vende farinha não fica marcada para quem procura máquinas. O aprendizado é atualizado na hora. Trocar a avaliação substitui a anterior; clicar de novo desfaz.

Uso na pontuação: regras aprovadas somam até 3 pontos cada e no máximo 8 por empresa, só na modalidade certa (compradores em EU VENDO, fornecedores em PROCURA-SE), só quando a empresa já tem uma categoria ligada à pesquisa e nunca quando há contradição. Nada disso muda as consultas aos mapas.

Backup: regras, avaliações e preferências de tags vão no backup. Ao importar, suas rejeições locais prevalecem e exemplos repetidos não são somados duas vezes. Regras aprendidas na versão antiga voltam a ser hipóteses até receberem exemplos novos.

Limites: até 500 regras e 2.000 avaliações; ao encher, saem primeiro as hipóteses mais fracas.

Tags da pesquisa: ligar, desligar e aprendizado

O que são tags: o OpenStreetMap descreve cada estabelecimento com etiquetas no formato chave=valor, por exemplo shop=bakery (padaria), craft=bakery (fabricação de pães), amenity=restaurant (restaurante) ou shop=supermarket (supermercado). Quando você digita um termo, o dicionário local traduz esse termo nas tags correspondentes, e são elas que o Sales Pitch usa para buscar empresas nos servidores de mapas.

Onde ficam: no formulário de pesquisa, no quadro lateral de relações, cada tag aparece como um botão com o nome e o código (chave=valor). As tags de relação direta (+30) e de relação secundária (+15) ficam em grupos separados.

Ligar e desligar: clique numa tag para desligá-la (fica riscada, com ✗) e clique de novo para religar (✓). Tags desligadas não são pesquisadas e não entram na pontuação daquela pesquisa. No modo EU VENDO é preciso manter pelo menos uma tag ligada.

O que o sistema aprende: ao iniciar a pesquisa, o Sales Pitch guarda quais tags você deixou ligadas e quais desligou para os conceitos digitados. Na próxima pesquisa igual ou parecida (sinônimos e termos equivalentes do dicionário, como "pães" e "panificação"), as tags que você costuma desligar já vêm desligadas. Se você religar uma tag, a preferência se ajusta sozinha com o uso. Tudo fica só no seu dispositivo e entra no backup.

Limites desta versão: as regras de relação aprovadas pelo próprio sistema agora reforçam a pontuação das empresas em que o padrão aparece ("Padrão aprendido nas suas pesquisas", até +8 pontos). Esse reforço só vale para empresas que já têm categoria relacionada à pesquisa, nunca cria compatibilidade sozinho e não se aplica quando há contradição; já as preferências de tags mudam quais tags vêm ligadas por padrão. A aprendizagem não faz novas consultas à internet, não muda os limites de pesquisa (250 empresas) e não modifica os dicionários originais.

17. Dados, fontes externas e privacidade

O Sales Pitch adota armazenamento local de resultados, histórico, Agenda, configurações e regras. As consultas são realizadas pela rede do dispositivo, por meio dos mecanismos disponibilizados no Windows/macOS (Electron) e Android (Capacitor).

Principais fontes utilizadas

Serviço ou baseFinalidade típica
OpenStreetMap / OverpassDescoberta de estabelecimentos e dados estruturados.
NominatimResolução de locais e referências geográficas.
Serviços de geolocalização por IPSugestão aproximada de localização no desktop.
Sites oficiaisConfirmação de canais, páginas públicas e contexto empresarial.
BrasilAPI / Minha Receita e dados cadastrais CNPJComplementação cadastral e possível identificação de sócios/administradores.
WikidataEnriquecimento condicionado à correspondência do site oficial.
DuckDuckGo, Mojeek e Brave SearchDescoberta de informações profissionais publicamente pesquisáveis.
Catálogo OSM/iD (via CDN)Atualização de categorias e sinônimos.

O aplicativo não oferece garantia de disponibilidade contínua de nenhum desses serviços. Os provedores podem aplicar limites, alterar páginas, recusar requisições ou disponibilizar informações incompletas.

Onde os dados ficam?

Os resultados e a Agenda ficam no armazenamento local do aplicativo, utilizando IndexedDB. O programa não exige conta ou servidor próprio para guardar a carteira do usuário. Isso não significa ausência de comunicação com terceiros: pesquisar empresas, localizar um bairro, obter coordenadas, consultar CNPJ ou procurar decisores envolve serviços externos, que recebem parâmetros técnicos da consulta.

Política e proteção dos dados no código

O texto implementado exige uso profissional responsável, verificação das informações e respeito aos direitos dos titulares. A versão integral está reproduzida no capítulo 21. Essas disposições são o conteúdo da política do software; este manual não acrescenta avaliação jurídica independente.

Arquivos CSV, XLSX e JSON exportados não recebem criptografia própria do exportador. O aplicativo guarda objetos estruturados, trechos de evidência, fontes e links das páginas analisadas; não se deve descrever o armazenamento como contendo apenas links. O aceite da política fica no localStorage, separado da base principal e do catálogo dinâmico.

Rede e recursos complementares

A geolocalização por IP usa ipapi.co e ipwho.is como alternativas. O código compartilhado de rede inclui cinco endpoints Overpass: private.coffee, overpass-api.de, kumi.systems, lz4.overpass-api.de e z.overpass-api.de. Os três primeiros são iniciados na rodada principal e os dois últimos após espera de oito segundos; o primeiro sucesso vence e os demais pedidos são cancelados quando o transporte permite. Se todos falharem, há uma segunda rodada após quatro segundos. Isso é tentativa alternativa, não promessa de retomada persistente após fechar o app.

A busca de páginas inclui verificação de destinos e resolução DNS via Cloudflare DNS em caminhos do código compartilhado. O mapa solicita cartografia externa do OSM. As fontes IBM Plex Sans e Mono são importadas de pacotes locais no código de estilos. Atualizações de catálogo são buscadas no jsDelivr.

O intervalo de dez segundos é aplicado por chave de domínio nos caminhos que chamam o limitador, como buscadores de decisores e consulta ao quadro de sócios. Ele não é um intervalo global comprovado para toda requisição do programa: geocodificação e consultas Overpass têm seu próprio fluxo, e a análise de sites possui pausa e concorrência configuráveis.

18. Limitações e boas práticas de prospecção

O Sales Pitch é um instrumento de triagem e descoberta, com limites naturais das fontes consultadas e do motor de inferência.

LimiteConsequência para o uso
Empresa ausente do OSMPode não aparecer na pesquisa principal.
Categoria OSM não reconhecida ou fora do limiteAlgumas empresas relevantes podem não ser selecionadas.
Termo genéricoPode produzir candidatos excessivamente amplos.
Centro geográfico estimado do bairroNão equivale ao endereço do usuário nem ao centro exato do bairro.
Pesquisa territorial limitada por orçamento de candidatosNão garante exaustividade em metrópoles, estados ou países.
Site bloqueado ou indisponívelO enriquecimento de contatos pode ficar incompleto.
Identificação de decisor por fontes públicasCargo, identidade e vínculo devem ser confirmados manualmente.
Pontuações heurísticasNão são probabilidade de venda nem certificação de qualidade.

Rotina recomendada: comece com termo específico e território menor; confira categorias e pontuações; filtre resultados com contatos úteis; leia as fontes no perfil; valide empresas e decisores; organize apenas oportunidades pertinentes na Agenda; faça backups periódicos e revise periodicamente a necessidade de conservar dados antigos.

19. Solução de problemas

SituaçãoO que verificar ou fazer
Nenhuma empresa encontradaConfirme a localização, a modalidade e os termos; consulte as categorias sugeridas ou adicione regra personalizada.
Raio aparenta partir do lugar erradoSe a localização foi digitada, confira o centro geográfico estimado do bairro; para posição física use GPS no Android.
“Cidade inteira” parece limitadaVeja se o modo escolhido é realmente cidade, não raio; lembre que há limites de candidatos e disponibilidade no OSM.
Pesquisa estadual ou nacional demoraPrefira cidade/raio ou Pesquisa rápida; grandes territórios não são exaustivos.
Não aparece a opção de pesquisar no paísA pesquisa por país existe somente no Windows e no Mac; no Android use raio, cidade ou estado.
Overpass falhouAguarde os servidores alternativos, examine “Ver erros” e tente mais tarde.
Site não analisadoO estabelecimento pode permanecer como resultado OSM; bloqueios, redirecionamentos e falhas externas são possíveis.
Telefone/e-mail divergenteCompare a origem de cada contato e confirme pelos canais oficiais.
Decisor não identificadoVerifique se a empresa possui site ou CNPJ; confirme fontes e tente novamente mais tarde.
GPS não funciona no AndroidConceda a permissão de localização, ative o serviço do dispositivo ou use localização manual.
Arquivo exportado não apareceConfira a notificação e procure Documentos/SalesPitch; no Android pode ter sido usado o local alternativo do aplicativo.
Backup importado não substituiu um contato antigoA v6 usa mesclagem conservadora; atualize a empresa pela opção de verificação para comparar contatos.
Contador de novidades não mudaÉ acumulado em relação à base original; a atualização pode ocorrer sem novas categorias ou sinônimos.

20. Glossário e referência das funcionalidades

API: serviço que permite a um software consultar dados de outro sistema. B2B: relações comerciais entre empresas. Candidato: empresa obtida numa consulta e ainda sujeita à classificação e à verificação. CNAE / CBO: classificações brasileiras de atividades econômicas e ocupações, utilizadas como referências de vocabulário conforme o código. Contact Confidence: pontuação de evidências sobre canais de contato da empresa. Decisor: pessoa potencialmente vinculada à decisão de compra ou negociação de fornecimento. Dicionário: catálogo de palavras-chave, sinônimos, atividades e relações comerciais reconhecidas. Geocodificação: transformação de um local descrito em texto em coordenadas e/ou limites estimados. Haversine: fórmula para estimar distância em linha reta sobre a superfície terrestre. Domínio independente: agrupamento operacional de fontes por domínio registrável; páginas e subdomínios do mesmo domínio contam juntos, sem garantia de proprietários distintos. Inferência determinística: associação nova obtida pela aplicação de regras explícitas. IndexedDB: armazenamento estruturado local do aplicativo. JSON: formato textual estruturado usado em backups e exportações. LGPD: Lei Geral de Proteção de Dados Pessoais (Lei nº 13.709/2018). Match Score: pontuação estimada de compatibilidade comercial. OSM: OpenStreetMap, base colaborativa de informações geográficas. Overpass: sistema de consultas estruturadas aos dados do OSM. Pesquisa rápida: seleção de até dez candidatos, baseada no ranqueamento disponível durante a consulta. Relação curada: associação comercial previamente definida no catálogo ou pelo usuário. Relação estimada: associação produzida pelo mecanismo de inferência por regras. XLSX: formato de planilha compatível com Excel, criado localmente pelo aplicativo.

Referência técnica da edição

Referência original: SalesPitch-codigo-v6.zip. Revisão atual: arquivos de implementação do Sales Pitch em 30/10/2026.

ImplementaçãoConteúdo documentado
SearchForm.tsx; device-location.tsFormulário, termos, abrangência, IP e localização do dispositivo.
engine.ts; net-core.ts; net.tsAquisição, subdivisões, prioridade, cancelamento, rede e análise de sites.
dictionary.ts; dictionary-big.ts; inference.ts; dict-update.tsVocabulário, regras, expansão e atualização de catálogo.
relevance.ts; scoring.tsInterpretação contextual, rigor, inferência de necessidade e pontuações.
resultados.tsx; agenda.tsx; historico.tsx; mapa.tsxFiltros, organização, recuperação e mapas.
empresa.$id.tsx; SaveControls.tsxPerfis, salvar e aplicar atualizações de contatos.
decision.ts; sources.ts; DecisionMakers.tsx; throttle.tsDecisores, CNPJ, provedores e intervalos.
configuracoes.tsx; store.ts; export.tsAjustes, persistência, exportação e mesclagem de backups.
policy.ts; PolicyGate.tsx; manual.tsxPolítica, aceite local e consulta de ajuda.

Esta edição descreve caminhos da implementação. Não atribui taxa de acerto, tempo típico de resposta, quantidade de leads, aprovação em loja, estabilidade comprovada ou resultado comercial ao software.

21. Política de Uso Responsável incluída na v6

O texto a seguir é reproduzido de src/lib/policy.ts, versão 1.0. Não foi ampliado com fontes externas.

SALES PITCH

POLÍTICA DE USO RESPONSÁVEL

Versão 1.0 - Outubro de 2026

  1. FINALIDADE DO APLICATIVO

O Sales Pitch é uma ferramenta de pesquisa e prospecção comercial B2B, destinada à identificação de empresas, potenciais compradores, fornecedores e possíveis responsáveis por decisões comerciais.

O aplicativo utiliza informações disponíveis em fontes públicas, mecanismos de busca, bases cadastrais e serviços de geolocalização, combinados com algoritmos determinísticos de classificação e inferência comercial.

O Sales Pitch tem finalidade exclusivamente informativa e de apoio à atividade comercial. Seus resultados não constituem confirmação de interesse de compra, recomendação definitiva ou garantia de relacionamento comercial.

  1. UTILIZAÇÃO PERMITIDA

O usuário poderá utilizar o Sales Pitch para:

  • Identificar potenciais clientes e fornecedores.
  • Pesquisar estabelecimentos e atividades empresariais.
  • Consultar informações profissionais e empresariais publicamente disponíveis.
  • Identificar possíveis decisores e representantes comerciais.
  • Organizar oportunidades e registros de prospecção.
  • Exportar resultados para utilização profissional legítima.
  • Criar, modificar e ampliar dicionários e regras comerciais.
  • Realizar análises de mercado e pesquisas empresariais.

Todas as atividades deverão observar a legislação aplicável, os direitos de terceiros e as condições de utilização das fontes consultadas.

  1. PROTEÇÃO DE DADOS PESSOAIS E LGPD

O usuário deverá utilizar o Sales Pitch em conformidade com a Lei nº 13.709/2018 (Lei Geral de Proteção de Dados Pessoais - LGPD) e demais normas aplicáveis.

Informações como nomes, cargos, perfis profissionais, telefones e endereços eletrônicos podem constituir dados pessoais quando permitirem identificar pessoas físicas.

A disponibilidade pública de uma informação não elimina a aplicação da LGPD.

Cabe ao usuário:

  • Estabelecer uma finalidade legítima e específica para o tratamento de dados.
  • Identificar uma hipótese legal adequada para as operações realizadas.
  • Utilizar somente informações necessárias à finalidade pretendida.
  • Proteger os dados contra acessos ou divulgações indevidos.
  • Respeitar os direitos dos titulares, inclusive pedidos de correção, oposição e eliminação, quando aplicáveis.
  • Evitar a conservação de informações desnecessárias ou desatualizadas.

O legítimo interesse poderá fundamentar determinadas atividades de prospecção comercial, desde que atendidos os requisitos legais, incluindo necessidade, proporcionalidade, transparência e respeito aos direitos dos titulares.

O uso do Sales Pitch não constitui, por si só, autorização legal para coletar, conservar, compartilhar ou utilizar quaisquer dados pessoais.

  1. PESQUISA DE DECISORES E CONTATOS PROFISSIONAIS

O Sales Pitch poderá apresentar nomes, cargos, perfis profissionais públicos e informações empresariais relacionadas a possíveis responsáveis por decisões comerciais.

Essas informações deverão ser utilizadas exclusivamente para finalidades profissionais legítimas.

É responsabilidade do usuário:

  • Verificar a identidade e a vinculação profissional das pessoas encontradas.
  • Considerar os indicadores de confiança e as evidências apresentados pelo aplicativo.
  • Não presumir que a identificação de um possível decisor seja definitiva.
  • Evitar abordagens abusivas, excessivas ou incompatíveis com a finalidade profissional.
  • Respeitar solicitações para interrupção de contatos comerciais.

A identificação de uma pessoa pelo aplicativo não significa que ela tenha autorizado o recebimento de mensagens comerciais.

  1. CONDUTAS PROIBIDAS

É proibida a utilização do Sales Pitch para:

  • Assédio, perseguição, intimidação ou ameaças.
  • Envio de mensagens comerciais em desacordo com a legislação aplicável.
  • Fraudes, falsidade de identidade ou engenharia social maliciosa.
  • Discriminação ilícita ou elaboração de perfis discriminatórios.
  • Comercialização ou divulgação indevida de dados pessoais.
  • Pesquisa direcionada à obtenção de informações privadas ou sigilosas sem autorização.
  • Violação de direitos de propriedade intelectual.
  • Utilização de informações para práticas ilícitas ou abusivas.
  • Tentativas de contornar mecanismos de segurança, autenticação, CAPTCHA ou restrições de acesso de terceiros.
  • Utilização excessiva dos serviços externos em desacordo com suas políticas de acesso.

O usuário deverá respeitar a finalidade profissional do aplicativo e os limites legais de utilização das informações obtidas.

  1. FONTES PÚBLICAS E SERVIÇOS EXTERNOS

O Sales Pitch realiza consultas a diferentes fontes públicas e serviços externos, incluindo bases geográficas, dados cadastrais e mecanismos de pesquisa.

A disponibilidade, abrangência, precisão e atualização das informações dependem das respectivas fontes.

O usuário reconhece que:

  • Nem todas as empresas estão presentes nas bases consultadas.
  • Informações públicas podem estar incompletas ou desatualizadas.
  • Serviços externos podem apresentar instabilidade, restrições ou indisponibilidade temporária.
  • Determinados contatos profissionais podem não ser encontrados.
  • Resultados podem variar conforme a região, os termos pesquisados e a disponibilidade das fontes.

O usuário deverá respeitar as condições de utilização, os direitos de terceiros e as obrigações de atribuição aplicáveis às fontes utilizadas, inclusive ao OpenStreetMap.

  1. RESULTADOS, PONTUAÇÕES E INFERÊNCIAS

O Sales Pitch utiliza regras determinísticas, dicionários e critérios de compatibilidade para identificar possíveis relações comerciais.

O mecanismo pode produzir associações estimadas entre atividades empresariais, produtos e serviços.

As pontuações, classificações e inferências apresentadas são estimativas computacionais, não avaliações definitivas.

Consequentemente:

  • Uma pontuação elevada não garante que uma empresa seja um cliente potencial efetivo.
  • Uma relação comercial inferida não comprova que a empresa consuma ou forneça determinado produto.
  • Um perfil profissional encontrado não comprova automaticamente autoridade decisória.
  • Informações relevantes deverão ser verificadas antes de decisões comerciais importantes.

O usuário é responsável por avaliar a adequação dos resultados às suas necessidades profissionais.

  1. ARMAZENAMENTO, EXPORTAÇÃO E BACKUP

O Sales Pitch utiliza armazenamento local para preservar informações, pesquisas, resultados, configurações e registros comerciais.

O aplicativo permite exportar informações e gerar backups para recuperação ou transferência de dados.

O usuário deverá:

  • Proteger o dispositivo utilizado contra acessos não autorizados.
  • Manter cópias de segurança quando considerar necessário.
  • Armazenar arquivos exportados em locais adequadamente protegidos.
  • Evitar compartilhar backups contendo dados pessoais com destinatários não autorizados.
  • Eliminar cópias antigas quando não forem mais necessárias, observadas as obrigações legais de conservação.
  • Verificar a integridade dos dados após procedimentos de restauração.

Os backups JSON podem conter informações legíveis sem criptografia própria. Portanto, o usuário deverá adotar medidas apropriadas de proteção dos arquivos.

A exclusão de registros dentro do aplicativo não elimina automaticamente cópias anteriormente exportadas ou armazenadas em outros dispositivos.

  1. ATUALIZAÇÃO DOS DICIONÁRIOS

O Sales Pitch poderá incorporar novos termos, sinônimos e categorias comerciais a partir de atualizações das fontes utilizadas.

O mecanismo também poderá inferir novas associações comerciais com base em regras preexistentes.

Essas atualizações têm como finalidade ampliar a cobertura das pesquisas, mas não garantem a identificação de todas as atividades empresariais existentes.

O usuário poderá acrescentar regras e termos personalizados, assumindo a responsabilidade pela adequação e legitimidade das informações inseridas.

A expansão do vocabulário e das relações comerciais não caracteriza aprendizado de máquina nem garante melhoria proporcional da precisão dos resultados.

  1. USO RESPONSÁVEL DOS RECURSOS DE PESQUISA

O Sales Pitch depende parcialmente de serviços externos sujeitos a limites técnicos e políticas próprias de acesso.

O usuário deverá utilizar as pesquisas de maneira razoável, evitando práticas destinadas a sobrecarregar, prejudicar ou contornar indevidamente as restrições desses serviços.

Pesquisas extensas poderão exigir maior tempo de processamento ou apresentar resultados parciais.

O usuário reconhece que a interrupção ou indisponibilidade de uma fonte externa poderá afetar temporariamente determinadas funcionalidades.

  1. RESPONSABILIDADE PELA UTILIZAÇÃO DAS INFORMAÇÕES

O Sales Pitch é uma ferramenta auxiliar de pesquisa comercial.

Cabe ao usuário verificar a adequação, a precisão e a legitimidade das informações antes de utilizá-las em negociações, campanhas, comunicações ou decisões empresariais.

Quando o usuário determinar as finalidades e os meios do tratamento de dados pessoais em sua atividade profissional, deverá cumprir as obrigações legais correspondentes, inclusive aquelas atribuídas ao controlador pela LGPD.

O aplicativo não substitui procedimentos próprios de verificação empresarial, análise jurídica, proteção de dados ou avaliação comercial.

  1. RESPEITO AOS DIREITOS DOS TITULARES

O usuário deverá manter procedimentos adequados para atender solicitações legítimas de titulares de dados pessoais.

Quando aplicável, deverá permitir ou providenciar:

  • Correção de informações incorretas.
  • Interrupção de contatos comerciais indevidos.
  • Oposição ao tratamento nas hipóteses previstas em lei.
  • Exclusão de informações quando legalmente exigível.
  • Esclarecimentos sobre a origem e a finalidade do tratamento de dados.

O exercício desses direitos deverá observar a legislação vigente e as obrigações específicas do responsável pelo tratamento.

  1. DISPOSIÇÕES FINAIS

O Sales Pitch destina-se ao apoio de atividades comerciais legítimas e à utilização responsável de informações disponíveis em fontes públicas.

O aplicativo não garante resultados comerciais, identificação definitiva de decisores, disponibilidade contínua dos serviços externos ou precisão absoluta das informações apresentadas.

A utilização do software deverá respeitar a legislação aplicável, os direitos de terceiros, as limitações técnicas das fontes e os princípios de boa-fé, necessidade, transparência e segurança.

O usuário é responsável por utilizar as informações obtidas de maneira ética, legal e compatível com a finalidade profissional do Sales Pitch.

Sales Pitch - Política de Uso Responsável

Versão 1.0 - Outubro de 2026

Revisão documental: 30/10/2026. Política de uso preservada na versão 1.0.

SHA-256 do pacote original v6 (não do instalador atual): b69f0f84c1f0a2f19f2766b85224e23011233eba4033ea37f04c76103a9b0fdc