Publicar põe na fila, não envia na hora. Ao publicar você escolhe em quais grupos e canais o produto sai — os das coleções dele já vêm marcados — e ele sai no ritmo da fila: horário da coleção, intervalo e limite do canal, rodízio dos números. Publicar cinquenta produtos não manda cinquenta mensagens. Produto já publicado num grupo só volta lá com queda de preço. O Status do WhatsApp (a aba Atualizações) aparece na mesma lista, desmarcado: o que vai para ele aparece para todos os contatos que têm o número salvo. Story para mim é outra coisa: manda a foto e a legenda para a conversa "Você" do chip admin do canal, na hora, para você compartilhar no status do canal pelo celular. Não conta como publicação e não tem limite.
Pesquisar no catálogo
A pesquisa acontece aqui: o RAF chama o painel de afiliados com a sessão sincronizada pela extensão, guarda o resultado e mostra abaixo. Marque o que presta e clique em Adicionar ao radar — só o que você escolher passa a ter histórico de preço e comissão.
Nova coleção
A coleção é o grupo de ofertas — "Sapatos", "Promoção esmalte". Ela não pertence a uma plataforma: recebe produto da Shopee e do Mercado Livre, e cada produto guarda de onde veio. Os canais escolhem a coleção que recebem; em Horários você diz quando as mensagens dela podem sair.
O texto da mensagem não é configurado aqui: cada coleção tem o seu na aba Modelos, e quem não tem usa o padrão do sistema.
Modelo da mensagem por coleção
A caixa já vem com o modelo em uso: o da coleção, se ela tiver um, ou o padrão do sistema — que é literalmente o texto que sai no grupo hoje. Edite por cima e salve. Serve para dar a uma coleção específica um texto de promoção sem mexer em nenhuma outra, na Shopee e no Mercado Livre.
O modelo controla onde cada coisa fica; os valores
continuam vindo do banco. São dois porque o Telegram renderiza HTML
(<b>) e o WhatsApp usa marcação própria
(*negrito*). Linha cujos marcadores vierem todos vazios
desaparece inteira — é o que faz o mesmo modelo servir para produto com
e sem desconto.
Quem tem modelo próprio
Números que divulgam
Cada mensagem sai por um número, em rodízio. Cada número espera um tempo sorteado entre o mínimo e o máximo dele, e só publica em grupo onde é dono ou admin (conferido a cada 30 minutos).
Dados do número
Ritmo deste número
Entre uma mensagem e outra, o número espera um tempo sorteado entre o mínimo e o máximo.
Avançado (WAHA)
Conectar o número ao WhatsApp
Escolha o número e leia o QR Code com o celular dele.
Escaneie o QR Code
- Abra o WhatsApp no celular
- Toque em Aparelhos conectados
- Toque em Conectar aparelho e aponte a câmera para o código
Conectar com código
- Informe abaixo o número do WhatsApp que vai divulgar
- No celular: Aparelhos conectados → Conectar aparelho
- Toque em Conectar com número de telefone e digite o código
Grupos e canais deste número
Dicas anti-bloqueio (segurança do WhatsApp)
- Número de uso diário (aquecido): use um número que você já conversa normalmente. Evite chip novo, comprado hoje, sem histórico de conversas.
- Ritmo de pessoa, não de robô: cada número espera um tempo sorteado entre a espera mínima e a máxima dele, e cada grupo tem o seu intervalo. Mais de um número divide a carga — nenhum chip precisa falar sozinho o dia todo.
- Grupos próprios: divulgue apenas em grupos ou canais onde você é dono/administrador e os membros entraram por vontade própria.
- Limite diário baixo: o WhatsApp não tem API oficial para este uso. Deixe o volume com o Telegram e use o Máx. por dia do canal.
O bot do Telegram
É ele quem publica nos canais e grupos do Telegram.
Como conectar
- No Telegram, fale com @BotFather, envie
/newbote copie o token. - Cole o token em
RAF_TELEGRAM_TOKENno.enve rode.\raf.ps1 restart. - Adicione o bot como administrador do canal ou grupo de ofertas.
- Cadastre o canal na aba Canais com o
chat_id(ex.:-1001234567890).
Resposta automática no direct desligada
Quem comentar uma das palavras-chave num post do feed recebe no direct o link do produto daquele post. A Meta permite uma mensagem por comentário, em até 7 dias. Cada pessoa recebe um link por post. Os pedidos e as respostas ficam em Estatísticas → Instagram.
+ Cadastrar conta do Instagram
Novo canal de transmissão
Um canal atende uma categoria — é assim que o grupo de skincare só recebe
skincare. No Telegram, use o chat_id do canal (ex.:
-1001234567890) com o bot como administrador. No WhatsApp, o
chatId do WAHA (ex.: 1203…@newsletter).
No WhatsApp, o intervalo é o do grupo: o tempo mínimo entre duas mensagens ali, qualquer que seja o número. O ritmo de cada chip é do número, na aba WhatsApp e Telegram. Em Números, escolha por quais números o grupo pode sair — só publica o que estiver como admin ou dono.
Nova tarefa agendada
Aqui mora a periodicidade que antes ficaria no n8n. Publicação
escolhe os melhores produtos da coleção, gera o anúncio e enfileira. A janela
de horário é opcional e vale no fuso configurado em RAF_TZ.
A coleta agendada saiu em 13/09/2026. Os produtos entram pela extensão, escolhidos a dedo no site da loja — que é onde os filtros prestam. Como consequência, preço e comissão não se atualizam sozinhos: um produto importado guarda o que foi lido no dia. Para atualizar, capture-o de novo pela extensão e importe na mesma coleção.
Transmissão
…
A fila é uma tabela no Postgres consumida com FOR UPDATE SKIP LOCKED.
Falha volta com backoff exponencial; depois do limite de tentativas, para em
falha e espera você.
No WhatsApp, o horário agendado é uma previsão: a mensagem só sai quando há um número livre que seja admin do grupo e o grupo já cumpriu o intervalo dele. A coluna Por mostra o número que enviou; num pendente vencido, ela diz o que ele está esperando.
Cliques por canal
Os envios levam o link curto próprio no lugar do link da loja; cada clique passa por ele e é contado aqui (a prévia do link, gerada por robô, não conta). Cada clique fica registrado com dia e horário; Hoje e 7 dias vêm desse registro, e o Total é desde que o link foi criado.
Cliques por horário
Anúncios gerados
Cupom roda em worker próprio, a cada RAF_INTERVALO_CUPONS_MIN minutos,
e fura a fila: ignora o intervalo mínimo e o limite diário do canal, porque a
validade é medida em horas. No WhatsApp, furar a fila é sair na frente dos anúncios —
o cupom ainda espera um número livre. Cupom de feed sem categoria não é publicado — ajuste o termo
de busca da categoria para ele passar a casar.
Nenhuma extensão RAF Flow conectada: os vídeos ficam na fila até uma abrir o painel lateral com o Flow aberto.
+ Novo vídeo
Produtos
Um vídeo para cada produto escolhido, todos com as opções abaixo. Em cada produto, as mídias de referência: as fotos e o vídeo do anúncio e as fotos que você enviar. Toque para ver, × para tirar, ⬇ para baixar.
Como é o vídeo
O prompt vem do cadastro (segmento Prompts). O formato vertical 9:16 é o da Shopee Vídeo e do TikTok.
Quem aparece opcional
O avatar é a pessoa cadastrada aqui, com fotos (segmento Avatares). O personagem é o cadastrado no próprio Flow, que a extensão inclui no comando. As fotos de referência do produto ficam na etapa 1.
↑ Enviar vídeo pronto
Para o vídeo gravado ou editado fora do Flow. Ele entra na grid já aprovado — quem envia é quem revisaria — e segue para o registro de publicação como os outros.
De qual produto
Procure o produto no radar. Para trocar o arquivo de um vídeo que já está na grid, use Enviar arquivo na linha dele.
O arquivo
MP4 ou WebM, até 200 MB. O formato e a duração são lidos do próprio arquivo; confira.
Novo prompt
Marcadores (clique para inserir):
Linha cujos marcadores vierem vazios some inteira — o mesmo prompt serve com e sem avatar. O que o pedido
trouxer e o prompt não citar entra no fim do texto.
Novo avatar
Salve o avatar e depois envie as fotos dele no cartão abaixo (até 6). São elas que o Flow usa como referência do rosto.
Personagens do Flow
Cadastrados no próprio Flow, em qualquer projeto. A extensão RAF Flow lê a lista quando conecta com o Flow aberto, e pelo botão Ler personagens do Flow do painel dela. No pedido de vídeo, escolha em Personagem do Flow.
RAF Roteirista
O programa que escreve os roteiros, na sua máquina, com o Claude CLI (ou o Codex) logado na sua conta. A fila só anda com um deles conectado e com o motor apto.
Fila do roteiro
Produto pedido no Radar entra aqui sozinho; em Vídeos, marque um ou vários e clique em Gerar roteiro — quantas vezes quiser, cada pedido vira uma versão no log. Falha passageira é repetida pelo RAF; sessão do CLI caída ou limite de uso param a fila sem gastar tentativa.
Log dos processamentos
Como instalar o RAF Roteirista
- Instale o Claude Code na máquina e entre na sua conta: abra um terminal, rode
claudee faça o login. (Para o GPT, instale o Codex CLI e rodecodex login.) - Abra o
RAF-Roteirista.exe(pastaconsumidor/distdo repositório). - Informe o endereço do RAF e entre com seu login e senha (o perfil precisa de Vídeos: editar e Usar a extensão).
- Escolha o motor na lista — o que não estiver instalado ou logado aparece marcado — e deixe o programa aberto: ele pega a fila sozinho.
Extensões RAF Flow
Cada navegador com a extensão ganha um nome sorteado. Conectada = painel lateral aberto e falando com o RAF; para gerar, o Flow precisa estar aberto num projeto e calibrado.
Como instalar a extensão RAF Flow
- No Chrome do perfil da conta do Flow: chrome://extensions → Modo do desenvolvedor →
Carregar sem compactação → a pasta
extensao-flow. - Clique no ícone da extensão: o painel abre à direita. Fixe o ícone na barra pelo alfinete do menu de extensões.
- Informe o endereço do RAF e entre com seu login e senha (o perfil precisa de Vídeos: editar e Usar a extensão).
- Abra o Flow, entre num projeto e calibre a caixa do prompt e o botão de gerar (uma vez só).
Aparelhos
Cada celular com o RAF Agente consome a fila da conta da Shopee logada nele. Cadastre aqui e digite no aplicativo o código de 6 dígitos (vale 10 minutos).
Novo aparelho
Mandar um vídeo aprovado
Escolha o vídeo, confira o link do produto e a legenda. A legenda cabe em 150 caracteres e o rótulo de conteúdo gerado por IA vai sempre ligado. O padrão é postar: o aplicativo publica o vídeo. Em rascunho ele para em “Salvar rascunho” e você confere na Shopee antes de publicar.
Fila e resultado
O que está na fila, o que o aparelho está fazendo agora e o que falhou — com a foto da tela onde parou.
Vitrine do Afiliado
Produtos mandados do Radar (marque e clique em “Inserir na vitrine”). O aparelho cola o link de afiliado na vitrine da Shopee e marca a categoria. Ele faz uma coisa por vez: o vídeo passa na frente e a vitrine ocupa o tempo que sobra, com a mesma pausa entre uma tarefa e outra.
Roteiro de telas da Shopee (avançado)
Como instalar o RAF Agente no celular
- Instale o APK do RAF Agente (fora da Play Store) e abra o aplicativo.
- Toque em cada permissão até as três ficarem com ✓: Acessibilidade, sem economia de bateria, notificações.
- Cadastre o aparelho acima e digite no aplicativo o código de 6 dígitos.
- Deixe a Shopee logada na conta certa, o aparelho na tomada e sem bloqueio de tela.
Nova conexão de API
As credenciais são cifradas antes de ir para o banco e nunca voltam em texto puro para esta tela.
403 PolicyAgent em todo o
catálogo, então esta plataforma coleta reproduzindo as chamadas do próprio
painel de afiliados, autenticadas pela sua sessão.
- Instale a extensão em
extensao/(Chrome → Extensões → Modo do desenvolvedor → Carregar sem compactação). - Abra o painel de afiliados logado e clique em Sincronizar sessão.
- Navegue no site normalmente e marque os produtos com Shift + clique, ou varra a busca inteira pelo painel lateral da extensão.
Coletas
Quem pôs produto no radar, quando e quantos — pela extensão ou pela aba Buscar. Detalhar abre o lote produto a produto, com a coleção em que entrou e o motivo de cada recusa. O resumo em cima é o total por usuário no período, e Por dia abre o mês escolhido dia a dia (abre no mês corrente).
Por dia
Coletas agendadas por alvo
Eventos dos workers
A página de canais — /canais/
Duas páginas: /canais, com todos os botões, e
/grupowhats,
só o grupo e o canal do WhatsApp, passo a passo — para mandar a quem não é do Instagram.
Cinco botões: Instagram, Facebook, TikTok Shop, o canal e o grupo do WhatsApp. O do grupo
é um link inteligente — leva sempre para o grupo da vez: o primeiro, na ordem, ainda
abaixo do limite de membros e com convite lido. Encheu, o mesmo link passa a levar para o
seguinte. Sem grupo com vaga, ele cai no canal. Atalhos para bio e story:
/grupo, /canal, /instagram, /facebook,
/tiktok (todos registram o clique).
Os grupos, na ordem do link inteligente
Deixe os grupos criados em Canais (o botão Criar próximo grupo faz isso no WhatsApp, com os mesmos números). Membros e convite são lidos a cada verificação dos números; o convite exige que um número do RAF seja admin do grupo.
Acessos
Acessos do período
Posts do feed, pedidos nos comentários e respostas
Posts e produtos — ordene por “Curtidas 24 h” para ver o que está em alta
Pedidos e respostas — todo comentário, respondido ou não
Novo usuário
Cada usuário tem um perfil, e o perfil diz o que ele pode ver e editar. Trocar a senha ou desativar derruba as sessões abertas dele — no painel e na extensão.