Índice do manual

🪟 Agente no Windows

Em 30 segundos

No Windows, o agente instala-se como qualquer programa: descarregas o instalador a partir do BolloPrint, abre-lo e segues o assistente.
No fim abre-se a sua página: premes Ligar ao BolloPrint, confirmas com a conta do proprietário da oficina e está feito. Não há códigos para copiar nem manifestos para colar.
Funciona como um serviço do Windows: continua a trabalhar mesmo que termines a sessão, desde que o PC esteja ligado.
Atualiza-se sozinho. Se algum dia o quiseres fazer tu, instala a versão nova por cima da que tens.

🧪 Em beta

O agente para Windows está em beta: funciona e usamo-lo todos os dias, mas ainda pode ter pormenores por afinar. Se alguma coisa não correr como se explica aqui, escreve-nos.

Se na oficina tens um PC com Windows que nunca se desliga, já tens onde pôr o agente local. Instala-se com um assistente dos de sempre, fica a funcionar em segundo plano e liga-se à tua oficina a partir do navegador, com um clique.

Esta página trata só de instalá-lo e mantê-lo no Windows. O que é o agente e o que faz tens em O agente local, e como se adicionam as impressoras, em Impressoras por rede local.

O que precisas

Um PC com Windows 10 ou 11 de 64 bits, com processador Intel ou AMD.
Que esteja sempre ligado e na mesma rede que as impressoras. Se o PC se desligar ou entrar em suspensão, o BolloPrint deixa de ver as impressoras até ele voltar.
Poder instalar programas nesse PC: o Windows vai pedir-te permissão de administrador.
A conta BolloPrint do proprietário da oficina. Só o proprietário pode adicionar um agente.

Não é preciso criar nada antes no BolloPrint: o agente é adicionado à tua oficina quando o ligas. Também não é preciso abrir portas no router: é o agente que se liga ao BolloPrint, não ao contrário.

💡 Um PC com processador ARM?

O Windows 11 em ARM consegue instalá-lo, mas ainda não o testámos. No Windows 10 em ARM não se pode instalar.

Instalá-lo

1. Descarrega o instalador

No BolloPrint, vai a Configurações → Impressoras, abre o separador Agente local e prime Novo agente. Escolhe Windows e prime Transferir para Windows.

Descarrega-o sempre a partir daí: é a versão certa em cada momento.

Se o navegador te avisar de que o ficheiro não é transferido com frequência, escolhe Manter. É o mesmo que o aviso do passo seguinte.

2. O Windows vai avisar-te: é normal

O instalador ainda não tem assinatura digital, por isso o Windows trata-o como um programa desconhecido e, ao abri-lo, mostra um aviso azul: O Windows protegeu o seu PC (Windows protected your PC).

Prime Mais informações.
Prime Executar mesmo assim (Run anyway).

Depois o Windows pergunta se permites que a aplicação faça alterações ao dispositivo. Prime Sim: é preciso para instalar o agente como serviço e para o deixar encontrar as tuas impressoras na rede.

Se não aparecer «Executar mesmo assim»

O teu Windows tem ativado o Controlo Inteligente de Aplicações (Smart App Control). Essa proteção bloqueia os programas sem assinatura e não deixa abrir uma exceção só para um. Não te recomendamos desativá-la: protege o teu PC de programas desconhecidos, e o agente pode viver noutro sítio.

Nesse caso, põe o agente noutro equipamento sempre ligado da mesma rede: um NAS, um Raspberry Pi, outro PC… As formas de o fazer estão em O agente local.

3. Segue o assistente

Escolhe o idioma e deixa a pasta que ele propõe.
Em Página do agente, deixa a porta em 8257. Só terás de a mudar se outro programa do PC já a usar (vais notar porque a página do agente não abre); nesse caso, experimenta 8364.
Prime Instalar.
No fim, deixa marcada a caixa Abrir a página do agente para o ligar e prime Concluir.

O assistente deixa o agente a funcionar como serviço do Windows, que arranca sozinho com o PC, e abre-lhe na firewall do Windows só o necessário para encontrar impressoras na tua rede local. Também põe um ícone do BolloPrint junto ao relógio e um atalho Agente BolloPrint no menu Iniciar.

Ligá-lo à tua oficina

Quando a instalação termina, abre-se no navegador a página do agente. Diz «Este agente ainda não pertence a nenhuma oficina» e mostra um código curto: repara nele.

Prime Ligar ao BolloPrint.
Abre-se o BolloPrint. Inicia sessão com a conta do proprietário, se ainda não a tinhas aberta. Se fores proprietário de várias oficinas, pergunta-te A que oficina o adicionas?: escolhe uma.
Em Adicionar um agente a… vais ver o nome do teu PC (Equipamento) e um Código. Confirma que é o mesmo que a página do agente mostra.
Se quiseres, muda o nome do agente. Melhor onde está do que o que é: «Escritório», «Pavilhão 2».
Prime Adicionar à oficina.

Chegas a Configurações → Impressoras → Agente local, com o teu agente novo na lista. A página do agente, no teu PC, vai dizer Ligado a e o nome da tua oficina.

🔐 Só se foste tu a premir

Continua apenas se acabaste de premir Ligar ao BolloPrint no teu próprio PC. Se alguém te enviou um link para «adicionar um agente», fecha-o: estarias a meter na tua oficina um equipamento que não é teu.

Confirmar que funciona

Em Configurações → Impressoras → Agente local, o agente aparece Online, com o logótipo do Windows.

Em poucos minutos, mais abaixo, em Impressoras na rede local, começam a aparecer as impressoras que encontrou na tua rede. Adiciona as que quiseres; o passo a passo de cada marca está em Impressoras por rede local. Se acabaste de ligar uma e não queres esperar, prime Procurar agora.

Onde o encontras no teu PC

O ícone do BolloPrint, junto ao relógio da barra de tarefas (se não o vires, pode estar escondido na seta ˄). Um clique abre a página do agente. Com o botão direito tens:
- Abrir a página do agente.
- Se o agente está a funcionar ou não responde.
- Desinstalar…
- Ocultar este ícone. O agente continua a funcionar na mesma; o ícone volta da próxima vez que iniciares sessão.
Agente BolloPrint, no menu Iniciar, que também abre a sua página.

A página do agente só abre a partir desse mesmo PC: ninguém da tua rede nem de fora a pode ver.

Não é preciso ter a sessão do Windows aberta. O agente é um serviço: com o PC ligado, funciona mesmo que ninguém tenha iniciado sessão, e volta sozinho depois de cada reinício.

Atualizá-lo

Não tens de fazer nada. Quando sai uma versão nova, o agente descarrega-a, confirma que é nossa e reinicia-se com ela. As tuas impressoras, o seu histórico e a ligação à tua oficina não se tocam.

Se algum dia o quiseres atualizar tu (porque o BolloPrint te avisa de que o teu agente está atrasado, ou porque to pedimos a partir do suporte):

Descarrega o instalador outra vez, do mesmo sítio: Configurações → Impressoras → Agente local → Novo agente → Windows.
Abre-o e instala-o por cima do que tens. O Windows vai voltar a avisar-te, como da primeira vez.
Prime Seguinte em cada passo: o assistente lembra-se da pasta e da porta que escolheste.

Não é preciso desinstalar antes, nem voltar a ligá-lo: continua a ser o mesmo agente, na mesma oficina.

Mudá-lo de PC ou começar do zero

Reinstalá-lo no mesmo PC (desinstalar e voltar a instalar) não muda nada: o agente guarda quem é no PC, por isso volta ligado e com as suas impressoras.

Levá-lo para outro PC é pôr um agente novo:

Instala-o no PC novo e liga-o, como acima.
Adiciona as tuas impressoras a partir do agente novo. Passam para ele com todo o seu histórico.
No BolloPrint, elimina o agente antigo (menu ⋮ da sua linha → Eliminar).
Desinstala-o do PC antigo.

Se eliminares o agente no BolloPrint enquanto continua instalado, o agente dá por isso em poucos segundos e a sua página volta a oferecer Ligar ao BolloPrint. Se o voltares a ligar, entra como um agente novo.

Desinstalá-lo

Botão direito no ícone do BolloPrint → Desinstalar…, ou em Definições do Windows → Aplicações → Aplicações instaladas, procura BolloPrint Agent e prime Desinstalar.

São removidos o programa, o serviço, o ícone e a sua permissão na firewall. O agente guarda no PC quem é, para o caso de o voltares a instalar aí.

Se não o vais usar mais, elimina-o também no BolloPrint, a partir do menu ⋮ da sua linha em Agente local.

Quando alguma coisa não vai

O que acontece	O que fazer
Não aparece Executar mesmo assim	É o Controlo Inteligente de Aplicações: vê o aviso de O Windows vai avisar-te: é normal, mais acima.
O antivírus bloqueia ou apaga o instalador	Descarrega-o outra vez, só a partir do BolloPrint. Se voltar a acontecer, escreve-nos.
A página do agente não abre	Vê o ícone do BolloPrint com o botão direito. Se disser que não responde, reinicia o PC. Se continuar igual, pode ser que outro programa use a porta: instala o agente por cima e, em Página do agente, põe 8364.
Ao ligar diz que o link expirou ou já foi usado	A confirmação dura um par de minutos. Volta a premir Ligar ao BolloPrint na página do agente.
Diz que não conseguimos falar com o BolloPrint	O PC não chega à internet, ou uma firewall da empresa ou um proxy corta a saída.
Diz que a oficina não está ativa	Revê a tua subscrição no BolloPrint.
Não aparece a oficina a que o queres adicionar	Só aparecem as oficinas de que és proprietário. Inicia sessão com essa conta.
Está Online mas não encontra impressoras	O PC está na mesma rede que as impressoras? Uma VPN, a rede de convidados ou um wifi à parte impedem-no. Se não for possível, adiciona-as com Adicionar por IP: funcionam na mesma.
Aparece Sem sinal recente todas as noites	O PC entra em suspensão. Em Definições do Windows → Sistema → Energia, define que nunca entre em suspensão quando estiver ligado à corrente.
Todas as impressoras do agente desligadas de repente	Não são as impressoras, é o PC: está ligado e com internet? Vê o ícone do BolloPrint.