Dashboard
Resultados e saúde da operação. Aqui você acompanha; o que fazer a respeito está em Fluxo e em Copiloto.
Resultados
Como a operação rendeu no período.
Cliques
—
Pedidos (Shopee)
—
Comissão (Shopee)
—
Evolução diária de cliques
Carregando…
Produtos que mais renderam
Carregando…
O que mais rende
Carregando…
Vendas Shopee 30 dias?
Carregando…
Operação
O que pede ação hoje e o andamento da produção. Calibração, resumo e propostas do Copiloto estão em Copiloto.
Precisa de atenção
Atividade recente
Plataformas
Cliques por canal 30 dias?
Carregando…
Copiloto
O que o Hub recomenda hoje, o resumo do dia e os ajustes que esperam a sua aprovação. Nada é aplicado sem o seu clique.
Calibração do dia ?
Carregando…
Copiloto ?
Carregando…
Propostas do Copiloto ?
Carregando…
Fluxo
Produtos
O catálogo de produtos. Busque, filtre e trate vários de uma vez; o conteúdo de cada um é gerado em Fluxo e em Gerar Conteúdo.
Filtros
| Código | Produto | Situação | Cadastro | Categoria | Preço | Comissão |
|---|
Nenhum produto cadastrado ainda
Cadastre o primeiro produto para começar a gerar conteúdo.
Gerar Conteúdo
Filtros
Nenhum rascunho por aqui
Gere um conteúdo a partir de um produto cadastrado.
Aprovar Conteúdo
Nada para aprovar ou publicar
Conteúdos enviados para aprovação, agendados ou publicados aparecem aqui.
Aprovar Conteúdo (beta)
Nova organização em teste. Os dados e as ações são os mesmos do Aprovar atual.
Nada por aqui
Destaques do Instagram
A API do Instagram não cria destaques: o Hub sugere o que pôr e o que tirar, você monta no app (Perfil → Destaques → Editar) e marca aqui. Reagir a um Story que está num destaque continua gerando a DM com o link, mesmo depois das 24 h.?
Tirar dos destaques
Top da semana
Por categoria
Stories fixos?
Capas dos destaques?
Publicações
Sem a auditoria do app, o TikTok só aceita rascunho: o post cai no app do TikTok (caixa de entrada) e você publica por lá, colando a legenda da tela Legendas do lote. O TikTok aceita até 5 rascunhos pendentes por conta em 24 h (o limite e a espera entre os envios ficam em Contas de destino › conta do TikTok).
| Conteúdo | Conta | Tipo | Esperando |
|---|
Nada para confirmar no TikTok
Os conteúdos aprovados que a distribuição deixa "Para confirmar" nas contas do TikTok aparecem aqui.
Enviados ao TikTok (últimos 30 dias: rascunhos esperando você publicar no app e já publicados)
Descartados (últimos 30 dias; "Voltar para a fila" desfaz)
Lotes recentes (últimos 7 dias)
Nada por aqui
Minha conta
Perfil
Como seu nome aparece no painel e no Log de Atividades.
Aparência
Vale só para você e muda na hora, sem precisar salvar. Fica guardado no seu perfil, em qualquer computador.
Sessão e senha
Quando o painel desconecta sozinho neste navegador e a troca da sua senha.
Muda na hora. Mouse, teclado, rolagem ou toque em qualquer aba do painel contam como uso.
Verificação em duas etapas …
Além da senha, o login pede uma passkey (biometria ou PIN do celular ou do computador) ou um código de 6 números do app autenticador.
Meus aparelhos
Aparelhos com sessão aberta na sua conta. Se um deles não é seu, derrube-o e troque a senha. Quem troca a senha sai dos outros aparelhos sozinho.
Política de acesso (administrador)
Ajuda
Novidades (o que mudou por último)
19/09/2026 — Captação automática, calendário semanal, modo escuro e mais
- Captação automática (Administração): crie regras (palavra-chave, comissão, avaliação, vendas, lojas e palavras proibidas) e o sistema traz produtos da Shopee sozinho, com o link de afiliado pronto e um rascunho de conteúdo. Nada é aprovado nem agendado sozinho — tudo passa pela sua aprovação. Você vê, por regra, quantos foram aprovados e rejeitados.
- Calendário agora tem visão Semana e você pode arrastar um item agendado para outro dia (o horário é mantido).
- Repetir toda semana: em um conteúdo agendado, cria as próximas semanas no mesmo dia e horário.
- Modo escuro e Minha conta (trocar nome, senha e aparência).
- Copiar link de afiliado com 1 clique (📋) na lista de produtos; tags e vendedor/loja nos produtos, com filtros; aviso de produto parado (sem conteúdo há dias).
- Histórico de preço de cada produto e trava para o preço "de" nunca ser menor que o preço atual.
- Modelos de legenda, hashtags por categoria e limite de caracteres da legenda (Configurações).
- Exportar CSV agora deixa escolher as colunas. Prévia do Telegram no modal de aprovar.
- Mais seguro: documentação da API agora exige senha e fica em outro endereço; o Log mostra as tentativas de login com erro; a sessão só expira depois de 24h sem uso.
- Novo cargo Visualizador (só leitura), ótimo para mostrar o sistema a alguém de fora.
18/09/2026 — Desfazer, revisão rápida e atalhos
- Desfazer logo após aprovar (individual ou em massa) ou arquivar um produto.
- Revisão rápida com atalhos de teclado, busca global Ctrl+K, ações em massa em Produtos e novos filtros.
- Painel adaptado ao celular e indicador "Atualizado há…" no Dashboard.
Primeiros passos
Como cadastrar um produto?
- Em Produtos, clique em Novo produto (ou + Criar nova oferta no Dashboard para seguir o passo a passo completo).
- Escolha a plataforma (Shopee, Mercado Livre...), cole o link do produto e preencha nome, categoria, preço e a foto.
- Em plataformas com integração (Shopee) o link de afiliado é gerado sozinho. Nas demais, cole o link de afiliado real depois, editando o produto.
- Para vários de uma vez, use Cadastro em lote (Shopee) ou Lote manual (sem API).
Se o mesmo link já estiver cadastrado, o sistema avisa e não cria um produto repetido.
Como gero o texto do post?
Em Gerar Conteúdo, clique em Gerar conteúdo, escolha o produto e a IA cria título, legenda, hashtags e chamada para ação. Revise, edite se quiser e salve: ele fica como rascunho. Não gostou do texto? Use Regenerar no rascunho para a IA escrever de novo (substitui o texto atual). Para vários produtos de uma vez, use Gerar em lote.
Cada geração consome uma chamada de IA e conta no limite de custo diário definido pelo administrador.
O que significa cada status?
- Rascunho — texto pronto, ainda não enviado para revisão.
- Aguardando aprovação — enviado; alguém com permissão precisa aprovar ou rejeitar.
- Agendado — aprovado; será publicado sozinho na data planejada (ou quando você clicar em publicar).
- Publicando — o envio para o Instagram está acontecendo agora.
- Falha — aguardando ação / Falhou — o Instagram recusou ou algo deu errado; o motivo aparece no card. Corrija e use Tentar novamente.
- Publicado — está no ar. Publicado não pode mais ser editado nem apagado (é histórico).
Na grid de Produtos, o que são "Conteúdo" e "Publicação"?
Conteúdo: Pendente (nada gerado) → Gerado (há rascunho) → Em aprovação → Aprovado. Publicação: Pendente → Agendado → Publicado (ou Falhou). Clique num selo para ver onde foi publicado (feed, carrossel, stories) e quando.
Aprovação e publicação
Como funciona a aprovação?
Quem cadastra e gera conteúdo envia o rascunho para aprovação. Um administrador ou usuário com permissão abre Aprovar Conteúdo e escolhe Aprovar e agendar (pode marcar uma data) ou Rejeitar (escolhendo o motivo; o conteúdo volta para rascunho e o motivo aparece em vermelho no card). Antes de aprovar, você vê uma prévia de como o post fica no Instagram. Para aprovar vários de uma vez, marque os cards e use Aprovar selecionados.
Só é possível aprovar se o produto tiver o link de afiliado real preenchido.
Como publico?
Conteúdo agendado pode ser publicado na hora (feed, carrossel ou stories) ou esperar: o orquestrador publica sozinho quando chega a data. Um mesmo produto não é publicado de novo no feed por alguns dias (período de carência) — o sistema avisa e você decide se quer publicar mesmo assim.
A plataforma do produto precisa estar Ativa; se estiver pendente ou inativa a publicação é bloqueada com um aviso.
Posso publicar de novo um conteúdo que já foi ao ar?
Sim: em um conteúdo publicado, use Republicar. Ele cria um conteúdo novo (o original não muda), ligado ao mesmo produto, para você comparar o desempenho das duas publicações.
Onde vejo tudo o que está agendado, publicado ou com falha?
Em Publicações, com abas: Agendadas, Publicadas, Falhas, Canceladas e Calendário (visão do mês, clique num item para abrir). O sino no topo mostra quantos conteúdos aguardam aprovação ou falharam.
Conta e segurança
Qual a diferença entre os cargos?
- Cadastrador — cadastra produtos, gera conteúdo e envia para aprovação. Não aprova nem publica.
- Usuário (editor) — tudo acima, mais aprovar, rejeitar e publicar.
- Administrador — tudo, mais Usuários, Log de Atividades e Configurações.
Esqueci minha senha / primeiro acesso
Na tela de entrada, clique em Esqueceu sua senha?, informe seu e-mail e siga o link recebido (vale 1 hora e só funciona uma vez; olhe também o spam). No primeiro acesso, o sistema pede para trocar a senha provisória antes de liberar o painel.
O que é o "olho" nos itens?
Mostra o histórico daquele item: quem cadastrou, editou, aprovou ou publicou, e quando — ou se foi algo automático do sistema.
Preciso de mais ajuda
Fale com o administrador do sistema. Se for um erro, anote a mensagem exibida na tela e o que você estava fazendo.
Plataformas
| Plataforma | Programa de afiliados | Comissão padrão | Status |
|---|
Nenhuma plataforma cadastrada ainda
Cadastre a primeira plataforma (ex: Shopee) para poder cadastrar produtos.
Busca manual
Busque produtos numa plataforma ativa (Shopee, Lomadee, Admitad ou Mercado Livre) e importe os que quiser?
Filtros
Nenhum resultado ainda
Escolha a plataforma, digite uma palavra-chave e busque.
Usuários
Apenas administradores
Só usuários com cargo de administrador podem ver e gerenciar outros usuários.
| Nome | Cargo | Status |
|---|
Credenciais das integrações
Conta do TikTok
Seu usuário ainda não tem a permissão para ver as credenciais.
• Se outro administrador já tem acesso: ele abre Usuários e clica em Dar acesso às credenciais na sua linha (pede a senha dele).
• Primeiro acesso (ninguém tem ainda): no servidor, coloque o seu e-mail em CREDENTIALS_ADMIN_EMAILS no .env e rode docker compose up -d api (só restart não relê o .env). Depois recarregue o painel.
Como funciona
Valores mascarados. Mostrar e Alterar pedem a sua senha; cada uso vai para o Log de Atividades (sem o valor) e mostrar manda um alerta por e-mail. O valor salvo aqui vale na hora e tem prioridade sobre o .env do servidor; apagar volta a valer o .env.?
⚠️ O servidor está sem CREDENTIALS_ENCRYPTION_KEY no .env: dá para ver, mas não para salvar credenciais pela tela.
Credenciais das plataformas
API Key / API Secret cadastradas em Plataformas (para alterar, use "Editar" lá).
| Plataforma | API Key | API Secret |
|---|
Quem pode ver esta tela
Só administradores. Quem entrou pela lista do .env (CREDENTIALS_ADMIN_EMAILS) só perde o acesso saindo dela.
| Administrador | Acesso |
|---|
Publicação e proteção
Situação agora
O que a publicação automática faria neste momento no Instagram e no Telegram: liberada ou segurada, por quê e até quando.?
Ritmo e proteção da conta
Onde publicar, janela de horário, quantas publicações por dia e o intervalo entre elas. Também o limite e o atraso das DMs automáticas. O anti-spam da DM fica em Configurações.
Fila de publicação
Quando cada conteúdo aprovado "na fila" sai: horários fixos ou a cada N minutos, por origem do produto (automação ou manual).?
Nicho variado por dia
Evita dois produtos da mesma família no mesmo dia da conta (ex.: blusa e bolsa = Moda).?
Mídia do produto e regras
Consulta de fotos e vídeo dos produtos e onde cada conteúdo sai (Reels, Feed, Stories, Telegram) conforme a mídia que o produto tem.
Onde ligar?
| O produto tem… | Reels | Feed | Stories | Telegram |
|---|---|---|---|---|
| 🎬 Vídeo com ou sem mais fotos |
carrossel se 2+ fotos |
álbum + vídeo | ||
| 🖼️ 2 ou mais fotos sem vídeo |
— | 🔒 sempre · carrossel |
álbum | |
| 📷 Só 1 foto | — | 🔒 sempre · foto única |
foto |
Captação automática
Busca produtos por regras e cria o rascunho. Tudo espera a sua aprovação?
| Regra | Busca | Resultado (histórico) | Status |
|---|
Nenhuma regra criada ainda
Crie uma regra (ex: "Fones Bluetooth") para o sistema começar a captar produtos sozinho.
Planejador de captação?
Ajustar o planejador
Perfis de automação
Quando um perfil vale de verdade
Um perfil só passa a valer de verdade se estiver ligado, com o modo sombra desligado e vinculado a uma regra de captação (campo "Perfil de automação" da regra). Antes disso, o modo sombra só registra o que teria sido aprovado — confira por uns 14 dias se os critérios estão bons. Mesmo com tudo ligado, produto com link de afiliado vazio ou suspeito nunca é aprovado sozinho.Contas de destino
Onde o Hub publica e responde DMs. Cada conta segue o padrão de Publicação e proteção e Configurações e só muda o que você personalizar. Captação, conversão do link e aprovação continuam únicas. Conta não se apaga, se inativa.?
⚠️ O servidor está sem CREDENTIALS_ENCRYPTION_KEY no .env: dá para cadastrar contas, mas não para salvar tokens pela tela.
Distribuição automática (padrão para todas as contas)
Ao aprovar, o Hub escolhe sozinho as contas de cada produto pela regra de cada conta (nicho, exclusivo, formato). Aqui ficam os padrões que valem para todas.
Carregando…
Publicações por conta
O que vai (ou foi) para cada conta além do fluxo da principal. Falha numa conta não trava as outras.
| Quando | Conta | Conteúdo | Situação | Detalhe |
|---|
Nenhuma publicação por conta com esse filtro.
Crescimento
Automações para ganhar alcance, cliques e comissão com pouco trabalho manual, sempre com guarda-corpo: tudo passa pelo governador (teto, intervalo, janela, carência), o que publica nasce desligado ou como sugestão, e o freio de segurança para tudo numa conta que começa a dar sinal de bloqueio.?
Campanha liga sozinha na data (1º dia = data − antecedência), cria regras de captação temporárias, pode subir o ritmo do Telegram (nunca o do Instagram), põe cupons em destaque (legenda, DM de cupons e /ofertas) e uma frase da campanha na legenda da IA. No fim, desliga as regras e devolve o Telegram ao valor de antes (se você mudou no meio, o seu valor fica).
| Campanha | Data | Janela | Situação | O que faz | |
|---|---|---|---|---|---|
| Carregando… | |||||
Regras das campanhas
Avalia cada conta a cada 10 min: DMs que falharam (e "ação bloqueada"/spam da Meta), publicações com falha, "Testar conexão" com erro, token vencido e queda do alcance. 🟡/🔴 = as automações novas (campanha no Telegram, "Baixou de preço") param de acelerar naquela conta, e você recebe aviso. A pausa automática vem desligada.
Regras do freio
Produto já publicado que baixou de preço volta como repost (conteúdo novo ligado ao original) com a legenda do preço atual e a linha "⬇️ Baixou: de R$ X por R$ Y" — só com preço que o Hub realmente viu. A queda é vista de graça pela captação e por uma varredura limitada. Desligado, só lista; ligado, cria rascunho para você aprovar (ou agenda "Só Telegram", se escolher). Produto que saiu da loja: o link leva ao /ofertas.
Regras do "Baixou de preço"
Comentários que não dispararam a DM (guardados sem autor pelo Copiloto) viram sugestões de palavra, com exemplos reais. As que parecem pedido de link/preço vêm primeiro. Adicionar = mais DMs, sempre sob o teto diário e o anti-spam de cada conta. Nada é adicionado sozinho.
Regras das sugestões
O resumo do dia (7h/13h/21h), os avisos do freio, das campanhas, do "Baixou de preço" e das falhas chegam no seu Telegram, com botões para aprovar (pede confirmação), rejeitar com motivo e abrir o painel. Usa um bot separado do canal. Cada botão respeita o seu cargo e vai para o Log.
Regras do Telegram pessoal
Produto sem vídeo e com 3+ fotos ganha um Reel vertical montado pelo Hub: gancho do roteiro da IA nos 3 primeiros segundos, as fotos com zoom lento e o preço + "Comenta PALAVRA" no fim (sem música: a biblioteca do Instagram não está na API). O vídeo passa a valer como "Tem vídeo" nas regras de mídia (Reel + Feed, TikTok). Vídeo de verdade sempre ganha. Gere alguns à mão e veja antes de ligar o automático.
Regras do Reel com fotos
Cliques nas 24 h depois de cada post, pela hora em que ele saiu (Brasília), por conta, nos últimos 30 dias. É a conta certa para escolher os horários da fila (a Calibração conta pela hora do clique, que só repete quando você publica). Só sugere: a fila muda em Publicação e proteção.
O Agente operacional escolhe, entre o que o Hub já tem pronto, o que vale agendar, agenda pela mesma fila da tela e confere se a plataforma confirmou. Ele nasce desligado, em ensaio (decide e registra, não agenda nada) e só age onde você liberar. Nunca segue, curte nem comenta por conta própria.?
Carregando…
Tarefas para você (no celular)
O que o Hub não consegue fazer por API (fixar post, conferir bio, reconectar conta) fica aqui, com o link que abre a rede no celular. Marcar como feita é uma declaração sua: o Hub não verifica e nunca conta isso como confirmação da plataforma.
Relatórios
O diário sai às 20:00 (Brasília) e o semanal no domingo, no Telegram pessoal; aqui ficam guardados. Só leitura: cada número diz se foi lido, e o que não foi lido aparece como "não lido", nunca como zero. Variação entre semanas é comparação no tempo, não causa.
Crescimento de audiência
Rotina editorial
Pilares (oferta, educativo, confiança, relacionamento), séries num dia fixo da semana e o calendário dos próximos 14 dias. Para o espaço vazio de uma série o agente prepara a pauta (tarefa para você) ou, se você ligar a IA do pilar, um rascunho de legenda. Rascunho nunca é agendado nem publicado sozinho: só a sua aprovação agenda. Nada de preço, percentual ou promessa no texto da IA.
Regras da rotina editorial
Perfil e conversão
Pesos da nota
Todos os pesos da nota do Copiloto (0 a 100) numa tela só: o checklist de 100 pontos, os ajustes (aprendizado, desempenho, Funil, mercado, idade) e as notas mínimas. Salvar grava tudo de uma vez ou nada. O padrão é o comportamento de antes; o agente não muda estes pesos sozinho.
Fator Funil da nota
Alcance e salvamentos por categoria (posts do Instagram, última leitura de cada um) contra a média. Vale de −5 a +5 pontos, só com amostra mínima e leitura da conta. É indício: o Hub não liga seguidor a post. Desligado, a nota não muda e a tabela mostra só o que valeria.
Regras do funil
Propostas do agente
Quando o mesmo indício por categoria se repete em 2 experimentos, o agente propõe mexer no fator Funil (ligar ou subir o teto em 1). Nada muda sem você aprovar aqui; dá para desfazer, e 14 dias depois ele mostra o antes e o depois (coincidência no tempo, não causa). Formato, chamada e horário viram tarefa, não configuração.
Ações de crescimento
Experimentos
Novo experimento
Radar de mercado
Pesquisa na web, no ritmo e no limite que você definir, o que está em alta nas categorias que o Hub vende e nos eventos que estão chegando. Ele só propõe: mostra os trechos dos sites e a força da evidência, e nada pesa na nota dos produtos até você aprovar. Roda junto do ciclo do agente (precisa estar ligado e não pausado) e não lê perfis de concorrentes.
Colar um texto público para o radar resumir
Cole um trecho público (uma matéria, um post) sobre o que está em alta e o(s) link(s) https de onde veio. A IA resume só o que você colou e vira uma proposta: nada pesa na nota sem a sua aprovação. O Hub não abre o link nem lê perfil de ninguém.
Regras do radar
Comentários dos posts
Os comentários dos últimos 7 dias separados por tipo, por regra de palavras (aproximada). O Hub só conta: não responde, não curte nem comenta. Perguntas e reclamações pedem uma resposta sua. Só o texto é guardado, sem autor.
Criadores (colaboração)
Uma lista para você acompanhar quem pode virar parceria. É só registro: o Hub não segue, não curte, não comenta nem manda mensagem a ninguém. Na data de retomar o contato o agente deixa uma tarefa para você.
Contas e o que o agente pode fazer
Livro de ações
Regras dos relatórios
Regras do agente
Regras das notificações push
Menos trabalho manual (C-65): pauta de gravação da semana e aviso dos vídeos do TikTok prontos para confirmar no seu Telegram pessoal, post semanal "melhores da semana" no canal do Telegram e o botão do canal no /ofertas. A confirmação do TikTok continua sua: o TikTok exige que a pessoa confirme cada post.
Carregando…
Regras do piloto automático
Visitas da página /ofertas (link da bio) contadas no servidor, sem IP e sem cookie, contra os cliques do TikTok e do Instagram. Mostra se a página converte quem chega.
Audiência própria
Membros do canal do Telegram (uma leitura por dia) e toques nos botões de canal do /ofertas, lado a lado. O Hub não sabe quem tocou e depois entrou; compare as séries, não some uma na outra. Entrar num grupo do WhatsApp mostra o número da pessoa aos outros: avise isso na descrição do grupo.
Categorias
Categorias da Shopee usadas na busca, na importação e na captação?
| Id | Categoria | Nome em português |
|---|
Categorias inconsistentes
Categorias inconsistentes?
Produtos que a captação encontrou de novo, mas que já estão cadastrados com outra categoria. Vale conferir qual está certa.
2ª foto do produto (feed Shopee)
2ª foto do produto (feed Shopee)?
Carregando…
Log de Atividades
| Quando | Resultado | Origem | Quem | Produto | Detalhe |
|---|
Nenhuma DM nesse período.
Carregando…
Filtros
| Quando | Quem | Ação | Entidade | Detalhe |
|---|
Tentativas de login com erro
Registro separado do log acima: e-mail ou senha errados. Várias tentativas seguidas do mesmo IP podem indicar alguém tentando adivinhar uma senha (só visibilidade — nada é bloqueado automaticamente).
| Quando | E-mail digitado | IP |
|---|
Nenhuma tentativa errada registrada
Configurações
Apenas administradores
Só usuários com cargo de administrador podem alterar essas configurações.
Orquestrador
Liga e desliga todas as publicações automáticas. Limites por dia, intervalo entre posts, janela de horário e onde publicar ficam em Publicação e proteção.
DM e comentários
O que acontece quando alguém comenta uma palavra-chave num post. Atraso da DM e limite por dia ficam em Publicação e proteção.
Testar a DM (simular comentário)
Simula um comentário e mostra a DM?
Cupons
Botão “Ver cupons” na DM e linha de cupom na legenda. Os dois só aparecem se houver cupom ativo e válido.
Cupons cadastrados
Cadastrados à mão?
Conteúdo e IA
Custo e formato do que a IA escreve, texto do Story, hashtags e modelos de campanha.
Hashtags por categoria
Hashtags-base por categoria?
Variação do texto da IA
Ângulos, públicos, emoções, tons e formatos?
Modelos de legenda
Modelos de campanha?
Produtos
Quando um produto pode voltar a ser publicado e quando ele é considerado parado.
Acesso à documentação da API
Quem pode abrir a página técnica api.hubdeafiliados.com.br/docs. Não é a conexão com Instagram, Shopee e outras plataformas: essas ficam em Credenciais e Plataformas (botão "Teste de conexão").
Quem pode abrir api.hubdeafiliados.com.br/docs. Cada pessoa tem usuário e senha próprios (mínimo 12 caracteres); as senhas ficam guardadas só em hash — nem aqui elas reaparecem. O acesso de reserva do servidor (.env) continua valendo.
Documentação do projeto
Mapa do projeto e fluxograma
Sobre estes documentos
Documentos internos do repositório (docs/), lidos direto do servidor — sempre a versão publicada. Contêm referências a configurações do sistema; não compartilhe fora da equipe.