================================================================================
                     FB AUTO GROUP - MANUAL DO USUARIO
                  Postador Automatico para Grupos do Facebook
================================================================================

                           VERSAO 1.0 - 2026


================================================================================
SUMARIO
================================================================================

  1.  APRESENTACAO
      1.1.  O que e o FB Auto Group
      1.2.  Requisitos do Sistema
      1.3.  Licenca e Ativacao

  2.  INSTALACAO
      2.1.  Modo Desenvolvedor (Chrome)
      2.2.  Modo Desenvolvedor (Edge)
      2.3.  Verificacao da Instalacao

  3.  PRIMEIROS PASSOS
      3.1.  Ativacao da Licenca
      3.2.  Carregando Grupos
      3.3.  Entendendo a Interface

  4.  CONFIGURACOES DE POSTAGEM
      4.1.  Mensagens (Rotacao)
      4.2.  Variaçoes de Midias
      4.3.  Modo de Envio (Sequencial vs Aleatorio)
      4.4.  Limites de Postagem por Grupo
      4.5.  Intervalo entre Postagens
      4.6.  Agendamento de Repetiçoes
      4.7.  Presets de Grupos

  5.  EXECUCAO
      5.1.  Iniciando as Postagens
      5.2.  Acompanhando o Progresso
      5.3.  Parando a Automacao
      5.4.  Interpretando os Logs

  6.  MIDIAS
      6.1.  Formatos Suportados
      6.2.  Limite de Tamanho (10MB por arquivo)
      6.3.  Criando Blocos de Midia
      6.4.  Persistencia entre Sessoes

  7.  LICENCA E SEGURANCA
      7.1.  Ativacao da Licenca
      7.2.  HWID (Vinculo com Hardware)
      7.3.  Expiraçao
      7.4.  Trocar de Computador
      7.5.  Fallback Offline

  8.  SOLUCAO DE PROBLEMAS
      8.1.  Nenhum Grupo encontrado
      8.2.  Erro de Comunicacao com a Pagina
      8.3.  Mensagem nao aparece no Post
      8.4.  Midia nao Envia
      8.5.  Erro de Licenca / Atualizacao
      8.6.  Extensao nao Abre

  9.  BOAS PRATICAS
      9.1.  Intervalos Seguros
      9.2.  Evitar Deteccao
      9.3.  Volume Diario Recomendado

  10. SUPORTE


================================================================================
1. APRESENTACAO
================================================================================

1.1. O que e o FB Auto Group

O FB Auto Group e uma extensao para Chrome/Edge que automatiza a postagem
em grupos do Facebook. Ela permite que voce:

  - Poste mensagens de texto em multiplos grupos automaticamente
  - Anexe imagens e videos aos posts
  - Crie variacoes de mensagens para rotacao entre grupos
  - Agende repeticoes em intervalos ou horarios fixos
  - Acompanhe o progresso em tempo real

Diferente de ferramentas cloud, a extensao roda diretamente no SEU navegador,
usando sua propria sessao do Facebook ja logada. Nenhum dado e enviado para
servidores externos (exceto validacao de licenca).


1.2. Requisitos do Sistema

  - Navegador: Google Chrome (recomendado) ou Microsoft Edge
  - Sistema: Windows, Mac ou Linux
  - Conta do Facebook ativa e logada no navegador
  - Conexao com a internet
  - Espaco em disco: ~5 MB


1.3. Licenca e Ativacao

O FB Auto Group requer uma chave de licenca para funcionar. Cada licenca e
vinculada ao hardware do computador (HWID). Isso significa que:

  - Uma chave funciona em UM unico computador
  - Para usar em outro PC, e necessario adquirir outra licenca
  - A licenca tem data de expiracao definida pelo servidor

Sem licenca, a extensao exibe a tela de ativacao e nao libera o uso.


================================================================================
2. INSTALACAO
================================================================================

2.1. Modo Desenvolvedor (Google Chrome)

  Passo 1: Abra o Google Chrome
  Passo 2: Digite na barra de enderecos: chrome://extensions
  Passo 3: Ative o "Modo do desenvolvedor"
           (interruptor no canto superior direito)
  Passo 4: Clique em "Carregar sem compactacao"
  Passo 5: Selecione a pasta "FB AUTO GROUP" (onde estao os arquivos)
  Passo 6: A extensao aparecera na lista com o nome "FB AUTO GROUP"
  Passo 7: (Opcional) Fixe o icone da extensao na barra de ferramentas
           clicando no quebra-cabeca e depois no pino ao lado dela

Pronto! A extensao ja esta instalada e pronta para uso.


2.2. Modo Desenvolvedor (Microsoft Edge)

  Passo 1: Abra o Microsoft Edge
  Passo 2: Digite na barra de enderecos: edge://extensions
  Passo 3: Ative o "Modo do desenvolvedor"
  Passo 4: Clique em "Carregar sem compactacao"
  Passo 5: Selecione a pasta com os arquivos da extensao
  Passo 6: A extensao aparecera na lista


2.3. Verificacao da Instalacao

Apos instalar, faca o seguinte teste:

  1. Acesse https://www.facebook.com e faca login
  2. Clique no icone da extensao na barra de ferramentas
  3. O painel lateral (sidepanel) deve abrir com a tela de carregamento
  4. Se aparecer "Verificando licenca...", a instalacao foi bem-sucedida

Se nada acontecer ao clicar no icone:
  - Verifique se o icone esta fixado na barra
  - Clique com botao direito no icone > "Opcoes" ou veja se ha
    alguma permissao pendente
  - Tente clicar no quebra-cabeca e depois no icone da extensao


================================================================================
3. PRIMEIROS PASSOS
================================================================================

3.1. Ativacao da Licenca

Ao abrir a extensao pela primeira vez, voce vera a tela de ativacao:

  - Insira sua chave de licenca no campo indicado
  - Clique em "Ativar Licenca"
  - Aguarde a validacao online
  - Se a chave for valida, o painel principal sera liberado
  - Se houver erro, verifique a chave e tente novamente

A chave deve ser fornecida pelo desenvolvedor. Cada chave e unica e
vinculada ao seu computador (veja seçao 7).


3.2. Carregando Grupos

Antes de postar, voce precisa carregar seus grupos do Facebook:

  Passo 1: Faca login no Facebook em uma aba ativa
  Passo 2: Clique em "Carregar Grupos" na extensao
  Passo 3: A extensao navegara ate a pagina de grupos do Facebook
  Passo 4: Aguarde o carregamento e a leitura dos grupos
  Passo 5: A lista de grupos aparecera com caixas de selecao

Observacoes:
  - Grupos onde voce nao tem permissao de postar sao removidos
    automaticamente apos a primeira tentativa de postagem
  - O cache e limpo a cada nova carga, garantindo lista atualizada
  - Grupos duplicados (mesmo nome) sao removidos automaticamente


3.3. Entendendo a Interface

O painel principal da extensao e dividido em secoes:

  [1] Configuracoes e Limites
      - Modo de envio, maximo de posts, intervalos

  [2] Variaçoes de Midias
      - Blocos de fotos/videos para anexar aos posts

  [3] Mensagens (Rotacao)
      - Textos que serao postados (pode ter varios)

  [4] Grupos do Facebook
      - Lista de grupos carregados para selecao

  [5] Presets
      - Salvar/Carregar combinacoes de grupos favoritos

  [6] Execucao
      - Botoes Iniciar/Parar e painel de logs

  [7] Progresso
      - Barra de progresso durante a execucao

  [8] Rodape
      - Suporte via WhatsApp


================================================================================
4. CONFIGURACOES DE POSTAGEM
================================================================================

4.1. Mensagens (Rotacao)

Voce pode adicionar varias mensagens. A extensao alterna entre elas
a cada postagem, seguindo o modo de envio escolhido.

  - Clique em "+ Adicionar" para criar uma nova mensagem
  - Escreva o texto desejado (pode conter emojis e links)
  - Use quantas mensagens quiser
  - Clique no "x" para remover uma mensagem

Dica: crie variacoes do mesmo texto para parecer mais natural e
evitar deteccao de spam pelo Facebook.


4.2. Variaçoes de Midias

Cada "Bloco de Midia" pode conter ate 4 arquivos (fotos ou videos).
A extensao alterna entre os blocos a cada postagem.

  - Clique em "+ Bloco Midia" para criar um novo bloco
  - Clique no botao "Escolher arquivos" dentro do bloco
  - Selecione as imagens/videos (maximo 4 por bloco)
  - Cada arquivo deve ter no maximo 10 MB
  - Formatos aceitos: JPG, PNG, GIF, TIFF, HEIF, WebP
  - Videos tem limite maior, mas recomendamos ate 100 MB

As midias sao salvas automaticamente no banco local do navegador
(IndexedDB) e persistem entre sessoes.


4.3. Modo de Envio (Sequencial vs Aleatorio)

  SEQUENCIAL (padrao):
      As mensagens sao usadas em ordem: Msg 1, Msg 2, Msg 3...
      Quando chega ao fim, volta para a Msg 1 (ciclo).

  ALEATORIO:
      Uma mensagem aleatoria e escolhida a cada postagem.
      Ideal para parecer mais humano e evitar padroes.


4.4. Limites de Postagem por Grupo

Define quantas vezes cada grupo recebera uma postagem durante a execucao.

  - Valor padrao: 1 (uma postagem por grupo por rodada)
  - Valor maximo: 10
  - Exemplo: 3 grupos com limite 2 = 6 postagens no total

Use com moderacao. Postar muitas vezes no mesmo grupo em curto
intervalo pode ser visto como spam.


4.5. Intervalo entre Postagens

Define o tempo de espera entre uma postagem e outra.

  - Intervalo Minimo: tempo minimo em segundos (padrao: 30)
  - Intervalo Maximo: tempo maximo em segundos (padrao: 90)
  - O sistema sorteia um valor aleatorio entre minimo e maximo
    para cada espera, simulando comportamento humano

Recomendamos:
  - Minimo 30s, Maximo 90s para uso normal
  - Minimo 60s, Maximo 180s para uso seguro
  - Evite intervalos muito curtos (abaixo de 15s)


4.6. Agendamento de Repetiçoes

Apos completar uma rodada de postagens em todos os grupos, a extensao
pode aguardar e repetir o ciclo automaticamente.

  OPCOES:

  [Nao repetir]
      Executa uma unica vez e para.

  [Repetir a cada X horas]
      Aguarda o numero de horas configurado e inicia nova rodada.
      Exemplo: a cada 2 horas, repete tudo.

  [Horario especifico do dia]
      Aguarda ate o horario configurado e inicia.
      Exemplo: agendar para as 14:00.
      Se o horario ja passou, agenda para o dia seguinte.


4.7. Presets de Grupos

Permite salvar combinacoes de grupos para reutilizar depois.

  SALVAR um preset:
      1. Selecione os grupos desejados na lista
      2. Digite um nome para o preset
      3. Clique em "Salvar"

  CARREGAR um preset:
      1. Selecione o preset no dropdown
      2. Clique em "Carregar"
      3. Os grupos serao automaticamente marcados

  EXCLUIR um preset:
      1. Selecione o preset no dropdown
      2. Clique no botao "X" (vermelho)
      3. Confirme a exclusao


================================================================================
5. EXECUCAO
================================================================================

5.1. Iniciando as Postagens

Apos configurar tudo, siga estes passos:

  Passo 1: Selecione os grupos desejados na lista
  Passo 2: Verifique se ha pelo menos uma mensagem escrita
  Passo 3: (Opcional) Adicione midias se desejar
  Passo 4: Configure intervalos e modo de envio
  Passo 5: Deixe uma aba do Facebook aberta e logada
  Passo 6: Clique em "Iniciar Postagens"

A extensao comecara a navegar pelas paginas dos grupos,
inserir a mensagem, anexar midias (se houver) e clicar em "Postar".


5.2. Acompanhando o Progresso

Durante a execucao, voce pode acompanhar:

  - Barra de progresso: mostra quantas postagens ja foram feitas
  - Log de eventos: cada acao e registrada com timestamp
  - Cores dos logs:
      Azul (info):  informacoes gerais
      Verde (success):  postagens bem-sucedidas
      Vermelho (error):  erros e falhas
      Amarelo (warn):  avisos e tempos de espera


5.3. Parando a Automacao

Para interromper a qualquer momento:

  - Clique em "Parar Automacao"
  - A postagem em andamento sera concluida (se possivel)
  - Nenhuma nova postagem sera iniciada
  - Voce pode reiniciar depois clicando em "Iniciar Postagens" novamente


5.4. Interpretando os Logs

Exemplos de mensagens do log:

  "Postando em 'Meu Grupo'..."           
      A extensao esta navegando para o grupo

  "Enviando mensagem para 'Meu Grupo'..." 
      A mensagem esta sendo inserida no Facebook

  "Enviando 2 midia(s) junto com a mensagem..."  
      Ha midias anexadas ao post

  "Post concluido em 'Meu Grupo'."        
      Postagem bem-sucedida

  "Falha ao postar em 'Meu Grupo': ..."   
      Ocorreu um erro (veja detalhes na mensagem)

  "Aguardando 45 segundos para evitar bloqueio..."  
      Pausa entre postagens

  "Grupo 'Meu Grupo' nao permite postagens..."     
      Grupo restrito, removido automaticamente


================================================================================
6. MIDIAS
================================================================================

6.1. Formatos Suportados

O Facebook aceita os seguintes formatos:

  FOTOS:
    - JPG / JPEG
    - PNG
    - GIF
    - TIFF
    - HEIF / HEIC
    - WebP

  VIDEOS:
    - MP4
    - MOV
    - AVI
    - WMV
    - MKV (entre outros)


6.2. Limite de Tamanho (10MB por arquivo)

O Facebook impoe um limite de 10 MB POR ARQUIVO para fotos.
Cada foto acima de 10 MB sera rejeitada e ignorada.

Para videos, o limite do Facebook e maior (ate 10 GB), mas
recomendamos manter videos abaixo de 100 MB para evitar
problemas de upload e processamento.

A extensao verifica automaticamente o tamanho de cada arquivo
antes de enviar e pula os que excederem o limite.


6.3. Criando Blocos de Midia

Cada bloco funciona como um conjunto de midias que serao anexadas
juntas a um post. Voce pode ter varios blocos para alternar.

  Para criar: clique em "+ Bloco Midia"
  Para adicionar arquivos: clique em "Escolher arquivos" no bloco
  Para remover um arquivo: clique no "x" sobre a miniatura
  Para remover um bloco inteiro: clique em "x Remover"

Cada bloco pode ter ate 4 arquivos.


6.4. Persistencia entre Sessoes

As midias que voce adiciona sao salvas automaticamente no banco
interno do navegador (IndexedDB). Isso significa que:

  - Se voce fechar e reabrir a extensao, as midias ainda estarao la
  - Nao e preciso recarregar os arquivos a cada uso
  - O armazenamento e local (nada vai para servidores externos)
  - Se o navegador limpar dados de extensoes, as midias serao perdidas

Para remover a extensao completamente, os dados salvos serao
apagados junto.


================================================================================
7. LICENCA E SEGURANCA
================================================================================

7.1. Ativacao da Licenca

A extensao requer uma chave de licenca para funcionar.
A ativacao funciona assim:

  1. Voce insere a chave no campo de ativacao
  2. A extensao gera um identificador unico do seu computador (HWID)
  3. Envia a chave + HWID para o servidor de validacao
  4. O servidor verifica e retorna a data de expiracao
  5. Se tudo estiver OK, a extensao e liberada

O processo e feito uma unica vez. Nas proximas vezes que abrir
a extensao, ela valida automaticamente com o servidor.


7.2. HWID (Vinculo com Hardware)

HWID = Hardware ID. E uma "impressao digital" do seu computador
gerada a partir de caracteristicas unicas do sistema:

  - Navegador e versao
  - Idioma do sistema
  - Resolucao de tela
  - Numero de nucleos do processador
  - ID da extensao

Esse identificador e usado para vincular a licenca ao computador.
Isso impede que a mesma chave seja usada em varios PCs diferentes.


7.3. Expiraçao

A licenca tem data de validade definida pelo servidor. Quando
a extensao inicia, ela consulta o servidor para verificar:

  - Se a licenca ainda esta ativa
  - Se a data de expiracao nao passou
  - Se o HWID continua o mesmo

Se a licenca expirar, a extensao volta para a tela de ativacao.


7.4. Trocar de Computador

Se voce precisar usar a extensao em outro computador:

  1. A chave atual NAO funcionara no novo PC (HWID diferente)
  2. Solicite ao desenvolvedor uma nova chave ou
     peca para desvincular a chave do hardware antigo
  3. No PC antigo, voce pode clicar em "Sair" para remover a licenca


7.5. Fallback Offline

Se o servidor de validacao estiver offline no momento da
verificacao, a extensao usa o cache local:

  - Se a licenca ja foi validada antes e nao expirou,
    a extensao libera o uso normalmente
  - Isso permite continuar usando mesmo sem internet momentanea
  - Na proxima vez que o servidor estiver online, a validacao
    sera refeita


================================================================================
8. SOLUCAO DE PROBLEMAS
================================================================================

8.1. Nenhum Grupo encontrado

  Causas possiveis:
    - Nao esta na pagina de grupos do Facebook
    - O Facebook mudou o layout da pagina
    - Bloqueador de anuncios impedindo o carregamento

  Solucoes:
    - Certifique-se de que esta logado no Facebook
    - Navegue manualmente ate facebook.com/groups/joins/
    - Desative bloqueadores de anuncios temporariamente
    - Recarregue a pagina e tente novamente


8.2. Erro de Comunicacao com a Pagina

  Causas possiveis:
    - A pagina do Facebook nao terminou de carregar
    - A extensao perdeu conexao com a aba
    - O Facebook esta com lentidao

  Solucoes:
    - Recarregue o Facebook manualmente
    - Feche e reabra a extensao
    - Aguarde alguns segundos e tente novamente


8.3. Mensagem nao aparece no Post

  Causas possiveis:
    - O Facebook mudou o editor de texto (Lexical)
    - A caixa de comentario foi aberta em vez da caixa de postagem
    - Tempo de espera insuficiente

  Solucoes:
    - A extensao ja usa o metodo mais compativel (paste via ClipboardEvent)
    - Verifique se o trigger "Escreva algo..." foi clicado corretamente
    - Aumente os delays nas configuracoes se necessario


8.4. Midia nao Envia

  Causas possiveis:
    - Arquivo maior que 10 MB
    - Formato nao suportado pelo Facebook
    - O input de arquivo nao foi encontrado na pagina

  Solucoes:
    - Verifique o tamanho e formato do arquivo
    - Tente com uma imagem JPG pequena (1-2 MB) para testar
    - Consulte os logs da extensao para ver o erro exato
    - Abra o console do Facebook (F12) e veja as mensagens [FB AUTO]


8.5. Erro de Licenca / Atualizacao

  "Licenca invalida ou expirada":
    - Verifique se a chave foi digitada corretamente
    - Confirme se a licenca nao expirou
    - Solicite uma nova chave ao desenvolvedor

  "Licenca ja ativada em outro computador":
    - Esta chave ja foi usada em outro PC
    - Solicite ao desenvolvedor para desvincular o hardware antigo

  "Atualizacao Necessaria":
    - Uma nova versao obrigatoria esta disponivel
    - Baixe a versao mais recente com o desenvolvedor

  "Erro de conexao com o servidor":
    - Verifique sua internet
    - O servidor pode estar temporariamente offline
    - Tente novamente mais tarde


8.6. Extensao nao Abre

  Causas possiveis:
    - Permissoes nao concedidas
    - Instalacao incompleta
    - Conflito com outras extensoes

  Solucoes:
    - Va em chrome://extensions, remova a extensao e instale novamente
    - Verifique se o "Modo do desenvolvedor" esta ativo
    - Tente em uma janela anonima (incognito) apos permitir na extensao


================================================================================
9. BOAS PRATICAS
================================================================================

9.1. Intervalos Seguros

Para evitar bloqueios do Facebook, recomendamos:

  Uso Moderado:
      Intervalo: 30 a 90 segundos
      Maximo: 50 posts por dia

  Uso Seguro:
      Intervalo: 60 a 180 segundos
      Maximo: 30 posts por dia

  Uso Conservador:
      Intervalo: 120 a 300 segundos
      Maximo: 15 posts por dia

Nunca use intervalos abaixo de 15 segundos.


9.2. Evitar Deteccao

O Facebook possui sistemas anti-automacao. Para minimizar riscos:

  - Use variacoes de mensagens (nao poste o mesmo texto sempre)
  - Alterne entre blocos de midia diferentes
  - Nao poste em muitos grupos ao mesmo tempo
  - Evite horarios comerciais (prefira periodos de menor movimento)
  - Nao use a extensao 24 horas por dia
  - Faca pausas manuais entre uso intenso

Lembre-se: esta ferramenta automatiza acoes que voce faria manualmente.
Use com bom senso.


9.3. Volume Diario Recomendado

  Contas Novas (menos de 6 meses):
      Maximo: 10-20 posts por dia
      Intervalo minimo: 60 segundos

  Contas Maduras (mais de 1 ano):
      Maximo: 50-100 posts por dia
      Intervalo minimo: 30 segundos

  Contas Antigas (mais de 3 anos):
      Maximo: 100-150 posts por dia
      Intervalo minimo: 20 segundos

Estes valores sao referencias. O Facebook pode bloquear mesmo dentro
dos limites recomendados, dependendo do comportamento geral da conta.


================================================================================
10. SUPORTE
================================================================================

Em caso de duvidas ou problemas, entre em contato:

  WhatsApp: https://sistemas.store/whats/?produto=FbAutoGroup&msg=Olá!%20Comprei%20a%20licença%20do%20FB%20Auto%20Group%20e%20preciso%20de%20ajuda
  Site:     https://sistemas.store/

Tenha em maos:
  - O numero da sua licenca (se aplicavel)
  - Descricao detalhada do problema
  - Prints dos logs de erro, se possivel



================================================================================
(c) 2026 FB Auto Group. Todos os direitos reservados.
Versao 1.0 - Julho 2026
================================================================================
