v10.0.1

Sistema de Aluguel por PIX, Renovação e Aprovação de Entrada em Grupos 🌟

Esta versão consolida o sistema de aluguel do bot com pagamento por PIX automático e manual, renovação de planos, controle de grupos, prevenção de duplicidade e suporte completo para grupos que exigem aprovação de entrada por administrador.

O fluxo foi estruturado para reduzir ações manuais, preservar os dados após reinicializações e evitar que um grupo incorreto seja associado a um pagamento.

---

Principais recursos 💎

• Pagamento automático por Mercado Pago PIX.
• Pagamento manual por chave PIX, com liberação pelo responsável.
• Envio automático de instruções ao cliente após a confirmação do pagamento.
• Entrada automática no grupo pelo link de convite.
• Suporte para grupos com a opção “Aprovar novas solicitações” ativada.
• Ativação automática do modo aluguel ao entrar no grupo.
• Registro e atualização automática do vencimento do aluguel.
• Renovação de grupos vencidos.
• Soma de dias quando o mesmo cliente compra novamente para um grupo ativo.
• Bloqueio de grupos já vinculados a outro cliente.
• Persistência de pagamentos, links, planos e solicitações pendentes.
• Tratamento de reinicializações sem perder solicitações de aprovação em andamento.
• Liberação temporária de mensagens privadas somente para clientes que estão concluindo o aluguel.

---

Configuração inicial

Antes de disponibilizar o sistema aos clientes, confirme os seguintes pontos:

1. O número do dono deve estar configurado corretamente nas configurações do bot.

2. O prefixo dos comandos deve estar definido. Todos os exemplos deste guia usam <prefixo>.
   Se o prefixo for !, por exemplo, <prefixo>plano 1 será !plano 1.

3. O bot deve estar conectado ao WhatsApp e com acesso à internet.

4. Para o funcionamento completo dentro dos grupos, é recomendado que o bot seja administrador.

5. Escolha pelo menos uma modalidade de pagamento:

   • Mercado Pago PIX automático;
   • Chave PIX manual;
   • Ou as duas opções, conforme a configuração da instalação.

6. Editar Tabelo do Bot

• No arquivo 📂 ./src /menus /tabela-planos-bot.txt é possível editar a tabela de planos do bot
• OBS: Lembre-se de editar os valores em 📂 ./src/commands/settings.js pois o bot não pode extrair magicamente os preços da tabela em texto.
• • EXEMPLO

// ./src/comandos/settings.js - Final da linha
export const ALUGUEL_CONFIG = {
   multiGrupos: true,
   planos: [
       {
           nome: 'Plano Bronze 🥉 - 7 dias',
           dias: 7,
           valor: 5,
           ativo: true
       },
       {
           nome: 'Plano prata 🥈 - 15 dias',
           dias: 15,
           valor: 10,
           ativo: true
       },
       {
           nome: 'Plano Ouro 🥇 - 30 dias',
           dias: 30,
           valor: 20,
           ativo: true
       },
       {
           nome: 'Plano VIP 👑 - 60 dias',
           dias: 60,
           valor: 35,
           ativo: true
       },
   ]
}

---

Configuração do Mercado Pago PIX automático

O Mercado Pago permite criar cobranças PIX e confirmar os pagamentos automaticamente.

Definir token do Mercado Pago

Somente o dono do bot deve usar:

<prefixo>tokenpix <seu_access_token>

Exemplo:

!settokenmp APP_USR-0000000000000000-000000-00000000000000000000000000000000

Após configurar o token, os clientes poderão selecionar um plano e receber uma cobrança PIX gerada automaticamente.

Desativar Mercado Pago automático

Para desativar o sistema automático, use:

<prefixo>tokenpix 0

Também são aceitos valores como padrao, padrão e default.

Ao desativar o token, as cobranças automáticas pendentes armazenadas localmente são canceladas. Isso não remove a chave PIX manual, caso ela esteja configurada.

---

Configuração da chave PIX manual

A chave PIX manual é indicada quando o responsável deseja conferir cada pagamento antes de liberar o cliente.

Definir chave PIX

Use:

<prefixo>chavepix <sua_chave_pix>

Exemplo:

!chavepix email@exemplo.com

A chave pode ser CPF, CNPJ, telefone, e-mail ou chave aleatória.

Remover chave PIX manual

Use:

<prefixo>chavepix 0

Depois de removida, o pagamento manual deixa de ficar disponível até uma nova chave ser configurada.

---

Fluxo de pagamento automático

1. O cliente consulta os planos disponíveis com:

   <prefixo>planos

   Também podem existir atalhos como <prefixo>precos, <prefixo>alugar ou <prefixo>aluga.

2. O cliente escolhe o plano:

   <prefixo>plano <número_do_plano>

   Exemplo:

   !plano 1

3. O bot gera a cobrança PIX e envia os dados para pagamento.

4. O sistema verifica os pagamentos aprovados automaticamente em intervalos regulares.

5. Quando o pagamento é confirmado:

   • o responsável recebe uma notificação;
   • o cliente recebe a confirmação;
   • o cliente é autorizado temporariamente a conversar com o bot no privado;
   • o bot pede o link de convite do grupo.

6. O cliente envia o link do grupo no privado.

7. O bot valida o link, entra no grupo, ativa o aluguel e registra o vencimento.

8. O responsável recebe uma nova notificação informando:

   • cliente;
   • plano contratado;
   • valor;
   • grupo ativado;
   • data de vencimento.

---

Fluxo de pagamento manual por chave PIX

1. O cliente escolhe um plano normalmente:

   <prefixo>plano <número_do_plano>

2. O bot envia:

   • a chave PIX configurada;
   • orientações de pagamento;
   • um link pronto para o cliente entrar em contato com o responsável;
   • informações do plano escolhido.

3. O cliente realiza o pagamento e envia o comprovante ao responsável.

4. Depois de conferir o pagamento, o responsável libera o cliente com:

   <prefixo>liberar <número_do_cliente>

   Exemplo:

   !liberar 5583999999999

5. O cliente recebe a confirmação e a solicitação do link de convite do grupo.

6. O cliente envia o link no privado.

7. O bot entra no grupo, ativa o aluguel e registra o plano.

Também podem ser utilizados os comandos equivalentes:

• <prefixo>autorizarlink <número>
• <prefixo>liberarlink <número>
• <prefixo>confirmarpix <número>
• <prefixo>confirmar-pagamento <número>

A liberação manual é importante porque o bot não ativa o aluguel apenas pelo envio de um comprovante. A confirmação continua sob controle do responsável.

---

Como enviar o link do grupo

Depois que o pagamento for aprovado ou liberado, o cliente deve enviar o link de convite diretamente no privado do bot.

Formato aceito:

https://chat.whatsapp.com/SeuCodigoDoGrupo

O link pode estar acompanhado de texto. O bot identifica automaticamente o endereço do convite.

Antes de solicitar a entrada, o sistema valida o link e obtém as informações do grupo. Isso evita associar um pagamento a um grupo inválido ou inexistente.

---

Grupos com aprovação de entrada

Esta versão oferece suporte para grupos que possuem a opção “Aprovar novas solicitações” ativada.

Anteriormente, quando o bot solicitava entrada em um grupo desse tipo, o WhatsApp podia retornar um identificador indefinido. Isso fazia o sistema interpretar a solicitação como falha, mesmo que o administrador ainda pudesse aprovar o bot depois.

Agora o comportamento é o seguinte:

1. O cliente envia o link do grupo.

2. O bot consulta as informações do convite antes de solicitar a entrada.

3. O sistema salva de forma persistente:

   • número do cliente;
   • plano escolhido;
   • código do convite;
   • ID real esperado do grupo;
   • nome do grupo;
   • data da solicitação.

4. O bot envia a solicitação de entrada ao grupo.

5. Caso o grupo exija aprovação, o cliente recebe uma mensagem informando que a solicitação foi enviada.

6. O cliente não precisa reenviar o link.

7. O administrador do grupo aprova a entrada do bot.

8. Assim que o WhatsApp informa que o bot foi adicionado, o sistema compara o ID recebido com o ID salvo anteriormente.

9. Se o grupo for o mesmo:

• o modo aluguel é ativado;
• o plano é registrado;
• o vencimento é calculado;
• o cliente recebe a confirmação;
• o responsável recebe a notificação;
• a solicitação pendente é removida.

11. Caso o bot seja adicionado em outro grupo sem relação com uma solicitação de aluguel, nenhuma ativação é realizada.

O sistema não faz consultas contínuas aos grupos. A ativação depende dos eventos recebidos pelo WhatsApp, preservando o desempenho do bot.

As solicitações pendentes continuam registradas mesmo se o bot for reiniciado antes da aprovação. O arquivo de persistência utilizado é pix-aguardando-aprovacao.json.

---

Ativação automática do aluguel

Quando a entrada no grupo é confirmada, o sistema:

1. Cria as configurações padrão do grupo, caso ainda não existam.

2. Ativa o modo aluguel nas configurações do grupo.

3. Registra o grupo como ativo no sistema de aluguel.

4. Salva:

   • ID do grupo;
   • cliente responsável;
   • nome do grupo;
   • plano contratado;
   • data de contratação;
   • vencimento;
   • status do aluguel.

5. Envia a confirmação ao cliente.

6. Envia uma notificação detalhada ao dono do bot.

O cliente não precisa ser adicionado manualmente à lista p...

Hutao Bot V10.0.0 Updates

Mega atualização na HutaoBot-MD ✨️

• Nessa atualização inclui os seguintes tópicos 🪻

1. Mudança de formato de código.
2. Correções.
3. Comandos novos.
4. Sistemas novos.
5. Funcionalidades Extras em comandos.
6. Otimização.
7. Liberdade de edição.
8. Criar comandos
9. Editar configurações do bot de forma mais avançada.
10. Atualizações mais completas do que na V9.5.5
11. ModoIA que permite conversar com o bot de forma mais inteligente e interativa. É possível educar para que a IA se comporte da forma que você quiser.
12. Comando sem prefixo.
13. Closegp e Opengp enviam imagem e video junto com legenda personalizada para cada grupo.
14. Anti Pagamento (apaga ainda) futuramente pode ser que não funcione mais
15. E muito mais...

_ O que realmente torna a HutaoBot-MD V10 Importante? 🤷‍♀️

• Tudo começa com a liberdade de edição e personalização do bot.

• É possivel editar 10x mais coisas na V10 do que na V9.5.5

• Atualizações são entregues o mais rápido possível.

• Sugestões de usuários são adquiridas de forma mais rápida.

• Os códigos são mais avançados conforme e profissionais.

• Resumindo: Hutao V9 = Código antigo e mal formado

• HutaoBot V10 = Código profissional e aprimorado.

• Quais a facilidades? 💡

1. Conexão: Lembra o número que conectou antes. Economizando tempo.
2. Comando Divorciar sem o "sim" agora. Apaga direto.
3. Mute agora bane usando "muteB"
4. Desmute suporta apenas o número de telefone caso não esteja no grupo.
5. Comandos personalizados são mais fáceis que case.
6. Menu agora ficou mais fácil de editar.
7. e etc

Por fim, a HutaoBot-MD V10 se tornou uma mega inovação em relação ao poder de edição e novidades.