Instalação do Gaspar

Do download ao primeiro SMS, em quatro partes: instale o Gaspar no computador, coloque o aplicativo no celular, pareie os dois e envie uma mensagem de teste.

Versão publicada: Gaspar 1.7.2 no computador e aplicativo Android 1.5. O download fica em gaspar.caracore.com.br. O mascote funciona sozinho; o SMS é opcional e só liga quando um celular é pareado.

Antes de começar

Nada de cadastro, conta online ou mensalidade. Separe os itens abaixo e siga as partes na ordem.

Na mão

  • Um computador com Windows 10 ou 11, ou Linux com X11/XWayland.
  • Um celular Android 7 ou superior, com chip e crédito para SMS.
  • Os dois na mesma rede Wi-Fi — evite a rede de visitantes, que costuma isolar os aparelhos.
  • Os arquivos baixados na página de downloads.

O que você não vai precisar

  • Administrador do Windows para o Gaspar: a instalação é por usuário.
  • Internet no computador para o SMS: a conversa com o celular é pela Wi-Fi da loja.
  • Conta ou login: o Gaspar abre e funciona direto.

O único caso que pede elevação é o BlackBox, ferramenta opcional que mexe na configuração de rede do Windows.

Parte 1 — Instale o Gaspar no computador

Baixe o arquivo do seu sistema na página de downloads e siga o caminho abaixo.

Windows 10 e 11

  1. Baixe e abra o instalador

    Na página de downloads, escolha Windows e abra o arquivo baixado.

  2. Siga o assistente

    Clique em Avançar, Instalar e Concluir. Não é preciso desinstalar nada antes.

  3. Abra o Gaspar

    Use o atalho da Área de Trabalho ou o menu Iniciar. Na primeira vez, o painel de configuração abre junto.

  4. Ajuste e deixe rodando

    Escolha o ritmo e clique em Ocultar para ficar só com o mascote na tela. Para encerrar de verdade, clique com o botão direito no ícone perto do relógio e escolha Sair.

Se o Windows mostrar o aviso azul do SmartScreen, clique em Mais informações e depois em Executar assim mesmo. O programa ainda não tem assinatura de código; isso é esperado em programas distribuídos diretamente pela Cara Core.

Linux

Debian, Ubuntu e Mint

Baixe o pacote .deb e dê dois cliques para instalar pelo aplicativo de pacotes.

Outras distribuições

Baixe o AppImage, clique com o botão direito, abra Propriedades, vá em Permissões e marque Permitir executar. Depois, dê dois cliques no arquivo.

Se o mascote não aparecer

Use uma sessão X11 ou XWayland. Em Wayland puro, o recorte do mascote pode falhar.

Parte 2 — Coloque o aplicativo no celular

É ele que dispara o SMS pelo chip. Não precisa de internet nem de Play Store.

  1. Baixe o aplicativo

    Na página de downloads, toque em Baixar APK. Se estiver no computador, envie o arquivo ao celular por cabo, WhatsApp ou Telegram.

  2. Instale no celular

    Abra o arquivo e toque em Instalar. Se aparecer o aviso de "fontes desconhecidas", autorize apenas para esta instalação.

  3. Libere as permissões

    Abra o aplicativo e aceite as permissões de SMS. O Android pede as três de uma vez.

  4. Tire o aplicativo da economia de bateria

    Sem isso, o Android pode encerrar o serviço com a tela apagada e o celular para de responder ao Gaspar. O caminho costuma ser Configurações > Aplicativos > Bateria > Sem restrições.

  5. Deixe na mesma Wi-Fi

    Computador e celular precisam estar na mesma rede, e o aplicativo deve ficar aberto durante a configuração.

Permissões: o aplicativo usa enviar para os comprovantes e receber para a licença. Ele não lê a sua caixa de entrada.

Licença Premium: no painel do aplicativo, preencha Número que envia a licença com o DDD + número da Cara Core e toque em Salvar número. Enquanto esse número não estiver salvo, o aplicativo ignora qualquer SMS de licença.

Parte 3 — Pareie o celular com o Gaspar

O pareamento é o que autoriza o celular a receber os pedidos do Gaspar.

  1. Abra a janela Celular / SMS

    No Gaspar, clique em Celular / SMS e confirme que Ponte ativa está marcado.

  2. Gere o QR Code

    Clique em Parear celular. Um QR aparece em uma janela separada.

  3. Leia o código com o celular

    No aplicativo, abra a leitura de QR e aponte para o código na tela do computador.

  4. Confirme o pareamento

    Quando o celular termina, o Gaspar mostra Celular pareado. O QR vale por 15 minutos e só pode ser usado uma vez.

Se o celular não for encontrado, clique em Procurar celular e confira se os dois aparelhos estão na mesma rede.

Parte 4 — Envie o primeiro SMS de teste

O teste confirma o pareamento e a rede, sem precisar do PDV.

  1. Informe um número

    Digite um número com DDD, por exemplo 11999999999.

  2. Clique em Enviar teste

    Use o aparelho de teste para confirmar que a mensagem chega.

  3. Acompanhe na lista

    Últimos envios mostra cada etapa: enviado, entregue ou falhou.

O que cada estado quer dizer

  • Enviado — o chip do celular aceitou a mensagem.
  • Entregue — a operadora confirmou que o SMS chegou ao aparelho do cliente.
  • Falhou — o chip ou a operadora recusou; confira crédito, chip e sinal.

Hoje o pedido parte do painel do Gaspar. A chamada automática quando o PDV fecha a venda entra na próxima versão do PDV.

Checklist final

Se todos os itens abaixo estiverem certos, o Gaspar e o celular estão conversando.

Sinais de que está pronto

  • O Gaspar abre e o mascote aparece na tela.
  • O aplicativo do celular está instalado e com as permissões de SMS.
  • Celular e computador estão na mesma Wi-Fi.
  • O celular aparece como pareado na janela Celular / SMS.
  • O SMS de teste chegou ao aparelho escolhido.

Atualizar e desinstalar

Atualizar: baixe a versão nova e instale por cima. O guia de atualização mostra o passo a passo.

Desinstalar no Windows: abra Aplicativos instalados, encontre Gaspar - Mascote Cara Core e escolha Desinstalar.

No Linux: remova pelo gerenciador de aplicativos ou apague o AppImage.

No celular: toque e segure o ícone do aplicativo e escolha Desinstalar.

As preferências ficam na pasta do seu usuário, no computador. Apague essa pasta se quiser remover tudo.

Problemas comuns

O Windows bloqueou o instalador

Clique em Mais informações e depois em Executar assim mesmo. Confirme antes que o arquivo veio de gaspar.caracore.com.br ou da página oficial de versões.

O mascote não aparece no Linux

Use uma sessão X11 ou XWayland. Em Wayland puro, o recorte do mascote pode não funcionar.

O celular não instala o aplicativo

Autorize "fontes desconhecidas" para esta instalação. Se o Play Protect avisar que não reconhece o aplicativo, escolha instalar mesmo assim — ele não vem da Play Store.

O celular não é encontrado

Confira se os dois estão na mesma Wi-Fi, se o aplicativo está aberto e se a economia de bateria está desligada. Redes de visitantes costumam isolar os aparelhos.

O QR Code expirou

Clique em Parear celular de novo para gerar outro. O código anterior deixa de valer.

O SMS de teste não chega

Confira chip, crédito e permissão de SMS no celular. Enviado significa que o chip aceitou; entregue é a confirmação da operadora. Se aparecer sem chave do celular, pareie de novo.