=====================================================================
                ZAPFLOW  —  MANUAL DE USO (LEIA-ME)
              Automação inteligente para WhatsApp Web
=====================================================================

    Feito com carinho pela SISTEMAS.STORE
    Site oficial: https://sistemas.store/zapflow
    Suporte / WhatsApp: https://sistemas.store/whats/?produto=ZapFlow

        Versão da extensão: 2.1.0

---------------------------------------------------------------------
ÍNDICE
---------------------------------------------------------------------
  1. O que é o ZapFlow
  2. Requisitos
  3. Como instalar a extensão (download / carregamento)
  4. Como ativar a licença
  5. Como usar (funcionalidades)
     5.1 Sidebar (painel lateral)
     5.2 Dashboard (editor completo)
     5.3 Mensagens rápidas
     5.4 Áudios
     5.5 Mídias
5.6 Fluxos
      5.7 Gatilhos automáticos
      5.8 Modo Privado
      5.9 Backup (exportar/importar)
      5.10 Disparo em massa (novo)
      5.11 Agendamento de disparos (novo)
      5.12 Roteiros com espera de resposta (novo)
      5.13 Etapas / CRM (novo)
      5.14 Exportar contatos CSV / vCard (novo)
  6. Dúvidas frequentes (FAQ)
  7. Problemas comuns e correções
  8. Aviso legal e direitos autorais


=====================================================================
1. O QUE É O ZAPFLOW
=====================================================================
O ZapFlow é uma extensão para o Google Chrome que roda 100% DENTRO do
WhatsApp Web. Ele permite:
  - Enviar mensagens rápidas (texto pronto) com um clique;
  - Enviar áudios e mídias salvos;
  - Criar FLUXOS: sequências automáticas de texto, áudio e mídia,
    com intervalo (delay) entre cada envio;
  - Criar GATILHOS automáticos: quando um contato enviar determinada
    palavra-chave, o ZapFlow responde no chat certo, sozinho;
  - Usar o MODO PRIVADO para proteger sua tela e sua privacidade;
  - Fazer backup (exportar/importar) de toda a sua configuração.

Nada é instalado no seu computador além da extensão do navegador.
Todos os seus dados ficam salvos LOCALMENTE, no próprio navegador
(chrome.storage). Você é o dono dos seus dados.


=====================================================================
2. REQUISITOS
=====================================================================
  - Google Chrome (ou navegador baseado em Chromium) atualizado;
  - Acesso ao site https://web.whatsapp.com (WhatsApp Web);
  - Conexão com a internet;
  - Uma chave de licença válida (ZFP-XXXX-XXXX-XXXX-XXXX), comprada
    em https://sistemas.store/zapflow.


=====================================================================
3. COMO INSTALAR A EXTENSÃO (DOWNLOAD / CARREGAMENTO)
=====================================================================
Como esta é uma extensão comercial, ela é instalada em modo de
desenvolvedor (siga o passo a passo abaixo UMA vez):

  1) Baixe/descompacte a pasta da extensão ZapFlow no seu computador.
  2) Abra o Google Chrome e digite na barra de endereço:
        chrome://extensions
  3) Ative o interruptor "Modo do desenvolvedor"
     (canto superior direito).
  4) Clique no botão "Carregar sem compactação".
  5) Selecione a PASTA da extensão ZapFlow (a pasta que contém o
     arquivo manifest.json).
  6) A extensão aparecerá na lista. PRONTO!

Para RECARREGAR a extensão (após uma atualização):
  - Em chrome://extensions, clique no botão de atualizar (ícone de
    seta circular) no cartão do ZapFlow.
  - Depois, atualize (F5) a página do WhatsApp Web.

Dica: se o WhatsApp Web já estiver aberto, feche e abra novamente
após carregar a extensão, para garantir que tudo carregue.


=====================================================================
4. COMO ATIVAR A LICENÇA
=====================================================================
Ao abrir o WhatsApp Web, o ZapFlow mostra uma tela de ATIVAÇÃO:

  1) Digite sua chave de licença (formato: ZFP-XXXX-XXXX-XXXX-XXXX);
  2) Clique em "ATIVAR";
  3) Aguarde a mensagem "Licença ativada!".

O mesmo deve ser feito no Dashboard (editor), se solicitado.

Sobre o vencimento:
  - Ao lado do logo ZapFlow aparece um selo pequeno (ex.: "⏳ 27d 14h")
    mostrando quantos dias/horas faltam para a renovação.
  - Quando expirar, basta comprar/renovar em https://sistemas.store/zapflow
    e reativar com a nova chave.


=====================================================================
5. COMO USAR (FUNCIONALIDADES)
=====================================================================

---------------------------------------------------------------------
5.1 SIDEBAR (PAINEL LATERAL)
---------------------------------------------------------------------
O painel fica no lado direito do WhatsApp Web. No topo você encontra
as abas: Mensagens, Áudios, Mídias, Gatilhos, Fluxos e Privacidade.
No rodapé fica a marca SISTEMAS.STORE.

Você seleciona o contato/conversa no WhatsApp (clicando nele) e usa a
sidebar para enviar o que quiser para AQUELE chat.

---------------------------------------------------------------------
5.2 DASHBOARD (EDITOR COMPLETO)
---------------------------------------------------------------------
O Dashboard é a tela de gerenciamento completa. Para abri-lo:
  - Clique no logo "ZapFlow" na sidebar, OU
  - Clique no ícone do ZapFlow na barra do Chrome e selecione
    "Abrir editor" (Options/opções da extensão).

No Dashboard você edita tudo: Mensagens, Áudios, Mídias, Fluxos e
Gatilhos, além de exportar/importar backups.

---------------------------------------------------------------------
5.3 MENSAGENS RÁPIDAS
---------------------------------------------------------------------
  - Aba "Mensagens" da sidebar.
  - Clique em "+" para criar uma nova mensagem.
   - Escreva o texto. Você pode usar variáveis:
        {nome}     -> nome do contato
        {telefone} -> telefone do contato
        {saudacao} -> saudação conforme o horário
     (Aceita também com chave dupla: {{nome}}.)
  - Salve e, na conversa desejada, basta CLICAR na mensagem para
    enviá-la automaticamente.

---------------------------------------------------------------------
5.4 ÁUDIOS
---------------------------------------------------------------------
  - Aba "Áudios".
  - Clique em "+" e envie um arquivo de áudio (.ogg ou .mp3).
  - Clique no áudio salvo para enviá-lo como nota de voz no chat
    aberto. Opcional: marcar como "ver uma vez" (mensagem efêmera).

---------------------------------------------------------------------
5.5 MÍDIAS
---------------------------------------------------------------------
  - Aba "Mídias".
  - Clique em "+" e envie imagens, vídeos ou documentos.
  - Clique na mídia salva para enviá-la ao chat aberto.

---------------------------------------------------------------------
5.6 FLUXOS
---------------------------------------------------------------------
Fluxos são sequências automáticas de envio. Exemplo: enviar um texto,
esperar 6 segundos, enviar um áudio, esperar 8 segundos, enviar uma
mídia. Tudo na ordem que você definir.

  - No Dashboard, aba "Fluxos", clique em "+ Novo fluxo";
  - Dê um nome e monte a sequência de passos (texto/áudio/mídia),
    definindo o intervalo (delay) entre cada passo;
  - Salve. O fluxo fica disponível na sidebar, onde você pode
    "executar agora" (dispara no chat aberto).

Você também pode usar o CONSTRUTOR VISUAL (canvas) para montar o
fluxo arrastando e conectando nós na tela.

---------------------------------------------------------------------
5.7 GATILHOS AUTOMÁTICOS
---------------------------------------------------------------------
Gatilhos respondem automaticamente quando um contato envia uma
palavra-chave. A resposta é enviada SEMPRE no chat de origem (no
chat certo), evitando erro de conversa.

  - No Dashboard, aba "Gatilhos", crie um gatilho:
       Palavra-chave: ex.: "preço"
       Resposta: uma mensagem, áudio, mídia ou fluxo
  - ATIVE o interruptor geral "Gatilhos ativos" na sidebar/dashboard.

IMPORTANTE: o WhatsApp Web precisa estar aberto e logado para os
gatilhos funcionarem (tudo roda no navegador).

---------------------------------------------------------------------
5.8 MODO PRIVADO
---------------------------------------------------------------------
Aba "Privacidade" da sidebar. Permite (ligar/desligar):
  - Desfocar NOMES de contatos;
  - Desfocar FOTOS de contatos;
  - Desfocar mensagens recentes;
  - Desfocar mensagens da conversa;
  - Desfocar o campo de digitação;


Tudo é aplicado na hora. Ideal para quem trabalha em ambientes
compartilhados.

---------------------------------------------------------------------
5.9 BACKUP (EXPORTAR/IMPORTAR)
---------------------------------------------------------------------
  - No Dashboard: "Exportar" gera um arquivo .json com tudo.
  - "Importar" restaura um backup (substitui os dados atuais).
Guarde seus backups em local seguro.


---------------------------------------------------------------------
5.10 DISPARO EM MASSA
---------------------------------------------------------------------
Envie mensagens/áudios/mídias para VÁRIOS contatos de uma vez:

  1) No WhatsApp Web, abra a aba "⚡ Disparos" na sidebar ZapFlow
     (no lado direito, junto de Mensagens/Fluxos/Gatilhos);
     - OU use no Dashboard a aba "Disparos" (ao lado de "Fluxos")
       para criar/editar os disparos e acompanhar o status.
  2) Clique em "Novo disparo";
  3) Escolha a ORIGEM dos contatos:
       - Todos os contatos (conversas @c.us);
       - Lista digitada / CSV (uma linha por contato: telefone;nome);
       - Participantes de grupos (mensagem privada para cada membro);
       - Postar NO grupo (envia no próprio grupo; marque "Mencionar
         todos em grupos (@all)" para marcar todo mundo);
       - Contatos de etapas (CRM);
       - Contatos de etiquetas do WhatsApp;
  4) Monte o ROTEIRO (ordem de envio): texto, áudio, mídia, FLUXO
     salvo, espera e "aguardar resposta";
  5) Defina o intervalo entre contatos (fixo ou dinâmico, com mínimo
     de 2s para reduzir risco de bloqueio);
  6) Clique em "Salvar e iniciar".

Opcional: marque "Mencionar todos em grupos (@all)" para marcar todo
o grupo nas mensagens de texto (só funciona em conversas de grupo).

Variáveis no texto (nos disparos aceita chave simples OU dupla):
  {nome}  ou  {{nome}}      -> nome do contato
  {telefone} ou {{telefone}} -> telefone do contato
  {saudacao} ou {{saudacao}} -> Bom dia / Boa tarde / Boa noite

Durante o envio você vê o progresso por contato (enviado/erro) e pode
PAUSAR, RETOMAR ou PARAR a qualquer momento. Os erros podem ser
reenviados com o botão "↻ Erros". O progresso é salvo localmente, então
um disparo pausado/parado pode ser retomado depois.

Dica anti-bloqueio: use intervalo DINÂMICO (ex.: 8s a 20s) e evite
disparos muito longos em um único lote.


---------------------------------------------------------------------
5.11 AGENDAMENTO DE DISPAROS
---------------------------------------------------------------------
No editor do disparo, marque "Agendar para data/hora" e informe quando
o disparo deve começar. O ZapFlow aguarda a hora marcada (mesmo com o
WhatsApp Web aberto) e inicia o envio automaticamente. Os agendamentos
pendentes ficam na aba "Agendados" e podem ser cancelados.


---------------------------------------------------------------------
5.12 ROTEIROS COM ESPERA DE RESPOSTA
---------------------------------------------------------------------
Ao montar o roteiro do disparo, adicione o item "Aguardar resposta".
O ZapFlow envia o que veio antes e ESPERA a pessoa responder antes de
continuar (ou até atingir o tempo máximo configurado). Ideal para
roteiros interativos de vendas e atendimento.


---------------------------------------------------------------------
5.13 ETAPAS / CRM
---------------------------------------------------------------------
Organize seus contatos em ETAPAS (ex.: Lead, Proposta, Fechado):
  1) Aba "⚡ Disparos" → "Etapas / CRM";
  2) Crie etapas e, na conversa aberta, clique em
     "➕ Adicionar conversa atual" (ou "🔍 Escolher contato");
  3) Use as etapas como origem de um disparo em massa ou de uma
     exportação de contatos.


---------------------------------------------------------------------
5.14 EXPORTAR CONTATOS (CSV / VCARD)
---------------------------------------------------------------------
Na aba "Exportar contatos" escolha a origem (todos, etapas, grupos,
etiquetas ou lista digitada) e o formato: CSV (Telefone,Nome) ou
vCard (.vcf, compatível com celulares e apps de agenda). O arquivo é
baixado na hora.


=====================================================================
6. DÚVIDAS FREQUENTES (FAQ)
=====================================================================

P: Preciso instalar algum programa além da extensão?
R: Não. Apenas a extensão no Chrome. Tudo roda no navegador.

P: Preciso manter o WhatsApp Web aberto?
R: Sim. Como tudo roda no navegador, o WhatsApp Web precisa estar
   aberto e logado para os gatilhos e fluxos dispararem.

P: Onde ficam os meus dados?
R: 100% no seu navegador (chrome.storage.local). Você pode exportar
   para um arquivo .json quando quiser.

P: Posso usar a mesma chave em mais de um computador?
R: A licença é vinculada ao computador (HWID). Somente uma licença para um PC.
 Em caso de
   dúvida, chame o suporte.

P: O que fazer quando minha licença expirar?
R: A tela mostrará a mensagem de expiração. Renove em
   https://sistemas.store/zapflow e ative a nova chave.

P: O envio do gatilho pode ir para a conversa errada?
R: Não. O ZapFlow envia SEMPRE no chat de origem da mensagem.

P: A extensão funciona com WhatsApp Business?
R: Sim, desde que acessado via web.whatsapp.com.

P: Meus dados de mensagens/fluxos são compartilhados?
R: Não. Ficam apenas no seu navegador e são seus.

P: Como compro/reforço a licença?
R: Em https://sistemas.store/zapflow (pagamento via Pix, entrega
   imediata da chave) ou pelo WhatsApp de suporte.


=====================================================================
7. PROBLEMAS COMUNS E CORREÇÕES
=====================================================================

1) "A extensão não aparece / não carrega"
   - Verifique se você carregou a PASTA correta (com manifest.json).
   - Em chrome://extensions, veja se está ativo (ligado).
   - Feche e reabra o WhatsApp Web.
   - Atualize a extensão (botão de refresh em chrome://extensions)
     e dê F5 no WhatsApp Web.

2) "Failed to fetch / Erro ao validar licença"
   - Verifique sua conexão com a internet.
   - O site sistemas.store precisa estar acessível (liberado).
   - Confirme que digitou a chave corretamente (ZFP-...).
   - Aguarde alguns segundos e tente de novo.

3) "Tela bugada / conversa não renderiza ao clicar"
   - Na maioria das vezes é um travamento temporário do WhatsApp Web.
     Dê F5 (recarregar a página).
   - Se persistir, recarregue a extensão em chrome://extensions e
     recarregue o WhatsApp Web.

4) "Gatilho não responde"
   - Verifique se o interruptor "Gatilhos ativos" está LIGADO.
   - Confirme se o WhatsApp Web está aberto e logado.
   - Verifique se a palavra-chave digitada bate exatamente com a
     configurada.
   - Teste disparar o fluxo/gatilho manualmente na sidebar.

5) "Áudio/mídia não envia"
   - Confirme o formato suportado (áudio .ogg/.mp3; mídia imagem/
     vídeo/documento).
   - O WhatsApp Web precisa estar aberto e logado.
   - Tente recarregar a extensão e o WhatsApp Web.

6) "Sumiu minha configuração"
   - Recarregue a extensão (chrome://extensions -> refresh) e F5.
   - Se tinha feito backup, use "Importar" no Dashboard.

7) "Aparecem erros no console (F12)"
   - Muitos avisos vermelhos são INTERNOS do próprio WhatsApp Web e
     são inofensivos (ex.: "No available adapters", "QPL event").
   - Só se preocupe se o erro citar "ZapFlow"/"content_script".
     Nesse caso, recarregue a extensão e entre em contato com o
     suporte, relatando o texto do erro.

8) Ainda com problema?
   - Chame o suporte no WhatsApp: https://wa.me/5551984006889
     Informe: versão da extensão, o que estava fazendo e, se possível,
     o texto do erro no console (F12).


=====================================================================
8. AVISO LEGAL E DIREITOS AUTORAIS
=====================================================================

  © 2026 SISTEMAS.STORE. Todos os direitos reservados.

  Este software ("ZapFlow") e todo o seu conteúdo (código-fonte,
  interface, textos, logotipos e documentação) são propriedade
  exclusiva da SISTEMAS.STORE e estão protegidos pelas leis de
  propriedade intelectual e direitos autorais do Brasil
  (Lei nº 9.610/1998) e tratados internacionais.

  É ESTRITAMENTE PROIBIDO:
    - Copiar, reproduzir, modificar, distribuir, vender ou ceder este
      software, no todo ou em parte, sem autorização escrita prévia;
    - Reverter a engenharia, descompilar ou tentar extrair o
      código-fonte ou o mecanismo de licenciamento;
    - Revender, sublocar ou compartilhar chaves de licença.

  LICENÇA DE USO:
    A compra da licença concede a VOCÊ o direito de USO PESSOAL e
    intransferível do software, em UMA instalação por chave, pelo
    período contratado. Não confere propriedade sobre o software.

  ISENÇÃO DE RESPONSABILIDADE:
    O ZapFlow é um software independente e NÃO é afiliado, endossado
    ou patrocinado pela Meta / WhatsApp. "WhatsApp", "WhatsApp Web"
    e "Meta" são marcas de seus respectivos proprietários. O uso da
    ferramenta é de responsabilidade do usuário, respeitando os
    Termos de Serviço da Meta e a legislação aplicável.

  SUPORTE E CONTATO:
    Site: https://sistemas.store/zapflow
    WhatsApp: https://sistemas.store/whats/?produto=ZapFlow

---------------------------------------------------------------------
                 Obrigado por usar o ZapFlow!
                     SISTEMAS.STORE
---------------------------------------------------------------------