Manual do usuário — Ink Agenda
Primeiro acesso, equipe e perfis, agenda do dia, calendário, clientes, orçamentos, financeiro, painel de resultados, mensagem ao cliente, backup, atualização e identidade visual.
Visão geral
O Ink Agenda é um aplicativo desktop para profissionais com hora marcada: estúdios de tatuagem, consultórios odontológicos e espaços de beleza. Agenda, clientes, orçamentos, entradas e saídas e o desempenho do negócio, com um executável e três perfis — Tatuagem, Odontologia e Beleza — que adaptam paleta e vocabulário (sessão/consulta/procedimento). Os dados ficam no seu computador (SQLite local). O app funciona offline e não faz conexão em segundo plano: a única conexão é a verificação manual de atualizações, que envia apenas a versão do app e o sistema operacional — nunca dados de clientes. Veja onde ficam os seus dados.
O menu inferior tem as abas Hoje, Calendário, Finanças, Dashboard, Orçamentos, Clientes, Usuário, Config e Sair. As abas visíveis dependem do perfil de acesso: veja Equipe e perfis.
A aba Config reúne, nesta ordem: Identidade e Visual do Posto, 1. Backup do estúdio (.inkbak), 2. Desastre e Recovery (CSV em GZIP), 3. Usuários e perfis (somente o responsável) e 4. Atualizações.
Valores em reais (R$ 350,00) e datas no formato brasileiro (07/10/2026) na tela, no gráfico e no PDF.
Requisitos e instalação
- Windows 10 ou 11, 64 bits, com setup (
.exe) ou ZIP portátil; ou Linux Ubuntu/Debian com o pacote.deb. Não precisa instalar Java: o runtime vem no pacote. - Downloads na página de Download. Passo a passo: Instalação Windows e Instalação Linux.
- A janela cabe em telas de 1366×768 e pode ser redimensionada.
Dados em %LOCALAPPDATA%\: banco agenda.db, backup automático em backups\ e registro técnico em logs\.
Primeiro acesso e login
O app não traz usuário de fábrica. Na primeira abertura ele vai direto ao Passo 1 de 3 — Identificação: escolha o perfil do espaço (Tatuagem, Odontologia ou Beleza) e informe o celular do responsável; depois vem o Passo 2 de 3 — Senha e recuperação local (perfil de acesso, senha de 8+ caracteres, frase de recuperação de 10+ caracteres e, recomendado, 8 códigos de emergência). Só então aparece o login com celular e senha. Detalhes em Primeiro acesso.
Esqueci minha senha gera um código de 6 dígitos válido por 15 minutos, só neste computador, depois da frase de recuperação.
Lembrar da minha senha guarda a credencial neste computador por até 12 horas (no Windows, protegida pelo DPAPI); ao sair, o lembrete é removido. Para apagar antes, use Usuário → Segurança → Remover senha lembrada.
Equipe e perfis
O responsável pela instalação é o administrador: vê todas as abas e gerencia a equipe. As demais pessoas entram com celular e senha próprios, cadastrados por ele em Config → 3. Usuários e perfis → Gerenciar usuários e perfis….
- Administrador (responsável): vê Hoje, Calendário, Finanças, Dashboard, Orçamentos, Clientes, Usuário e Config; gerencia usuários e pode enviar mensagens. A credencial dele fica fora do banco e não é cadastrada como usuário da equipe.
- Agenda: vê Hoje, Calendário, Clientes e Usuário. Não vê Finanças, Dashboard, Orçamentos nem Config, e os valores e o check Pagou não aparecem nos agendamentos. Pode enviar mensagens ao cliente.
- Financeiro: vê Hoje, Calendário, Finanças, Dashboard, Orçamentos, Clientes e Usuário. Não gerencia usuários nem envia mensagens ao cliente.
Cadastrar e manter a equipe
- Antes da primeira pessoa, defina a frase de recuperação na aba Usuário. Sem ela, o app não libera o cadastro — é o que impede a recuperação da senha do responsável só pelo código na tela.
- Adicionar usuário: nome, celular, perfil (Agenda ou Financeiro) e senha de pelo menos 8 caracteres. No fim, entregue o celular e a senha à pessoa; o primeiro acesso dela é pelo login comum.
- Desativar tira o acesso sem apagar o histórico; Ativar devolve. Redefinir senha define uma nova senha para a pessoa.
- Os perfis separam o que cada pessoa vê dentro do Ink Agenda. Quem usa a mesma conta do Windows continua com acesso ao arquivo de dados do computador.
Backup: dossiês feitos a partir da 2.2 guardam a equipe, e os logins continuam válidos após restaurar. Ao restaurar um backup anterior à 2.2, os usuários da equipe precisam ser cadastrados de novo; o responsável continua entrando com o mesmo celular e senha.
Identidade visual do posto
A seção Identidade e Visual do Posto, no topo de Config, troca a especialidade do aplicativo: Tatuador (lilás), Dentista / Saúde (turquesa) ou Beleza & Estética (dourado).
- A troca é imediata: paleta, título da janela e vocabulário (sessão/consulta/procedimento, cliente/paciente, estúdio/consultório/espaço). Não é preciso reiniciar nem reinstalar.
- A escolha vale para esta instalação e fica gravada. Sem escolha gravada, o padrão é Tatuador.
- Trocar a identidade não altera os dados existentes. O catálogo financeiro sugerido por especialidade só nasce em instalações novas.
Hoje e calendário
A aba Hoje mostra os agendamentos do dia, do mais cedo ao mais tarde, com o intervalo de horário (ex.: 14:30–16:00) e o valor.
Novo agendamento
- Clique em ✚ Novo agendamento. Campos: cliente (nome e celular), data, horário, duração e valor.
- Horário: escolha na lista (de 15 em 15 minutos, das 06:00 às 23:45) ou digite, por exemplo,
9:30ou1430. - Duração: 30 min, 1 h, 1 h 30, 2 h, 3 h, 4 h, 5 h, 6 h ou 8 h. Agendamentos antigos ficam com 1 h.
- O app não deixa sobrepor sessões: se o intervalo encostar em outra sessão, mostra o conflito e pede outro horário.
Check “Pagou”
Em cada sessão da lista do dia, marque Pagou quando o cliente pagar. O valor entra no Financeiro e no Dashboard como recebimento; desmarcar volta a sessão para pendente.
Calendário
A aba Calendário mostra o mês; clique em um dia para ver e editar as sessões daquele dia.
Clientes
A aba Clientes lista todos os clientes com nome, telefone, contato preferido (WhatsApp, ligação, Instagram, e-mail ou outro) e situação (ativo ou inativo).
- Buscar: por nome (com ou sem acento) ou pelos dígitos do telefone.
- Novo cliente e Editar (ou duplo clique na linha): nome, celular, outro telefone, contato preferido, ativo e observações.
- Não aceita dois clientes com o mesmo telefone.
- Ao editar nome ou telefone, as sessões desse cliente na agenda são atualizadas.
Orçamentos
A aba Orçamentos lista os orçamentos com cliente, descrição, valores, validade, situação e origem (manual, agendamento ou ficha do cliente).
- Novo orçamento: cliente (existente ou novo, com telefone), descrição, valor total, sinal, validade (padrão: 15 dias), situação e observações.
- Editar (ou duplo clique): orçamentos criados nesta aba. Os que vêm de um agendamento são ajustados pelo agendamento, na aba Hoje.
Finanças
Registre entradas (sessões, retoques, vendas) e saídas (materiais, aluguel, contas) com descrição, valor, data e categoria. O app calcula o saldo e mostra o gráfico anual.
- Novo lançamento, Alterar e Excluir na lista de movimentações.
- Exportar PDF do balanço: balanço mensal com receitas, despesas, resultado e despesas por categoria. O mês sai em português (ex.: “outubro de 2026”).
Dashboard (resultados)
A seção Resultados do Dashboard mostra:
- Faturamento do mês, ticket médio do mês (faturamento ÷ entradas recebidas) e saldo do mês (faturamento menos saídas);
- Faturamento do ano, média mensal do ano (faturamento ÷ meses até agora) e ticket médio do ano.
Faturamento segue a regra do Financeiro: recebimentos (inclusive os das sessões marcadas como pagas) mais entradas lançadas à mão. Os números atualizam ao abrir a aba.
Mensagem ao cliente
O Ink não tem conta de WhatsApp nem de Telegram e não envia mensagens sozinho: ele abre o aplicativo instalado no computador com o texto pronto, e você confere e envia. O Ink não recebe as respostas nem guarda o conteúdo da conversa.
Configurar o envio
Na aba Usuário → WhatsApp e Telegram → Configurar envio, a configuração tem 4 passos:
- O app explica o limite: a conversa fica no seu aplicativo de mensagens.
- Escolha WhatsApp ou Telegram. Você pode trocar depois, sem perder a configuração.
- Confirme o celular de quem está logado agora como remetente — é o número que o cliente verá.
- O app abre uma mensagem de teste para o seu próprio número. Se o aplicativo não abrir, instale-o e abra-o uma vez no computador; depois repita o teste.
Enviar a partir do agendamento
- Na aba Hoje, o botão Mensagem aparece em cada agendamento para o administrador e para o perfil Agenda. O perfil Financeiro não vê o botão.
- Escolha o modelo Confirmar horário, Remarcar ou Alinhar detalhes. O texto pode ser editado antes de abrir.
- Abrir no WhatsApp abre a conversa do cliente direto; o celular do cliente precisa estar completo, com DDD. Abrir no Telegram abre a tela de compartilhar — escolha o contato na lista, porque o Telegram não permite abrir a conversa do cliente diretamente.
- Copiar mensagem leva o texto para a área de transferência, para colar em qualquer conversa.
Backup e restauração
Backup com senha (.inkbak)
Em Config → Backup do estúdio:
- Salvar backup com senha: você escolhe pasta e nome (sugestão
backup_AAAA-MM-DD_HH-MM.inkbakemDocumentos\AgendaInk\Backups). Nada é sobrescrito: se o nome existir, o app grava “(2)”, “(3)”… O arquivo é criptografado com a senha (mínimo 8 caracteres). Sem a senha ele não abre. No fim, o app mostra o caminho salvo. - Restaurar backup: escolha o arquivo e digite a senha. Backups da v2.0.0 (sem senha) também restauram. O app confere o arquivo antes de trocar os dados e fecha ao terminar; abra de novo. Backups anteriores à 2.2 não guardam os usuários da equipe: eles precisam ser cadastrados de novo, e o app avisa antes de trocar os dados.
O app lembra você quando o último backup com senha tem mais de 7 dias.
Backup automático
Ligado de fábrica: a cada hora e ao fechar o app, uma cópia agenda_*.db.gz vai para %LOCALAPPDATA%\. Ficam as 30 mais recentes. Essas cópias ficam no mesmo computador e não têm senha. Para desligar, desmarque “Fazer backup automático a cada hora e ao fechar” em Config → Backup do estúdio.
Backup CSV
Em Config, a exportação CSV (compactada e criptografada com senha) leva agendamentos e lançamentos do Financeiro. Clientes, orçamentos, cobranças e recebimentos ficam só no .inkbak. Importar o mesmo arquivo duas vezes não muda nada; horários em conflito viram aviso e lista de ignorados.
Atualização do aplicativo
A verificação é manual: em Config → 4. Atualizações → Verificar atualizações. Ao abrir, o app não faz nenhuma conexão. Na verificação, ele envia apenas a versão do app e o sistema operacional — nunca dados de clientes.
- Quando há versão nova, o app mostra o número e o que mudou, com Baixar e abrir instalador e Abrir página de download.
- O download é conferido pelo SHA-256 do manifesto assinado com a chave embutida no aplicativo. Se a assinatura ou o hash não conferirem, o app avisa e não abre o instalador.
- O aplicativo não baixa nem instala sozinho: o instalador aberto segue as telas do Windows e pode pedir permissão de administrador.
- Versões 2.1.0 e 2.2.0: o botão de download falhava por um redirecionamento do GitHub. Quem está em uma dessas versões baixa a 2.2.1 uma vez pela página de download; da 2.2.1 em diante a atualização volta a funcionar pelo próprio aplicativo.
Problemas comuns
- ZIP/EXE não inicia — Confirme que o arquivo veio do download oficial e confira o SHA256 antes de executar.
- Horário já ocupado ao salvar — O app impede sobrepor sessões. Escolha outro horário, encurte a duração ou edite a sessão existente.
- “Senha incorreta” ao restaurar — Use a senha digitada ao salvar aquele backup (não é a senha de login, a menos que você tenha usado a mesma).
- Uma aba não aparece — As abas dependem do perfil. O perfil Agenda não vê Finanças, Dashboard, Orçamentos nem Config; o Financeiro não vê a gestão de usuários. O responsável ajusta o perfil em Config → 3. Usuários e perfis.
- O botão Mensagem não aparece no agendamento — O envio ainda não foi configurado para o celular de quem está logado (Usuário → WhatsApp e Telegram) ou o perfil é Financeiro.
- A mensagem não abre o WhatsApp ou o Telegram — Instale o aplicativo no computador e abra-o uma vez; depois repita o teste em Usuário → WhatsApp e Telegram. Se o cliente tiver celular sem DDD, o WhatsApp não encontra a conversa.
- Atualização “não foi possível baixar o instalador” — Nas versões 2.1.0 e 2.2.0 esse botão falhava. Baixe a 2.2.1 pela página de download uma vez; a partir dela a atualização funciona pelo próprio aplicativo.
- Precisa de ajuda — O registro técnico fica em
%LOCALAPPDATA%\(sem senhas, telefones ou e-mails). Fale pelo Canal de feedback.CaraCore\ AgendaInk\ logs\