Manual do Persi Chat

Passo a passo de cada função do painel.

Primeiros passos

O painel junta atendimento por chat, agendamento online e lembretes. Para começar, siga a lista da tela Início:

Cadastre seus serviços. Abra Empresa → Serviços e informe nome, preço e duração em minutos.
Mande o link de agendamento. Na tela Início, em Links para o cliente, toque em Copiar ou WhatsApp.
Teste como cliente. Abra o mesmo link, escolha um serviço e marque um horário de teste. Depois cancele pelo CRM → Agenda.

O botão 🏠 Início no topo sempre leva de volta a esta tela. No celular ela abre sobre a lista de conversas.

Empresa, serviços e equipe

Tudo fica em Empresa, nas abas do topo da janela.

Dados da empresa

Nome, logo (endereço de uma imagem em https), descrição, telefone e endereço. O nome e o logo aparecem nas páginas que o cliente abre.

Serviços

Nome e preço (ex.: 50,00).
Duração em minutos (ex.: 40). Ela define quantos horários o serviço ocupa na agenda. Sem duração, vale 60 minutos.

Profissionais

Se houver ao menos um profissional cadastrado, o cliente escolhe com quem quer marcar e cada pessoa tem agenda própria. Sem profissionais, existe uma agenda única. O campo Comissão (%) já fica guardado para o controle financeiro.

Agenda (horários)

Para cada dia da semana escreva o intervalo de atendimento, como 09:00-18:00, ou Fechado. Os campos de bloqueios e férias são só texto de apoio: eles ainda não bloqueiam horários no agendamento online.

Agendamento online

O cliente abre o link, e escolhe o serviço, o profissional (se houver), o dia e o horário. Depois informa nome e WhatsApp com DDD e confirma.

Regra	Como funciona
Horários livres	Saem da janela do dia, de 30 em 30 minutos, descontando o que já está marcado.
Dois clientes no mesmo horário	Não acontece. O segundo recebe a mensagem de que o horário não está mais disponível.
Hoje	Só aparecem horários com pelo menos 30 minutos de antecedência.
Até quando	Até 90 dias à frente.
Quem é o cliente	O WhatsApp identifica a pessoa. Se ela voltar a marcar com o mesmo número, o cadastro é reaproveitado.

Cada agendamento aparece em CRM → Agenda e na lista Agenda de hoje do Início.

Mudar ou cancelar

Abra CRM → Agenda e toque no compromisso. Você pode mudar título, data, hora, duração, status e observações, ou usar Cancelar compromisso. Se o novo horário já estiver ocupado para o mesmo profissional, o sistema avisa e não salva. O horário cancelado volta a ficar livre para o cliente.

Links para o cliente

Na tela Início, cada link tem os botões Copiar, WhatsApp (abre o WhatsApp com a mensagem pronta) e Abrir.

Agendamento: o cliente marca sozinho.
Serviços e preços: página com a lista de serviços, a equipe e botões para agendar e se cadastrar.
Cadastro de cliente: o cliente informa nome e WhatsApp. Ele entra no CRM com a etiqueta cadastro-online.
Chat de atendimento: conversa com o cliente pelo painel.

Em Boas-vindas para cliente nova, toque em Copiar mensagem para colar no WhatsApp uma mensagem única com agendamento, serviços e cadastro.

Os links usam um código da sua empresa. Quem tem o link consegue abrir as páginas, mas só vê nome, logo, serviços, preços e equipe.

Lembretes

O bloco Lembretes lista os horários de hoje e de amanhã que têm WhatsApp do cliente.

Toque em Lembrar no WhatsApp.
O WhatsApp abre com a mensagem pronta, já com nome, dia e hora.
Confira e envie. O botão passa a mostrar Enviado ✓.

Nada é enviado sozinho. Você sempre confirma no seu WhatsApp. A marca "Enviado" fica salva só neste navegador.

Mensagens editáveis

Em Empresa → Mensagens você escolhe o texto de cada situação: lembrete de horário, convite para agendar, boas-vindas e resgate de cliente. Campo vazio volta ao texto padrão.

Escreva	O sistema troca por
`{nome}`	Primeiro nome do cliente
`{data}`	"hoje", "amanhã" ou "em dd/mm/aaaa"
`{hora}`	Horário do atendimento
`{empresa}`	Nome da sua empresa
`{link}`	Link de agendamento
`{vitrine}`	Link de serviços e preços
`{cadastro}`	Link de cadastro
`{dias}`	Dias desde a última visita (resgate)

O campo Dias sem retorno para entrar no resgate define quando um cliente vira "sumido". O padrão é 45 dias.

Financeiro e repasse

Abra 💰 Financeiro no topo. A tela mostra entradas, saídas, saldo, taxas de pagamento e o número de lançamentos do período. Por padrão o período é o mês atual.

Passo a passo

Configure as taxas em Empresa → Pagamento e taxas: taxa fixa do PIX (em reais), taxa do débito e taxa do crédito para cada número de parcelas (em %). Campo em branco vale zero.
Defina a comissão de cada pessoa em Empresa → Profissionais → Comissão (%). Se deixar em branco, o sistema não assume nenhum valor: nada é separado para repasse, o lançamento mostra um aviso e o repasse marca "sem comissão definida". Para quem fica com tudo, escreva 100.
Receba o atendimento: em CRM → Agenda, toque no compromisso, preencha Receber pagamento (o valor já vem do preço do serviço) e toque em Receber e concluir. O sistema registra a entrada e marca o atendimento como concluído.
Lançamentos avulsos: use + Nova entrada (venda sem agendamento) e + Nova despesa (aluguel, material etc.).

Como o repasse é calculado

A taxa do meio de pagamento é descontada do valor recebido. A comissão da profissional é o percentual dela sobre o valor recebido. Se em Descontar a taxa antes de calcular a comissão você escrever sim, o percentual incide sobre o valor já sem a taxa. O que sobra fica no salão.

Exemplo	Resultado
Corte de R$ 100,00 no crédito à vista (taxa de 3%), comissão de 50%, desconto da taxa ligado	Taxa R$ 3,00 · comissão R$ 48,50 · fica no salão R$ 48,50

Abas da tela

Lançamentos: lista com filtros por período, tipo, profissional, forma de pagamento e busca por descrição ou cliente.
Repasse: por profissional, quanto foi recebido, as taxas, a comissão a repassar e o que fica no salão. Lançamentos feitos sem comissão definida aparecem com o aviso ⚠.
Caixa do dia: fechamento de um dia: entradas por forma de pagamento (PIX, dinheiro, débito, crédito) com as taxas, as saídas e o saldo após taxas. Há também a conferência do dinheiro: informe quanto você contou na gaveta e o sistema mostra se sobra ou falta em relação ao esperado (dinheiro recebido menos despesas pagas em dinheiro). Use "Pago em" ao lançar uma despesa para ela entrar nessa conta. O botão Copiar resumo leva o fechamento para o WhatsApp.
Gráfico: entradas e saídas dia a dia.

Recibo para o cliente

Na lista de lançamentos, toque em Recibo ao lado de qualquer entrada. Abre uma página com empresa, valor, cliente, serviço, forma de pagamento e data. Você pode imprimir, copiar o texto ou, quando o cliente veio de um agendamento (com WhatsApp cadastrado), enviar pelo WhatsApp. Entradas estornadas mostram a marca "ESTORNADO". O recibo não é nota fiscal.

Estornar, editar e exportar

Estornar tira o lançamento dos totais, mas ele continua na lista, marcado como estornado. Estornar uma entrada de atendimento libera o atendimento para ser recebido de novo.
Editar vale só para despesas. Se errou numa entrada, estorne e lance de novo.
Exportar CSV baixa o que está filtrado, em formato que abre no Excel e no Google Planilhas.

PIN de segurança

Em 🔒 PIN você ativa um código de 6 números (sem repetições nem sequências). Depois disso, o Financeiro só abre com o PIN, e o acesso fica liberado por 30 minutos. Após 5 erros seguidos, o sistema espera alguns minutos antes de aceitar novas tentativas. Para alterar ou remover, é preciso informar o PIN atual.

O PIN protege o Financeiro, mas quem tem a senha do painel entra no resto do sistema normalmente. Se esquecer o PIN, entre em contato com o suporte.

Clientes e CRM

CRM → Contatos: todos os contatos, com etiquetas e etapa do funil.
CRM → Agenda: calendário mensal, semanal e diário com os compromissos.
Início → Clientes: quantos clientes novos entraram no mês e quem está sem voltar. Para cada um, Chamar de volta abre o WhatsApp com a mensagem de resgate.

Um cliente conta como "sumido" quando já teve um atendimento, não tem horário futuro e a última visita passou do prazo configurado.

Atendimento com IA

O botão 🤖 Bot liga ou desliga as respostas automáticas no chat. Ele também é o interruptor mestre do robô do WhatsApp (extensão, veja a seção abaixo): com o Bot desligado, o robô do WhatsApp para em até 30 segundos. Dá para desligar de qualquer lugar, até pelo celular.

Ligado: a IA responde livremente e também ajuda o cliente a agendar dentro da conversa.
Desligado: o chat conduz uma conversa guiada, com perguntas padrão e sem IA (veja abaixo).

O agendamento online e os lembretes funcionam do mesmo jeito nos dois modos. As instruções de atendimento da IA ficam em Empresa → Empresa.

Conversa guiada (bot desligado)

Na primeira mensagem o cliente recebe um menu e responde com o número da opção:

Agendar um horário: o chat pergunta o WhatsApp (para reconhecer quem já é cliente), o nome, o serviço, o profissional (se houver), o dia e o horário. Mostra um resumo e só agenda depois do "sim". Quem já foi identificado não precisa repetir telefone e nome.
Ver serviços e preços: lista tudo o que está em Empresa → Serviços.
Falar com a equipe: o chat para de responder e a conversa fica com você, pelo painel. O cliente pode enviar menu para voltar às opções.

A qualquer momento o cliente pode enviar menu para recomeçar ou cancelar para sair do agendamento. Se a conversa ficar parada por mais de 6 horas, ela recomeça pelo menu. Os agendamentos feitos assim aparecem na agenda do painel como os demais.

Extensão do WhatsApp

A extensão para Chrome coloca o Persi Chat dentro do WhatsApp Web: ficha do cliente, CRM, Kanban, calendário, mensagens prontas, robô e envio em massa. Funciona no computador, com o Chrome (ou Edge) e o WhatsApp Web abertos. O guia completo com imagens de cada passo está em /extensao.

Instalar

Na tela de canais, clique em WhatsApp (QR code) e depois em Baixar extensão (.zip).
Extraia o arquivo (botão direito → Extrair tudo). Vai sair uma pasta: guarde-a num lugar fixo, como Documentos, e não apague nem mova depois. O arquivo .zip não precisa ser guardado.
No Chrome, abra chrome://extensions e ligue o Modo do desenvolvedor.
Clique em Carregar sem compactação e escolha a pasta (a que tem o arquivo manifest.json dentro). O Chrome não instala o arquivo .zip.
Clique no ícone da extensão, entre com o usuário e a senha do Persi Chat, abra o WhatsApp Web e dê F5. A barra do Persi Chat aparece à esquerda.

Para atualizar: baixe de novo, troque os arquivos da pasta, clique no botão de recarregar do cartão em chrome://extensions e dê F5 no WhatsApp Web. O número da versão aparece no rodapé do painel.

O que tem na barra

💬 Conversa: a ficha de quem está na conversa aberta: etapa do funil, etiquetas, notas, próximos horários e histórico. Quem não está no CRM pode ser cadastrado com um clique. Há também mensagens prontas (lembrete, link de agendamento, boas-vindas, chamar de volta) e as respostas rápidas. Elas só vão para o campo de digitar: você confere e envia.
👥 CRM: a lista de clientes, com busca. Clique num cliente para ver e editar a ficha.
🗂️ Kanban: colunas Novo, Negociando, Agendado, Fechado e Perdido. Arraste o cliente para outra coluna.
📅 Calendário: os horários marcados, por mês e por dia. Para marcar ou mudar um horário, use a agenda do painel.
🤖 e 🗓️: atalhos que colocam no campo de digitar o link do Persi Chat (o agente) e o link de agendamento.
🤖 Robô, 📣 Envio em massa e ⚙️ Configuração: explicados abaixo.

O botão P no topo da barra e o – do painel recolhem tudo; os ícones continuam visíveis.

Leitura do WhatsApp (liga o robô, a sincronização e o envio em massa)

Em Configuração → Leitura do WhatsApp há três níveis: Desligada (padrão, mais segura), Básica (só a última mensagem) e Completa (também o telefone). O robô, a sincronização e o envio em massa pedem a Completa. Se as mensagens pararem de chegar no WhatsApp Web, volte para Desligada.

Ao ligar a leitura, a extensão carrega a biblioteca aberta wa-js (WPPConnect, licença Apache-2.0). Ela traz um rastreador do Google Analytics, que a extensão desliga antes de a biblioteca iniciar.

Robô

O robô entra no seu lugar quando você demora a responder, com a mesma IA e as mesmas regras do chat do site.

Em Configuração → Robô, defina a espera mínima e máxima, em minutos (até 24 horas), e o limite de respostas por hora.
Marque quem o robô responde (uma ou mais caixas): números não salvos na sua agenda (padrão), números salvos, ou quem tem etiqueta do CRM, salvo ou não (escreva as etiquetas na lista). Ele responde se qualquer caixa marcada se aplicar. Nenhuma marcada = não responde ninguém.
Clique em Salvar no fim da tela, vá na aba Robô e clique em Ligar o robô (ele pede confirmação).

Cada mensagem nova de quem se enquadra entra numa fila de espera. Se você responder antes, a conversa sai da fila e o robô não entra.
Funciona em qualquer conversa, aberta ou não, enquanto o WhatsApp Web estiver aberto. Recarregar o WhatsApp Web zera as esperas em andamento.
Não responde em grupos nem a mídias. Quem não se enquadra nas regras não tem nada gravado no CRM.
Na aba Conversa há Pausar robô nesta conversa.
A linha Última decisão da aba Robô explica por que ele respondeu, esperou ou não respondeu.
O botão 🤖 Bot do painel é o interruptor mestre: desligado ali, o robô para.

Envio em massa

Em Envio em massa, escreva o nome da campanha e a mensagem (use {nome}, {empresa} e {link}).
Escolha a etapa ou escreva uma etiqueta. A tela mostra quantos clientes e quais vão receber antes de criar. Só recebem clientes do CRM com telefone válido.
Clique em Criar campanha e depois em Iniciar. A tela pede confirmação.

A extensão envia um por vez, com intervalo aleatório e limite diário (ambos em Configuração). Número que não existe no WhatsApp é acusado e a campanha é pausada.
Há Parar a qualquer momento e Retomar depois. O botão Apagar campanha pede confirmação.
O computador, o Chrome e o WhatsApp Web precisam ficar abertos durante o envio.

Conversas no painel do Persi Chat

Em Configuração → Conversas no Persi Chat, ligue para as conversas do WhatsApp aparecerem na lista de conversas do painel. Por padrão copia só clientes já cadastrados no CRM; conversas pessoais e grupos não são copiados. Cada mensagem nova é copiada sozinha. O botão Sincronizar a conversa aberta agora envia as últimas 30. Responder pelo painel não envia para o WhatsApp.

Atenção: ferramentas que usam o WhatsApp Web fora da API oficial, como esta, podem levar ao bloqueio do número. Comece devagar, com poucos envios e esperas longas, e teste primeiro com um número seu.

Problemas comuns

O painel pede para entrar: clique no ícone da extensão e entre de novo. O acesso dura 30 dias.
O Chrome diz que o manifesto está ausente: você escolheu a pasta errada. Escolha a que mostra o manifest.json logo ao abrir, nunca o .zip.
O robô não responde: abra a aba Robô e leia a Última decisão. As causas mais comuns: a leitura não está em Completa, o contato não se enquadra nas caixas marcadas, o Bot do painel está desligado ou a configuração não foi salva.
A barra não aparece: confira se a extensão está ligada em chrome://extensions e dê F5 no WhatsApp Web.

Dúvidas e limites

O cliente diz que não aparece horário.

Confira se o dia não está como Fechado, se o serviço tem duração cabível dentro da janela e se não há outro compromisso no horário. Hoje só aparecem horários com 30 minutos de antecedência.

A página diz que não há serviços.

Cadastre ao menos um serviço em Empresa → Serviços.

Posso mandar lembretes automáticos?

Os lembretes do painel (tela Início) continuam manuais: o botão abre o WhatsApp com a mensagem pronta e você confirma o envio. Já a extensão do WhatsApp pode enviar sozinha, com o robô e o envio em massa, mas só depois que você liga e confirma. Isso aumenta o risco de bloqueio do número, então use com limites baixos.

Que dados do cliente ficam guardados?

Nome, WhatsApp e os horários marcados. As páginas públicas não mostram dados de outros clientes.

Estava digitando em Empresa e a tela atualizou.

O que você digita na aba Empresa fica guardado como rascunho neste aparelho. Ao voltar para a mesma aba, o texto reaparece com o aviso "Rascunho recuperado". Clique em Salvar (ou em Adicionar, nas listas) para gravar de verdade.

Troquei o código dos links.

Os links antigos deixam de funcionar. Copie de novo na tela Início.