Spaces:

akra35567
/

INDEX

Runtime error

Webpmux não instalado (não é obrigatório)
```
npm install node-webpmux
```
Sem isto, sticker funciona mas sem EXIF
WhatsApp não carrega metadados
- Alguns celulares antigos não mostram
- Tente em outro aparelho
Sticker muito antigo
- Metadados só em stickers novos
- Resend com #sticker novamente

P3: Qual é a diferença entre #sticker e #gif?

Comando	Entrada	Saída	Limite
#sticker	Imagem	Sticker estático	100KB
#gif	Vídeo	Sticker animado	500KB, 30s

Resumido: #sticker = foto, #gif = vídeo

P4: Por que não consigo usar #reveal?

A: Precisa ser Admin ou Dono do grupo:

✅ Permitido:
  - Criador do grupo
  - Admin (pode ver conversas deletadas)

❌ Bloqueado:
  - Membro comum
  - Moderador (sem permissão admin)

Solução: Pedir ao admin para usar ou virar admin

P5: View-once desaparece depois que eu revelo?

A: NÃO! Comportamento correto:

1. Amigo envia imagem com view-once (será deletada automaticamente)
2. Você (admin) faz #reveal
3. Você recebe a imagem revelada
4. Imagem original AINDA desaparece (é por design)
5. Você tem a cópia revelada pra sempre

É assim que deve ser! Protege privacidade

P6: Posso converter qualquer view-once em sticker?

A: Sim! Todos os tipos:

✅ Imagem view-once → Sticker estático
✅ Vídeo view-once → Sticker animado
✅ Áudio view-once → [Não, só imagem/vídeo]
✅ Sticker view-once → Sticker repersonalizado

Use #vosticker para qualquer um

P7: Por que algumas músicas do YouTube não baixam?

A: 3 causas possíveis:

Vídeo geobloqueado
- Solução: Sistema tenta yt-dlp primeiro (faz bypass)
- Se ainda falhar: Use VPN ou outro link
Copyright/DMCA takedown
- Solução: Nenhuma, video removido do YouTube
URL inválida ou deletada
- Solução: Verificar link ou tentar outro

Dica: Se falhar com ytdl-core, yt-dlp geralmente funciona!

P8: Qual método de download YouTube é melhor?

A: Sistema escolhe automaticamente:

Prioridade 1: yt-dlp
  ✅ Mais robusto
  ✅ Bypass geobloqueio
  ✅ Bypass 403 Forbidden
  ⚠️  Precisa instalar no sistema

Prioridade 2: ytdl-core (fallback)
  ✅ Puro Node.js
  ✅ Sem instalação extra
  ⚠️  Limitado em alguns casos

Recomendação: Instalar yt-dlp para melhor resultado

P9: Sticker fica comprimido/ruim - por quê?

A: Possíveis causas:

Imagem original ruim
- Solução: Usar imagem de melhor qualidade
Redimensionamento automático
- Solução: Enviar em 512x512 (ou próximo)
Compressão do WhatsApp
- Solução: Normal, nem sempre dá pra evitar

Dica: Quanto melhor a imagem original, melhor o resultado

P10: Posso criar sticker de sticker?

A: Sim! Pode repersonalizar:

1. Enviar sticker de outro bot
2. Responder com: #sticker
3. Resultado: Mesmo sticker, novo pack "akira-bot-[seu_nome]"

Útil para: Reorganizar stickers antigos

🚨 TROUBLESHOOTING - ERROS COMUNS

❌ Erro: "Imagem não encontrada"

Causa: Mensagem não tem imagem

Solução:

Correto: Responder a uma imagem com #sticker
Errado: Digitar #sticker sem responder a nada

Exemplo certo:
[Imagem enviada]
Responder: #sticker

❌ Erro: "Vídeo muito grande"

Causa: Arquivo > 100MB

Solução:

1. Usar vídeo menor (< 100MB)
2. Comprimir antes:
   ffmpeg -i video.mp4 -crf 28 -s 512x512 output.mp4

3. Ou usar #gif (máx 30s, 500KB)

❌ Erro: "FFmpeg não encontrado"

Causa: FFmpeg não instalado

Solução:

# Linux (Ubuntu/Debian)
sudo apt-get update
sudo apt-get install ffmpeg
ffmpeg -version  # Verificar

# Windows (Chocolatey)
choco install ffmpeg
ffmpeg -version  # Verificar

# macOS
brew install ffmpeg
ffmpeg -version  # Verificar

❌ Erro: "yt-dlp não encontrado"

Causa: Sistema opcional, mas recomendado

Solução:

# Instalação 1: Via pacote (recomendado)
# Linux
sudo apt-get install yt-dlp
yt-dlp --version

# Windows
choco install yt-dlp
yt-dlp --version

# Instalação 2: Via Python
pip install yt-dlp
yt-dlp --version

# Instalação 3: Manual
# Download: https://github.com/yt-dlp/yt-dlp/releases
# Windows: Colocar em C:\bin\yt-dlp.exe
# Linux: Colocar em /usr/local/bin/yt-dlp
chmod +x /usr/local/bin/yt-dlp

Teste:

yt-dlp "https://youtube.com/watch?v=abc123" --extract-audio --audio-format mp3 -o "test.mp3"

❌ Erro: "Webpmux não instalado"

Causa: Pacote opcional (graceful fallback ativo)

Solução:

# Instalar (recomendado para metadados EXIF)
npm install node-webpmux

# Se falhar, instale dependências:
# Linux
sudo apt-get install libwebp-dev

# Windows (já incluído no npm)

# Teste
node -e "require('node-webpmux')"

Sem Webpmux: Sticker funciona, apenas sem metadados EXIF

❌ Erro: "403 Forbidden - YouTube"

Causa: Vídeo bloqueado/geobloqueado

Solução:

Automática: Sistema tenta yt-dlp primeiro (faz bypass)
Manual: 
  1. Instalar yt-dlp (vê acima)
  2. Tentar #play novamente
  3. Se ainda falhar: usar VPN

Alternativa: Tentar outro link do mesmo vídeo

❌ Erro: "Não é view-once"

Causa: Mensagem não é view-once

Solução:

Diferenciar:

View-once (auto-deleta):
[Uma imagem com "ícone de relógio"]
→ Use #reveal ou #vosticker

Mensagem normal:
[Uma imagem normal, sem ícone especial]
→ Use #sticker normalmente

Dica: View-once aparece com ícone especial no WhatsApp

❌ Erro: "Comando restrito"

Causa: Você não é admin/dono

Solução:

Para #reveal (admin-only):
  1. Peça ao admin para revelar
  2. Ou vire admin
  3. Ou use #vosticker (permite qualquer um)

Para outros comandos:
  Pode usar normalmente (sem restrição)

❌ Erro: "Sticker muito grande"

Causa: Imagem > 1024x1024 pixels

Solução:

Opção 1: Redimensionar antes de enviar
  - Usar app de edição (Photoshop, Paint, etc)
  - Reduzir para 512x512 ou menos

Opção 2: Sistema faz automático
  - Enviar que o bot redimensiona
  - Mas PIOR qualidade

Recomendação: Redimensionar antes = melhor resultado

❌ Erro: "Vídeo muito longo"

Causa: Vídeo > 30 segundos em #gif

Solução:

Opção 1: Cortar vídeo antes de enviar
  ffmpeg -i video.mp4 -ss 0 -t 30 output.mp4

Opção 2: Enviar tipo-time menor
  [Vídeo 10s] #gif → OK

Limite duro: #gif é 30s máximo, 500KB

❌ Erro: "Nenhum método funcionou"

Causa: Ambos yt-dlp e ytdl-core falharam

Solução:

Debug steps:
1. Verificar internet: ping youtube.com
2. Verificar URL: Copiar e abrir no navegador
3. Verificar firewall: Bloqueia YouTube?
4. Verificar VPN: Tem VPN ligado?

Se tudo OK:
- Tentar outro URL
- Tentar outra música
- Reportar bug com URL específico

🔍 DEBUG - VERIFICAR INSTALAÇÕES

Checklist de Dependências

# 1. Node.js
node --version       # Deve ser v14+

# 2. NPM Packages
npm list @distube/ytdl-core  # Ou ytdl-core
npm list node-webpmux        # Opcional mas recomendado
npm list fluent-ffmpeg       # Deve estar

# 3. Sistema
ffmpeg -version      # Deve estar instalado
yt-dlp --version     # Opcional mas recomendado

# 4. Caminhos (Linux)
which ffmpeg
which yt-dlp
which python3

# 5. Permissões (Linux)
ls -la /usr/local/bin/yt-dlp
# Deve ter: -rwxr-xr-x

Verificar Logs

# Ver logs detalhados
grep -i "sticker" logs/bot.log | tail -20
grep -i "error" logs/bot.log | tail -20
grep -i "youtube" logs/bot.log | tail -20

# Ou em tempo real
tail -f logs/bot.log | grep -i "sticker"

📞 CONTATO PARA SUPORTE

Se nenhuma solução acima funcionar:

Forneça:
1. Mensagem de erro completa
2. Comando usado
3. Sistema operacional (Windows/Linux)
4. Versão do Node.js (node --version)
5. Último log relevante
6. Se possível: Reprodutor mínimo

Exemplo:
  OS: Ubuntu 20.04
  Node: v16.13.0
  Comando: #gif [responder a video.mp4]
  Erro: "FFmpeg not found"
  Log: [14:32:10] ERROR FFmpeg is not installed

✅ CHECKLIST DE VERIFICAÇÃO

Antes de reportar bug:

Atualizei todas as dependências
Instalei FFmpeg (sistema)
Instalei yt-dlp (recomendado)
Restarteiu o bot
Limpei cache temporário
Testei em outro grupo
Tentei comando diferente
Verifiquei internet está OK
Confirmei que é realmente view-once (se aplicável)
Li este FAQ completamente

🎓 DICAS PRO

Dica 1: Otimizar Conversão de Sticker

# Pré-processar imagem antes de enviar:
ffmpeg -i image.jpg -vf "scale=512:512:force_original_aspect_ratio=decrease,pad=512:512:(ow-iw)/2:(oh-ih)/2" -quality 90 output.jpg

# Resultado: Melhor qualidade, mais rápido

Dica 2: Verificar Integridade yt-dlp

# Testar download com yt-dlp
yt-dlp "https://www.youtube.com/watch?v=...key..." \
  --extract-audio \
  --audio-format mp3 \
  --audio-quality 0 \
  -o "test.mp3"

# Se funcionar aqui, funciona no bot também

Dica 3: Cache de Downloads

# Limpar cache de FFmpeg
rm -rf /tmp/ffmpeg_*

# Limpar cache do sistema
df -h  # Ver espaço disponível

Dica 4: Monitorar Performance

# Ver uso de CPU/memória
top -p $(pgrep -f "index.js")

# Ver processos abertos
ps aux | grep -E "(ffmpeg|yt-dlp)"

# Ver arquivos temporários
ls -lah /tmp/ | grep -E "(webp|mp3|mp4)"

📚 REFERÊNCIAS

Desenvolvido com ❤️ por Isaac Quarenta
Akira Bot v21 - Enterprise Grade 2025

Última atualização: Janeiro 2025
Versão: v21.2025
Status: ✅ Pronto para produção