Transforme seu Grupo do Telegram em um Cloud Drive com o KF Drive (KF Host Desktop Tools)

Olá, pessoal! Hoje vamos ensinar como utilizar o projeto KF Host Desktop Tools 2.0.0 (Beta) para transformar um grupo do Telegram em um drive na nuvem semelhante ao Google Drive, utilizando o sistema KF Drive.

Neste tutorial, você vai aprender do zero como configurar seu bot, conectá-lo ao KF Drive e começar a gerenciar seus arquivos.

⚠️ Avisos Importantes e Recomendações de Segurança

Antes de começarmos, por favor, leia atentamente:

• Fase BETA: O sistema está em fase Beta. Embora utilize práticas modernas de segurança, nenhum sistema é 100% à prova de falhas.
• Não use para arquivos sensíveis: NUNCA faça upload de documentos pessoais, fotos íntimas, senhas ou arquivos empresariais críticos.
• Caso de Uso Ideal: O KF Drive é altamente recomendado para arquivos básicos como filmes, jogos, programas e backups de projetos públicos. O intuito é armazenar arquivos cuja perda ou vazamento não cause transtornos ao usuário.
• Isolamento: Crie um grupo privado apenas com você e o seu bot. Não utilize este bot para mais nada além do sistema KF Drive.

Passo 1: Como criar o seu Bot no Telegram

Para que o sistema funcione com segurança e sem precisar do seu código de usuário, usaremos a API oficial de Bots do Telegram. Leia mais sobre o tema.

1. Abra o seu Telegram (celular, tablet ou computador) e pesquise por @BotFather.
2. Clique no perfil oficial (certifique-se de que tem o selo azul de verificação).
3. Clique em "Começar" ou envie o comando /start.
4. Envie o comando /newbot para criar um novo bot.
5. O BotFather pedirá um Nome de Exibição (ex: Meu Cloud Bot 🤖). Digite e envie.
6. Em seguida, ele pedirá um Username (Nome de Usuário). Ele deve ser único, sem espaços e obrigatoriamente terminar com a palavra bot (ex: meu_cloud_drive_bot).
7. Se aceito, o BotFather enviará uma mensagem com o seu Token (um código longo parecido com 1234567890:ABCdefGhIJKlm...).
   • Guarde esse Token em segurança! Ele é a "senha" do seu bot.

Passo 2: Criando o Grupo e Obtendo o ID

1. Crie um novo Grupo Privado no Telegram.
2. Adicione o Bot que você acabou de criar como membro deste grupo.
3. Para obter o ID do Grupo, acesse o Telegram pelo navegador (https://web.telegram.org/).
4. Clique no grupo que você criou. Olhe para a URL (endereço) no seu navegador. O ID será a numeração que vem logo após o símbolo # (exemplo: se a URL terminar com #-1001618174422, o seu ID é -1001618174422).

Passo 3: Criando sua conta e Adicionando o Grupo no KF Host

Para acessar o KF Drive, você precisa ter uma conta no nosso site.

1. Acesse o KF Host e crie a sua conta.
2. Verifique o seu e-mail clicando no link enviado pela nossa plataforma.
3. Após o login, vá até a tela inicial do KF Drive e clique no botão "+ ADD NEW" (Adicionar Novo).
4. Preencha os dados:
   • Group/Channel Name: Dê um nome para o seu drive (será o nome da pasta principal).
   • Bot Token: Cole o Token gerado no Passo 1.
   • Chat ID (Group): Cole o ID do grupo (incluindo o sinal de menos -, se houver).
   • Image URL: (Opcional) Pode deixar em branco.
5. Salve as configurações.

O que é “Is Supergroup?”
Esse campo está relacionado ao ID do grupo no Telegram. Inicialmente, todo grupo possui um ID próprio. Porém, quando o grupo atinge um certo nível de atividade ou número de membros, o Telegram pode convertê-lo automaticamente em um Supergroup, atribuindo um novo ID ao grupo.

Na maioria dos casos, você pode deixar essa opção desmarcada. Quando o Telegram converte um grupo em Supergroup, o ID antigo passa a funcionar apenas em modo de leitura. Durante os processos de upload ou download, o sistema tenta identificar automaticamente essa mudança. Caso o Telegram rejeite a operação usando o ID antigo, o sistema verifica se o ID do grupo foi alterado e atualiza para o novo ID automaticamente.

Na prática, essa transição normalmente acontece de forma transparente e você nem perceberá a mudança. No entanto, se os uploads ou downloads pararem de funcionar, é recomendável verificar o ID atual do grupo no Telegram para confirmar se ele não foi alterado.

Até onde se sabe, essa mudança de ID ocorre apenas uma vez, quando o grupo é convertido para Supergroup.

Passo 4: Como usar o KF Drive e seus Recursos

Pronto! Seu grupo está cadastrado. No menu superior, clique em "My Files" e dê um duplo clique no drive que você acabou de criar.

O que você precisa saber sobre o uso:

• Downloads: Arquivos podem ser baixados diretamente pelo navegador arquivos de até 19MB. Porém, arquivos maiores são divididos em várias partes funcionam melhor e são reagrupados se baixados diretamente pelo Software KF Host Desktop Tools 2.0.0.
• Áudios: Músicas e áudios de até 19MB podem ser reproduzidos diretamente pelo navegador.
• Assistir a Vídeos/Filmes: O sistema permite reproduzir vídeos. Se for pelo software, ele pedirá para baixar a biblioteca LibVLC (se você permitir, ele baixa sozinho e inicia o filme). O carregamento inicial pode demorar um pouco.
• Limpando o Cache: Quando você "assiste" a um filme, o sistema na verdade está baixando os dados como cache. Se o uso do seu disco local estiver alto, clique com o botão direito e vá em Manage Cache para limpá-lo.
• Imagens: O carregamento de miniaturas de imagens pode ter um leve delay, pois o sistema busca cada imagem diretamente do Telegram.

Entendendo a Exclusão de Arquivos (A Regra das 48 horas)

No sistema, você pode mover arquivos para a lixeira e restaurá-los quando quiser. No entanto, existe uma limitação importante da API do Telegram: bots não podem excluir mensagens após 48 horas.

Isso significa que, se um arquivo permanecer na lixeira por mais de 48 horas e você tentar excluí-lo permanentemente, o sistema não conseguirá apagar as mensagens do Telegram. Nessa situação, será oferecida a opção de ocultar o arquivo, removendo-o da interface do sistema.

Caso você realmente queira remover o arquivo do Telegram, é possível fazer isso manualmente. Na seção Propriedades, você encontrará o ID do arquivo, que é único para cada upload. Mesmo que o arquivo esteja dividido em muitas partes (por exemplo, 500 partes), todas as mensagens enviadas para o grupo contêm esse mesmo ID.

Portanto, ao pesquisar esse ID dentro do grupo do Telegram, todas as mensagens correspondentes às partes do arquivo serão exibidas. A partir daí, você poderá excluir essas mensagens manualmente.

Como apagar todas as partes pode ser trabalhoso, uma alternativa é excluir apenas algumas partes específicas, como as primeiras, as últimas ou algumas partes intermediárias. Mesmo que alguém consiga baixar as partes restantes, o arquivo não poderá ser reconstruído, pois faltarão dados necessários para recompor o conteúdo original.

Após realizar esse processo, você pode ocultar o arquivo na lixeira. Atualmente, arquivos ocultos não podem ser restaurados, e o sistema passa a considerá-los como excluídos.

O que fazer se o seu Token vazar?

Se você postou seu Token sem querer na internet ou desconfia que alguém tem acesso a ele:

1. Volte ao @BotFather e digite /mybots.
2. Selecione o bot vazado e clique em API Token.
3. Clique em Revoke current token (Revogar token atual). Isso invalidará o código antigo instantaneamente.
4. ⚠️ Não exclua o bot!
   Se você excluir o bot no Telegram, o sistema perderá completamente o acesso aos arquivos que foram enviados por ele. Como resultado, não será mais possível gerenciar ou recuperar os arquivos já armazenados.

   Caso seja necessário alterar o token do bot, não exclua o bot. Em vez disso, utilize o BotFather para gerar um novo token (opção Revoke current token) e atualize o novo token no sistema. Dessa forma, o bot continuará sendo o mesmo e o acesso aos arquivos será preservado.

5. Pegue o novo token gerado e atualize-o no painel do KF Drive.

Sobre o Projeto e Como Apoiar 💡

O KF Drive nasceu da necessidade de armazenar firmwares de smartphones (que hoje estão mais pesados que uma imagem do Windows 11!) já que o armazenamento convencional no Brasil está muito caro. Todo o projeto está sendo mantido e desenvolvido de forma independente.

Nosso grande objetivo atual é conseguir recursos para migrar o sistema de uma hospedagem compartilhada para uma VPS dedicada (melhorando as limitações de download via navegador) e, futuramente, contratar um desenvolvedor para criar o App Android oficial.

Se você gostou da ferramenta e quiser nos apoiar, sinta-se à vontade para testar os planos pagos! Você tem 14 dias grátis para testar sem cobrança (processo totalmente seguro via PayPal, não temos acesso aos seus dados de pagamento).

Agradecimentos e contato
Desde já, agradeço muito pela atenção de todos. Caso tenha alguma dúvida ou encontre algum erro, por favor entre em contato pelo e-mail [email protected].

Se você quiser se envolver mais no projeto, também pode enviar um e-mail para [email protected] com suas ideias ou solicitar acesso ao grupo do Telegram:
https://t.me/+iyjq-jFjut9lNDIx

Atualmente, sou o único desenvolvedor envolvido no projeto KF Host. Talvez isso aconteça porque moro em uma cidade pequena, no interior do Rio Grande do Norte, com pouco mais de 10 mil habitantes, onde quase não se fala sobre desenvolvimento de software. Por isso, acabo sendo um verdadeiro “matuto do interior” tentando construir esse projeto 😄.

Toda ajuda, feedback ou ideia será muito bem-vinda.

Aproveitem o KF Drive!