Flowleys-helper

Botões Interativos Avançados para WhatsApp com Flowleys

Este repositório demonstra como enviar todos os tipos de botões interativos atualmente conhecidos no WhatsApp usando a biblioteca Flowleys (fork do Baileys) sem precisar modificar o core. A funcionalidade é distribuída como o pacote npm flowleys-helper, que reproduz a estrutura binária que o cliente oficial usa para que os botões renderizem corretamente tanto em chats privados quanto em grupos.

Problema

Por padrão, bibliotecas como Flowleys/Baileys não enviam todos os tipos de botões interativos que o cliente oficial suporta. Isso acontece porque faltam nós binários obrigatórios (biz, interactive, native_flow) que o WhatsApp exige para mensagens interativas.

Solução

O pacote flowleys-helper fornece a funcionalidade ausente ao:

1. Detectar mensagens de botão usando a mesma lógica do cliente oficial.
2. Converter formatos de botão da Flowleys para a estrutura protobuf correta.
3. Adicionar automaticamente nós binários faltantes (biz, interactive, native_flow, bot).
4. Diferenciar corretamente chats privados de grupos, aplicando regras específicas.

Funcionalidades Principais

• ✅ Não exige modificações no core do Flowleys/Baileys.
• ✅ Suporte completo para Template Buttons (simples e hidratados).
• ✅ Injeção automática de nós binários para mensagens de botão.
• ✅ Suporte para chats privados (adiciona bot com biz_bot: '1').
• ✅ Suporte para grupos (apenas biz).
• ✅ Compatível com mensagens padrão; mensagens simples continuam funcionando.

Instalação

npm install flowleys-helper
# ou
yarn add flowleys-helper