Precisa de atenção
Atividade
Fila de envio
Um envio a cada min por grupo, no máximo por hora. Ofertas com mais de min na fila são descartadas.
Postar uma promo
Achou uma oferta boa? Cole o link: o bot troca pelo seu link de afiliado, pega a foto e o preço e você revisa antes de mandar.
Vendas
Comissões do Mercado Livre, da Shopee e da Amazon num lugar só.
Comissão por dia
Nenhuma venda nesse período. As vendas aparecem aqui depois que o bot lê os painéis (a cada 3 horas, ou em Atualizar agora).
Ver em tabela, dia a dia
| Dia | Total | |
|---|---|---|
| Loja | Vendas | Vendido | Comissão |
|---|---|---|---|
| Produtos que mais renderam | Vendas | Comissão |
|---|---|---|
Todas as vendas do período
| Dia | Loja | Produto | Unid. | Valor | Comissão | Situação |
|---|---|---|---|---|---|---|
Importar vendas da Amazon (a Amazon não tem como o bot ler sozinho)
- No Amazon Associados, abra Relatórios.
- Escolha o período e baixe o relatório de ganhos em CSV.
- Escolha o arquivo aqui. Pode importar de novo depois: o bot não duplica as vendas.
Origens
De onde vem quem abre a página dos grupos e clica em Entrar. Use um link com etiqueta em cada lugar onde divulgar.
Criar link com etiqueta
A etiqueta é livre (letras, números e hífen). Quem abre não vê diferença. O rodapé das mensagens já usa "rodape".
Cliques em Entrar por hora
dia▼ = post que você anotou no diário naquela hora. Pico logo depois de um ▼ = aquele post trouxe gente. Passe o dedo ou o mouse nas barras para ver de onde veio.
Ver em tabela
| Hora | Visitas | Cliques em Entrar | Posts |
|---|---|---|---|
| Origem | Visitas | Entrar | Taxa |
|---|---|---|---|
| Nenhuma visita nesse período ainda. | |||
| Grupo | Entrar | Principal origem |
|---|---|---|
| Nenhum clique em Entrar nesse período. | ||
Pessoas nos grupos
| Grupo | No começo | Agora | Diferença |
|---|---|---|---|
| O bot guarda o tamanho dos grupos a cada 3 horas. Os números aparecem aqui a partir de hoje. | |||
| Quando | Post | Visualiz. | |
|---|---|---|---|
| Nenhum post anotado nesse período. | |||
Categorias
Cada categoria manda para os grupos que você escolher. Os canais de origem dizem a categoria de cada oferta.
Canal geral
Canais de origem
Canais do Telegram que o bot lê. Cada post novo vira uma oferta da categoria escolhida.
| Ativo | Canal | Categoria | Situação | |
|---|---|---|---|---|
| Lendo Não encontrado Desativado Salve para conectar |
A conta do Telegram entra sozinha nos canais ao salvar. Só posts de produto único (Mercado Livre ou Amazon) viram oferta.
Os números conectados aqui postam nos grupos. Tenha mais de um como reserva: se um cair, o outro assume.
docker compose up -d.
- Abra o WhatsApp no celular do número que vai postar.
- Toque em Aparelhos conectados e depois em Conectar um aparelho.
- Aponte a câmera para este código. Ele se renova sozinho.
Quando mais de um número está no mesmo grupo
Nos dois casos, se um envio falhar, o próximo número tenta na hora. Em grupos diferentes, posta quem estiver no grupo.
Fotos da marca
Troca a foto dos grupos pelas da Promo Insana (uma por categoria) e, se quiser, a foto de perfil dos números.
Carregando…
Perfil dos números (opcional)
Coloca o símbolo da Promo Insana como foto do número que posta. Só faça se o número for só do bot.
Grupos
| Grupo | Números no grupo | Categorias | Enviadas hoje | ||
|---|---|---|---|---|---|
Se o grupo só deixa admins enviarem, cada número precisa ser admin dele.
Página dos seus grupos
Uma página com o botão de entrar em cada grupo, para você divulgar um link só.
O link de convite, a foto e o número de pessoas de cada grupo são pegos sozinhos (o número do bot precisa ser admin) e atualizados a cada 6 horas. Sem foto no grupo, aparece o emoji. Salve para publicar as mudanças.
Quando um grupo lotar
O bot cria o próximo (ex.: GERAL 2) com o mesmo nome, descrição, foto e regras, posta nos dois e a página passa a mandar o pessoal para o novo. Ele te avisa quando fizer.
O WhatsApp aceita até 1.024 pessoas por grupo. Os outros números do bot entram como admin sozinhos; coloque aqui o seu número pessoal para você também ser admin. Confere a cada 30 minutos.
Conexão com a Evolution API (só mude se a Evolution estiver em outro endereço)
Com a chave em auto, o bot lê a chave do arquivo evolution/.env que veio com ele.
Contas
Onde o bot lê as ofertas (Telegram) e gera os seus links (Mercado Livre e Amazon).
Telegram
Pegue em my.telegram.org, em API development tools. Salve antes de entrar na conta.
Mercado Livre
Atenção: nesse modo o Mercado Livre pode não contar a comissão.
Fotos e preços pela API oficial
Como configurar (uma vez, uns 5 minutos)
- Entre em developers.mercadolivre.com.br com a sua conta e crie uma aplicação (nome: PromoBot).
- Em URI de redirect, cole exatamente:
- Escopo: leitura (read) basta. Salve a aplicação.
- Copie o Client ID e o Client Secret para os campos abaixo e clique em Salvar alterações.
- Clique em Conectar API e autorize na página do Mercado Livre.
| Consulta | Resposta | Fotos |
|---|---|---|
|
| Produto | Data | Unid. | Valor | Comissão | % |
|---|---|---|---|---|---|
Cliques ainda não aparecem: o painel não carregou esse número nas páginas que o bot abriu. Baixe o arquivo acima e me mande para eu ligar os cliques também.
Importar sessão (no servidor, onde não abre janela de login)
- No Chrome do seu computador, instale a extensão Cookie-Editor.
- Abra mercadolivre.com.br já logado na conta de afiliado.
- Clique na extensão, depois em Export e em JSON (copia para a área de transferência).
- Cole aqui e clique em Importar.
Amazon
Essa tag não é válida: use a sua tag do Amazon Associados (termina em -20). Enquanto isso, as ofertas da Amazon são puladas.
Shopee
Como pegar o AppID e o Secret (uma vez)
- Entre em affiliate.shopee.com.br com a sua conta de afiliado aprovada.
- Procure o menu Open API (fica em Ferramentas ou no fim do menu lateral) e peça o acesso, se ainda não tiver.
- Copie o AppID e o Secret para os campos abaixo e salve.
- Teste com um link de produto da Shopee.
Canais do Telegram que postam Shopee entram normalmente em Canais. O bot troca o link do concorrente pelo seu link oficial da Shopee.
Ajustes
Ritmo de envio, filtros e o modelo da mensagem.
Ritmo de envio
Filtros
Exemplo. Use "Testar um post" logo abaixo para ver com um produto de verdade. Se a arte falhar por algum motivo, vai a foto normal.
O que o bot repassa e em que ordem
Textos variados
Para os posts não ficarem todos iguais (menos cara de robô e menos risco de o WhatsApp marcar como spam).
Modelo da mensagem
Campos: {emoji} {title} {old_price} {price} {price_qualifier} {coupon} {store} {link} {cta} {urgency}. Linha com campo vazio some sozinha. Use *negrito*, _itálico_ e ~riscado~.
Para ter vários formatos, separe-os com uma linha só com ---: cada post sorteia um.
Testar um post
Cole um post de um canal e veja o que o bot faria. Nada é enviado.
Avisos e resumo do dia
O bot te avisa quando algo parar (Telegram, WhatsApp, Mercado Livre, fila travada) e quando voltar. Só avisa se o problema durar alguns minutos.
Use no aviso um número seu diferente dos que mandam as promos. Deixe vazio para receber só no Telegram.
Endereço do painel
Para usar seu domínio (ex.: promoinsana.com.br) no painel e na página dos grupos. Antes, no Registro.br, crie os registros A (nome em branco e www) com o valor .
O www. ainda não aponta para cá. Dá para seguir; só o endereço com www fica sem funcionar até você criar o registro.
Ao trocar, o bot reinstala a versão atual (2 a 5 min). O endereço antigo continua funcionando e manda para o novo. Você vai precisar entrar de novo com a senha.
Atualizar o bot
Disponível só no servidor. Aqui no PC, atualize trocando a pasta pelo zip novo.
Escolha o promobot.zip novo e clique em Instalar. Leva de 2 a 5 minutos; suas contas, grupos e configurações continuam. O painel recarrega sozinho no fim.
O instalador não começou. No servidor, rode: systemctl status promobot-update.path
Senha do painel
Registro
Tudo o que o bot fez nos últimos dias e o log técnico desta sessão.
| Hora | O quê | Detalhe |
|---|---|---|