PASSO 01

Prepare o cadastro do cliente

Abra Clientes. Se a pessoa ainda não estiver cadastrada, inicie um novo cadastro, preencha os dados e clique em Criar cliente. Se já existir, abra o cadastro para conferir sua situação.

Somente a situação Cliente permite criar projetos. Cadastros como Potencial ainda não aparecem na seleção de cliente do projeto.

PASSO 02

Defina os dados do projeto

Em Projetos, abra a criação de um novo projeto. Escolha o cliente, dê um nome que identifique o imóvel e confira o Status inicial.

O status é definido pela equipe e pode ser alterado depois. Continue no formulário para escolher os modelos antes de criar.

PASSO 03

Escolha o roteiro de etapas

Em Modelo de etapas, selecione um modelo ativo e confira as etapas e subetapas da prévia. Esse roteiro será copiado para o projeto.

Alterar um modelo depois não altera a cópia do projeto. A troca do roteiro na ficha depende de ele ainda não ter andamento, observações ou previsões registradas; o aplicativo informa quando houver bloqueio.

Se não houver um modelo ativo disponível, prepare um em Projetos → Modelos de etapas e volte à criação.

PASSO 04

Crie e organize as compras

Se quiser começar com uma lista pronta, escolha um Modelo de compras. Caso contrário, deixe Sem modelo. Confira os dados e clique em Criar projeto.

Na ficha do projeto, abra a aba Compras. Use Adicionar item para incluir itens ou Aplicar modelo para adicionar os itens de um modelo à lista.

Aplicar modelo adiciona itens à lista existente. Confira o que já está cadastrado antes de aplicar novamente.

Os itens recebidos entram no resumo de compras do projeto. Esse indicador acompanha recebimento; ele não significa que a instalação foi concluída.

Buscar, filtrar e exportar a carteira

1. Abra Clientes. Digite o nome em Buscar nesta carteira.
2. Use Todos, Potenciais ou Clientes para restringir a situação.
3. Abra o cadastro encontrado para ver sua ficha.
4. Para exportar, confira o filtro e use Exportar lista. A exportação segue os resultados exibidos.

Confira a carteira antes de cadastrar outra pessoa. Filtros e busca podem ocultar um cadastro que já existe.

02 · CADASTRO

Crie o cliente

Clique em Novo cliente. Preencha Nome completo e WhatsApp, obrigatórios, e escolha o status. Complete E-mail, Identificação e Imóvel quando tiver essas informações. Ao terminar, clique em Criar cliente.

Recorte de Contato e Status. O formulário completo também tem Identificação e Imóvel.

03 · FICHA

Consulte e atualize os dados

A ficha reúne dados cadastrais, contatos adicionais, projetos e contratos. Use Ver dados completos · identificação e endereço para expandir as informações. Para corrigir o cadastro, clique em Editar dados e finalize com Salvar alterações.

Se o cliente já tem projetos, o status permanece Cliente: o app não permite voltar para Potencial.

Criar e acessar projetos pela ficha

1. Confira se o cadastro está na situação Cliente.
2. Use Novo projeto no cabeçalho: o formulário já recebe esse cliente.
3. Preencha os dados, escolha o modelo de etapas, confira a prévia e crie o projeto.
4. Para abrir um projeto existente, vá à seção Projetos da ficha e use a ação de abrir.

O app cria o projeto ligado ao cliente. Este fluxo não transfere um projeto existente entre clientes.

Editar os dados do cliente

1. Abra a ficha e clique em Editar dados.
2. Atualize contato, identificação ou imóvel. Confira o Status.
3. Clique em Salvar alterações para gravar. Cancelar abandona a edição; se houver alterações, o app pede confirmação.

Com projetos associados, o status permanece Cliente. O cadastro não pode voltar para Potencial.

Adicionar, editar e remover contatos

1. Na ficha, encontre Contatos envolvidos e escolha adicionar contato.
2. Preencha Nome e WhatsApp; Vínculo opcional descreve a relação com o cliente. Clique em Salvar.
3. Use a ação de edição do contato para corrigir seus dados.
4. Na edição, Remover solicita confirmação antes de excluir o contato.

Um contato não ganha login e não é adicionado automaticamente a um grupo de WhatsApp.

Formulário do cliente: do link ao cadastro

Use a Solicitação de dados na ficha para pedir as informações ao cliente. A resposta fica disponível para conferência: o cadastro só muda depois que a equipe seleciona e confirma o que deseja aplicar.

1. Equipe: gerar e copiar o link na ficha.
2. Cliente: preencher seus dados e contatos pelo link.
3. Equipe: abrir Conferir e selecionar as alterações.
4. Equipe: confirmar Aplicar selecionados.

Depois de testar

No aplicativo, confira a validade do link e encaminhe o endereço real pelo canal escolhido. Após a resposta, compare os valores atuais com os recebidos. Campos não selecionados permanecem como estavam.

Renovar ou desativar um link →Conferir e aplicar respostas →

Renovar ou desativar o link

1. Abra Solicitação de dados na ficha do cliente.
2. Para trocar o endereço, clique em Gerar novo link e confirme. O link anterior é desativado.
3. Copie o novo endereço e compartilhe novamente com o cliente.
4. Para interromper o acesso sem substituí-lo, use Desativar link e confirme.

Renovar exige encaminhar o novo endereço. Um link anterior não deve continuar sendo compartilhado.

Conferir e aplicar dados recebidos

1. Na Solicitação de dados, encontre a resposta recebida e clique em Conferir.
2. Compare No cadastro com Resposta recebida. Marque apenas o que deseja atualizar.
3. Selecione também os novos contatos desejados; contatos duplicados não podem ser adicionados novamente.
4. Clique em Aplicar selecionados e confirme. Dados não marcados permanecem como estavam.
5. Conferir depois fecha a revisão e mantém a resposta pendente.

Se houver conflito porque o cadastro mudou, o campo pode ficar bloqueado. Atualize a revisão antes de continuar.

Gerar um contrato

1. Na ficha, vá a Contratos e clique em Gerar contrato.
2. Confira Pessoa física ou Pessoa jurídica. Revise identificação, endereço e representação conforme o tipo.
3. Se necessário, selecione um Projeto existente. Sem projeto permite preparar um rascunho antes disso.
4. Preencha os dados do imóvel, honorários, cidade, data e parcelas. Confira os valores.
5. Prossiga ao editor e revise as seções antes de visualizar ou baixar o PDF.

Dados do cadastro ajudam a preparar o contrato, mas precisam de conferência. Gerar ou exportar não equivale a assinar.

Editar contrato e revisar seções

1. Abra o documento em Contratos → Abrir.
2. Use Editar em Dados do contrato para ajustar as condições.
3. Selecione a seção desejada e revise seu texto. As edições do documento salvam automaticamente.
4. Após mudar dados que afetam o texto, confira os avisos e use Atualizar trechos afetados.
5. Aguarde o salvamento antes de baixar o PDF.

O modelo padrão e um contrato existente são coisas diferentes. Editar o documento não altera o modelo para os próximos contratos.

Conferir a prévia e baixar o PDF

1. Abra o contrato e clique em Prévia do PDF para conferir o rascunho atual.
2. Revise os dados e o texto. A prévia também permite Abrir em nova aba.
3. Se Baixar PDF estiver desabilitado, complete os campos, salve e resolva os trechos que precisam de atualização.
4. Com o contrato completo e salvo, clique em Baixar PDF.

A prévia pode mostrar um rascunho. A exportação não marca o contrato como assinado. A demonstração abaixo não gera um PDF real.

Editar o modelo padrão de contrato

1. Na área Contratos da ficha, abra Editar modelo padrão quando disponível para seu acesso.
2. Confira os dados da empresa e selecione a seção a editar.
3. Ajuste o texto preservando os trechos entre chaves que são preenchidos em cada contrato.
4. Clique em Salvar modelo e confirme. Confira a versão resultante.

O modelo vale apenas para contratos novos. Contratos já criados não mudam quando o modelo é salvo.

Excluir um contrato

1. Na ficha, identifique o documento correto na lista de contratos; também é possível abrir o documento e usar Excluir no editor.
2. Clique em Excluir e leia a confirmação.
3. Confirme apenas após conferir qual documento será removido. Cancelar mantém o contrato.

Excluir é uma ação destrutiva no aplicativo. Aqui o teste afeta apenas o documento fictício.

Consultar o diário do projeto

1. Na ficha do cliente, localize o projeto desejado e abra-o.
2. Selecione a aba Diário na ficha do projeto.
3. Confira a autoria, a data e as mudanças registradas.

O Diário é do projeto. Não há uma aba de diário na ficha do cliente, nem uma etapa manual para publicar cada mudança nesse histórico.

Excluir um cadastro de cliente

1. Abra a ficha e clique em Editar dados.
2. Use a exclusão do cliente e leia a confirmação.
3. Se houver projetos, contratos ou formulários vinculados, o app impede a exclusão.
4. Sem esses vínculos, confirme somente se pretende excluir o cadastro e os contatos adicionais.

Para corrigir nome, telefone ou endereço, use edição. A exclusão não é um atalho para atualizar dados.

Dúvidas comuns

Buscar e abrir projetos

1. Abra Projetos e use a busca para localizar o imóvel.
2. Alterne a visualização entre cards e lista. Abra o projeto desejado.

Confira o nome e o cliente antes de editar.

Criar projeto

1. Clique em Novo projeto. Escolha um cadastro na situação Cliente e informe o nome.
2. Escolha o modelo de etapas e confira a prévia. O modelo de compras é opcional.
3. Defina o Status inicial e clique em Criar projeto.

Os modelos são copiados: alterações futuras no modelo não alteram a cópia do projeto.

Editar dados e status

1. Na ficha, abra Editar projeto.
2. Altere o nome e o Status e clique em Salvar projeto.

Rascunho, Ativo e Concluído são definidos pela equipe. O status não muda automaticamente só porque todas as etapas foram concluídas.

Adicionar, trocar e remover foto

1. Na área de foto, escolha Adicionar foto ou Trocar.
2. Use a opção de envio ou endereço disponível no editor e Salvar foto.
3. Expandir e Minimizar controlam a visualização. Remover pede confirmação.

Uma imagem ilustrativa não é uma foto enviada do projeto.

Entender o resumo e o andamento

1. Abra Andamento para consultar roteiro e ações.
2. Confira Etapas concluídas, Ações pendentes e Compras recebidas.

Compras recebidas indica recebimento dos itens, não instalação. Ações e etapas são indicadores distintos.

Adicionar e editar etapas

1. Em Etapas do projeto, use Adicionar etapa para criar um item do roteiro.
2. Abra a edição da etapa para mudar Nome, Situação, Previsão opcional e Observação.
3. Clique em Salvar etapa.

A etapa nova começa como Não iniciada; situação e previsão são ajustadas depois de adicionar.

Adicionar e acompanhar subetapas

1. Abra uma etapa principal e escolha Adicionar subetapa.
2. Informe o nome e salve. Depois abra a subetapa para definir situação e previsão.
3. Para concluir uma etapa com subetapas abertas, leia a confirmação.

Concluir a etapa principal não conclui automaticamente suas subetapas. As situações delas são preservadas.

Ordenar o roteiro

1. Clique em Ordenar roteiro para ajustar a sequência.
2. Use Subir/Descer dentro do grupo desejado. Também é possível mover na edição da etapa.
3. Salve alterações pendentes antes de mover uma etapa no editor.

Subetapas mantêm seu vínculo com a etapa principal.

Arquivar e restaurar etapas

1. Na edição da etapa, use Arquivar etapa e confirme.
2. A etapa e suas subetapas saem do roteiro visível; o histórico e as ações são preservados.
3. Abra Etapas arquivadas e use Restaurar quando permitido.

O app pode impedir restaurar etapas de um roteiro substituído. Arquivar não apaga o histórico.

Trocar modelo de etapas

1. Em Andamento → Etapas do projeto, clique em Trocar modelo.
2. Se a troca estiver liberada, escolha o modelo ativo e confira etapas e subetapas da prévia.
3. Leia o aviso de substituição e clique em Confirmar troca.

Com andamento, observações ou previsões registradas, a troca pode ser bloqueada. O aviso aparece ao tentar trocar. Compras, fotos e histórico são preservados.

Criar e editar modelos de etapas

1. Na página Projetos, abra Modelos de etapas e escolha Novo modelo.
2. Informe nome e descrição opcional. Adicione etapas e subetapas e ajuste a ordem.
3. Salve o modelo e confira a estrutura antes de usá-lo em um projeto.

O modelo define a estrutura. O andamento é registrado em cada projeto, não na biblioteca.

Duplicar, arquivar e restaurar modelos

1. Na biblioteca, use busca e filtro Ativos/Arquivados/Todos.
2. Duplicar cria outra estrutura para adaptar sem editar a original.
3. Arquivar retira o modelo da seleção de novos roteiros. Restaurar devolve à biblioteca ativa.

Projetos existentes permanecem intactos. Leitor consulta; alterações exigem Admin ou Gestor.

Criar, editar e concluir ações

1. Em Ações do projeto, clique em Nova ação.
2. Informe O que precisa acontecer?, Quem precisa agir, etapa opcional, prazo e observação.
3. Salve. A ação manual pode ser concluída e reaberta pela marcação ou editada pelo botão de abrir.

Pendências automáticas de compra e comprovante são resolvidas no item de compra correspondente.

Organizar as compras do projeto

1. Abra a aba Compras.
2. Use Adicionar item ou Aplicar modelo para montar a lista.
3. Abra o item para ajustar seus dados e situação. Use busca e filtros para acompanhar.

Aplicar modelo adiciona itens à lista atual. Confira o que já existe antes de reaplicar.

Consultar diário e registrar observação

1. Abra a aba Diário para consultar os registros com autoria e data.
2. Em Adicionar observação do projeto, escreva o registro interno.
3. Clique em Registrar observação.

O registro é interno e não envia mensagem ao WhatsApp. Alterações também alimentam o histórico conforme os eventos registrados pelo app.

Buscar e filtrar compras

1. Em Compras, abra Acompanhamento.
2. Busque o item e filtre por Projeto e Situação.
3. Abra a linha para gerenciar a compra do projeto.

Catálogo, modelos e compras do projeto têm funções diferentes. Acompanhamento reúne os itens dos projetos.

Adicionar item ao projeto

1. Use a ação de adicionar ao projeto em Acompanhamento.
2. Escolha o projeto e um Produto do catálogo, ou Item específico deste projeto.
3. Confira Ambiente e Quantidade opcional e clique em Adicionar ao projeto.

Ao escolher produto do catálogo, os dados atuais são copiados. O item específico não vira produto reutilizável automaticamente.

Editar dados, ambiente e quantidade

1. Abra o item em Acompanhamento ou na aba Compras do projeto.
2. Expanda os dados do produto para ajustar nome, categoria, imagem e ambiente.
3. Confira a quantidade e clique em Salvar alterações.

Quantidade pode ficar em aberto. Quando informada, deve ser um número inteiro positivo.

Alterar situação e observação

1. Abra o item e encontre Situação da compra.
2. Escolha Aguardando compra, Compra confirmada, Aguardando comprovante ou Recebido.
3. Registre Observação interna quando necessário e salve.

Não há sequência obrigatória entre situações. Recebido é recebimento do item, não conclusão da instalação.

Editar link, preço e consultar histórico

1. No item, confira Link e preço deste projeto.
2. Atualize o endereço e o preço da oferta e salve.
3. Abra o histórico para conferir as ofertas anteriores.

Link ou preço alterado preserva a oferta anterior no histórico. Preço de referência do catálogo pertence ao link de referência; confira o preço ao trocar de link.

Buscar e cadastrar produto no catálogo

1. Abra Catálogo. Use busca e filtros de Ambiente e Categoria.
2. Use a criação de produto e preencha Nome do produto, ambientes sugeridos separados por vírgula, categoria, imagem e oferta.
3. Clique em Salvar alterações e confira o produto na lista.

Catálogo é a referência reutilizável. Cadastre itens específicos de uma operação no projeto quando não quiser torná-los reutilizáveis.

Editar produto e ver projetos vinculados

1. No Catálogo, abra um produto.
2. Atualize os dados de referência e salve.
3. Consulte Projetos vinculados para identificar onde o produto é usado.

Editar referência do catálogo não reescreve automaticamente os dados já copiados para projetos.

Vincular item ao catálogo

1. Abra o item específico do projeto e salve alterações pendentes.
2. Em Vincular ao catálogo, escolha Produto existente e clique em Vincular produto.
3. Para criar uma referência reutilizável a partir do item, use Salvar no catálogo e confirme.

O vínculo identifica o produto e preserva os dados do projeto. Não sobrescreve o item com os dados do catálogo.

Escolher a imagem do item

1. No item, abra os dados do produto e confira Imagem deste item.
2. Escolha Usar referência do catálogo, Usar imagem própria ou Sem imagem.
3. Ao usar imagem própria, escolha o arquivo ou endereço no editor e salve.

Referência do catálogo depende de um vínculo com um produto. O item pode ter imagem própria sem mudar a imagem do catálogo.

Criar e editar modelo de compras

1. Abra Modelos e crie ou abra um modelo.
2. Informe o nome, organize os ambientes e inclua produtos ou itens específicos.
3. Confira quantidades, ordem e ambientes e clique em Salvar modelo.

Salvar o modelo não altera listas já copiadas para projetos. Modelos de compras não são modelos de etapas.

Organizar ambientes e itens do modelo

1. No editor, use Adicionar ambiente.
2. Renomeie e mova ambientes com Subir/Descer. Recolha ou expanda para revisar os itens.
3. Adicione, ajuste quantidades ou remova itens antes de salvar.

A revisão e as remoções são do modelo em edição, não de uma lista já aplicada a um projeto.

Aplicar modelo a um projeto

1. Na aba Compras do projeto, clique em Aplicar modelo.
2. Escolha o modelo e confira os itens por ambiente. Ajuste nome, quantidade e remova o que não será usado nesta aplicação.
3. Confira avisos sobre coincidências e versão e confirme a aplicação.

A aplicação adiciona itens; não substitui toda a lista. Os ajustes dessa revisão não alteram o modelo original.

Remover item do projeto

1. Abra o item na lista do projeto.
2. Clique em Remover item e confira a confirmação.
3. Confirme somente se deseja retirar essa linha da lista.

Remover uma compra do projeto não é excluir o produto do catálogo.

Excluir produto ou modelo

1. No editor do produto, Excluir produto solicita confirmação.
2. Produtos vinculados a projetos ou modelos não podem ser excluídos.
3. No editor de modelo, Excluir modelo pede confirmação; as listas já copiadas para projetos são preservadas.

Confira o tipo de registro antes de excluir. A demonstração não remove dados do aplicativo.

Selecionar itens e montar o lote

1. Abra Preparar envio e escolha um projeto.
2. Marque os itens aguardando compra com link válido.
3. Troque de projeto para continuar a seleção: cada projeto mantém seus itens e texto.

Preparar ou revisar não envia mensagem. Itens sem link válido ou fora de Aguardando compra não entram na lista disponível.

Editar texto e nome do cliente

1. Em Mensagem para este grupo, ajuste Texto de abertura deste projeto.
2. Use Inserir nome do cliente para incluir a variável.
3. Confira a mensagem do respectivo projeto na revisão.

Cada projeto gera sua própria mensagem com os itens e o nome do cliente correspondente.

Revisar lote e destinos

1. Clique em Revisar lote.
2. Confira projeto, cliente, destino efetivo, itens e texto de cada mensagem.
3. Use Editar seleção e texto deste projeto para corrigir. Remova itens inválidos da seleção.

Aceito pela API não confirma entrega ou leitura. A execução revalida itens, ofertas e destinos no servidor.

Revisar alterações após a seleção

1. Se oferta ou destino mudar depois da seleção, confira o aviso de revisão necessária.
2. Volte à seleção para corrigir ou remover itens inválidos.
3. Quando disponível, Revisei as alterações atualiza a conferência antes do envio.

A revisão antiga não autoriza enviar um conteúdo ou destino que mudou.

Entender modo teste e modo real

1. Confira o aviso no início de Preparar envio e o Destino efetivo.
2. Modo teste usa somente o grupo de testes configurado.
3. Modo real usa o grupo vinculado a cada projeto. Confira a configuração antes de executar.

Sem grupo de testes válido, modo teste bloqueia o envio; não usa um grupo real como alternativa.

Buscar e vincular grupo existente

1. Abra Grupos. Busque projeto, cliente ou grupo e filtre Com grupo/Sem grupo.
2. Use Vincular grupo ou Gerenciar no projeto. Escolha um grupo cadastrado ou preencha a identificação real no cadastro manual.
3. Confira o nome e ID e confirme o vínculo.

Cadastrar identificação não cria um grupo no WhatsApp. O vínculo também é usado na ficha do projeto.

Trocar ou remover vínculo de grupo

1. Em Grupos, use Gerenciar no projeto.
2. Para trocar, selecione o novo destino e confira a confirmação.
3. Para desvincular, use Remover vínculo e confirme. Depois revise lotes preparados.

Remover vínculo não exclui o grupo do WhatsApp. Sem grupo definido, o envio real para o projeto fica pendente.

Criar grupo do projeto

1. Em Grupos, use Criar grupo quando o projeto ainda não tiver vínculo.
2. Revise nome, descrição e participantes com código do país e DDD.
3. Não inclua o número conectado à Z-API: ele já é o criador.
4. Confirme Criar grupo no WhatsApp somente após conferir todos os dados.

Essa operação depende da integração e cria um grupo real no app. Convites privados automáticos estão desativados; nenhum link de compra é enviado ao criar o grupo. Aqui tudo é simulado.

Confirmar e executar lote

1. Revise todo o lote e resolva pendências de itens e destino.
2. Com integração e permissão disponíveis, clique em Enviar lote.
3. Leia se os destinos são de teste ou grupos reais e confirme.
4. Confira os resultados e abra Histórico.

Sem WhatsApp configurado, o app bloqueia a execução e preserva a seleção. Não há envio real nesta documentação.

Consultar histórico e resultados

1. Abra Histórico e confira projeto, grupo, autor, data e resultado.
2. Expanda Ver mensagem para consultar o texto registrado e Ver tentativas para detalhes.
3. Diferencie Preparado, Processando, Aceito pela API, Falhou, Resultado incerto e Bloqueado.

Preparar um lote não cria registro de envio. Aceito pela API não é entregue ou lido.

Repetir falha e autorizar reenvio

1. No Histórico, falhas podem oferecer Tentar novamente quando a integração permitir.
2. Confira projeto e destino na confirmação. O sistema valida os dados novamente.
3. Na revisão de lote, Reenvio de ofertas anteriores permite autorizar ofertas já aceitas.

Resultado incerto não é repetido automaticamente. Confira o resultado antes de repetir; a autorização de reenvio não libera tentativas incertas.

Limpar seleção ou lote

1. Em um projeto, Limpar deste projeto remove somente seus itens selecionados.
2. Limpar lote remove as seleções de todos os projetos após confirmação quando aplicável.
3. Volte aos projetos para preparar uma nova seleção.

Limpar a seleção não remove compras dos projetos e não apaga o histórico de envios.

Buscar e abrir uma rotina

1. Abra Rotinas para consultar a galeria.
2. Use Buscar rotina e o filtro Todas as situações para encontrar o fluxo.
3. Clique no card ou em Ver fluxo para abrir o detalhe.

A galeria explica processos; abrir um card não executa a rotina.

Entender categorias e situações

1. Use a categoria para identificar Projetos, Compras, Histórico ou Comunicação.
2. Em funcionamento indica um processo implementado. Aguardando integração indica dependência externa. Planejada identifica uma proposta ainda não implementada.
3. Consulte o local real de acompanhamento antes de concluir que uma execução ocorreu.

O status do catálogo não é telemetria de execução e não confirma conexão, envio, entrega ou leitura.

Ler o fluxo e acompanhar o resultado

1. No detalhe, leia os blocos Quando, Com/Se e Então.
2. Clique em cada bloco para ver Detalhes da etapa.
3. Leia Onde acompanhar e abra a área correspondente do app.

Diagrama e movimento ilustram o processo. Eles não disparam operações e não substituem o Diário ou o Histórico de envios.

Roteiro inicial do projeto

1. Abra esta rotina na galeria e confira a situação.
2. Selecione os blocos para entender a origem, a condição e o resultado.
3. Confira o roteiro em Andamento dentro do projeto. A preparação também fica registrada no Diário.

O projeto recebe uma cópia das etapas do modelo escolhido na criação.

Lista a partir de um modelo

1. Abra esta rotina na galeria e confira a situação.
2. Selecione os blocos para entender a origem, a condição e o resultado.
3. Confira os itens na aba Compras do projeto. A aplicação do modelo é registrada no Diário.

Um modelo de compras prepara os itens da lista do projeto.

Compras e ações pendentes

1. Abra esta rotina na galeria e confira a situação.
2. Selecione os blocos para entender a origem, a condição e o resultado.
3. Acompanhe as ações no projeto e os resumos em Início. Esses totais são calculados a partir dos dados; não possuem uma execução individual para cada recálculo.

O andamento das compras atualiza as pendências e os resumos do projeto.

Registro de alterações

1. Abra esta rotina na galeria e confira a situação.
2. Selecione os blocos para entender a origem, a condição e o resultado.
3. Consulte a aba Diário dentro do projeto para ver os registros reais. Esta galeria explica o fluxo e não replica o histórico.

Alterações registradas no projeto alimentam seu Diário com a autoria.

Histórico de ofertas

1. Abra esta rotina na galeria e confira a situação.
2. Selecione os blocos para entender a origem, a condição e o resultado.
3. Consulte o histórico de ofertas nos detalhes do item correspondente.

Ao mudar o link ou o preço, a oferta anterior permanece no histórico.

Revisão de links de compras

1. Abra esta rotina na galeria e confira a situação.
2. Selecione os blocos para entender a origem, a condição e o resultado.
3. Confira os avisos na preparação e revisão do lote em Envios. Este fluxo de validação funciona sem uma instância Z-API cadastrada.

Mudanças depois da seleção exigem nova conferência antes do envio.

Envio de links pelo WhatsApp

1. Abra esta rotina na galeria e confira a situação.
2. Selecione os blocos para entender a origem, a condição e o resultado.
3. Consulte os registros reais em Envios. Sem integração disponível, não há envio real. O status desta ficha não confirma conexão ou entrega.

O envio depende da conexão Z-API e da confirmação do lote revisado.

Boas-vindas do projeto

1. Abra esta rotina na galeria e confira a situação.
2. Selecione os blocos para entender a origem, a condição e o resultado.
3. Ainda não há execução desta rotina. Configurar a Z-API, por si só, não habilita este fluxo futuro.

Fluxo futuro para apresentar a equipe no grupo do projeto.

Avisos de andamento no WhatsApp

1. Abra esta rotina na galeria e confira a situação.
2. Selecione os blocos para entender a origem, a condição e o resultado.
3. Ainda não há execução desta rotina. Os registros internos do projeto já podem ser consultados no Diário.

Fluxo futuro para comunicar mudanças de etapa ao grupo.

Buscar usuários e filtrar acessos

1. Abra Usuários e use Buscar nome ou e-mail.
2. Filtre por Todos os acessos, Admin, Gestor ou Leitor.
3. Confira Situação e Último acesso; use Próximos usuários quando disponível.

Último acesso é um registro de login, não indica que a pessoa esteja online agora.

Criar usuário

1. Clique em Novo usuário. Preencha Nome e E-mail.
2. Escolha Acesso e informe Senha inicial de 8 a 128 caracteres.
3. Se desejar, adicione a foto. Clique em Criar usuário.

A conta nova começa Ativa. Gestor pode criar Gestor ou Leitor, mas não conceder Admin. Use apenas dados fictícios no teste.

Entender Admin, Gestor e Leitor

1. Admin administra acessos e recursos administrativos.
2. Gestor opera o sistema e pode criar e gerenciar contas permitidas.
3. Leitor consulta as informações sem editar.

Gestor não pode alterar ou redefinir senha de Admin. Contatos de clientes não são usuários do sistema.

Editar usuário e meu perfil

1. Na linha do usuário, clique em Gerenciar ou Meu perfil.
2. Edite os dados permitidos e clique em Salvar alterações.
3. Cancelar pode pedir confirmação para descartar mudanças não salvas.

Na própria conta e no Admin protegido, e-mail, acesso e situação são protegidos. Nome e foto continuam editáveis conforme a tela.

Adicionar foto e ampliar miniatura

1. No editor, use Alterar foto e selecione um arquivo.
2. Use PNG, JPG, WebP ou GIF de até 10 MB. Salve o usuário.
3. Na lista, passe o mouse sobre a miniatura para ver a imagem ampliada.

Sem foto, o app usa identificação por iniciais. O teste só exibe o arquivo local, sem upload.

Desativar ou reativar usuário

1. Abra Gerenciar no usuário.
2. Mude Situação para Desativado ou Ativo e salve.
3. Confira a situação resultante na lista.

Não é possível desativar a própria conta ou o Admin protegido. Gestor não gerencia Admin. Desativar é diferente de excluir.

Redefinir senha

1. Abra Gerenciar e clique em Redefinir senha.
2. Preencha Nova senha com 8 a 128 caracteres e clique em Confirmar nova senha.
3. Leia a confirmação: as sessões dessa pessoa serão encerradas. Compartilhe a nova senha diretamente com ela.

Na documentação, nenhuma credencial é alterada. Não digite senhas reais. Gestor não pode redefinir senha de Admin.

Entender autoria e fotos no histórico

1. As alterações registradas pelo sistema ficam associadas à conta que executou a ação.
2. No Diário do projeto, consulte o autor e o registro correspondente.
3. A preferência de miniaturas em Configurações altera a apresentação da foto.

Ocultar miniaturas não remove a autoria. A foto não significa que a pessoa foi a compradora ou executora física da tarefa.

Entender as abas por acesso

1. Abra Configurações.
2. Admin encontra WhatsApp, Grupos e Preferências.
3. Os demais perfis acessam Preferências.

Os controles administrativos de conexão e padrões de grupos não são disponibilizados aos outros perfis.

Mostrar ou ocultar fotos nos históricos

1. Abra Preferências.
2. Ative ou desative Mostrar fotos nos históricos.
3. O app salva a preferência ao mudar o controle; confira eventual aviso de erro.

O nome do autor continua aparecendo quando a foto é ocultada.

Cadastrar credenciais do WhatsApp

1. Como Admin, abra WhatsApp e a área de credenciais.
2. Informe ID da instância, Token da instância e Token de segurança da conta.
3. Clique em Salvar alterações. Deixar um campo já configurado vazio mantém o valor salvo.
4. Use Descartar alterações para abandonar o rascunho.

Salvar credenciais não conecta o aparelho nem envia mensagens. Nunca coloque credenciais reais nesta documentação.

Conectar, verificar e renovar QR Code

1. Depois de configurar as credenciais, use Conectar WhatsApp.
2. No celular: WhatsApp → Aparelhos conectados → Conectar aparelho. Leia o QR exibido no app.
3. Confira a confirmação da conexão ou use Verificar conexão.
4. Se o QR expirar, use Gerar novo QR Code. Parar conexão interrompe a tentativa em tela.

Nenhum QR real é apresentado na demonstração. Salvar tokens ou ver um status antigo não comprova conexão atual ou entrega de mensagens.

Configurar modo teste e destino

1. Na área WhatsApp, expanda Modo teste e defina o controle.
2. Informe Nome do grupo de testes e ID do grupo, terminado em -group ou @g.us.
3. Clique em Salvar modo de envio. A mudança só vale depois de salvar.
4. Ao desativar modo teste, leia a confirmação: próximos envios poderão alcançar grupos reais.

Não use número pessoal ou link de convite como ID. O destino ainda deve ser verificado com a integração.

Editar nome e descrição padrão dos grupos

1. Como Admin, abra Grupos.
2. Ajuste Nome do grupo e Descrição padrão. Insira Nome do projeto ou Nome do cliente pelas variáveis.
3. Confira Prévia do grupo e clique em Salvar padrões.

Os padrões são usados ao preparar novos grupos. Salvar não cria grupos nem envia mensagens.

Personalizar imagem padrão do grupo

1. Em Grupos, use Escolher outra imagem.
2. Selecione PNG, JPG, WebP ou GIF de até 10 MB.
3. Confira a prévia e Salvar padrões. Restaurar padrão Yama volta à imagem da marca no rascunho.

A imagem escolhida só passa a valer depois de salvar os padrões. A prévia local da documentação não faz upload.

Definir participantes padrão da equipe

1. Em Grupos, encontre Participantes da equipe.
2. Use Adicionar participante e informe nome e telefone com código do país e DDD.
3. Remova entradas incorretas e clique em Salvar padrões.
4. Ao criar um grupo de projeto, revise novamente os participantes.

O limite é de 50 participantes. Não inclua o número conectado à Z-API: ele já será o criador do grupo.