@systemzero/baileys 1.0.6 → 1.0.7

package/README.md

@@ -4,7 +4,7 @@
 
 # @systemzero/baileys
 
-**v1.0.6** · Fork avançado do Baileys com suporte nativo a todos os tipos de mensagens do WhatsApp
+**v1.0.7** · Fork avançado do Baileys com suporte nativo a todos os tipos de mensagens do WhatsApp
 
 [![NPM](https://img.shields.io/npm/v/@systemzero/baileys?color=7c3aed&style=flat-square&label=npm)](https://www.npmjs.com/package/@systemzero/baileys)
 [![License](https://img.shields.io/badge/license-MIT-6366f1?style=flat-square)](LICENSE)
@@ -27,7 +27,7 @@ npm i sharp          # conversão de imagem para sticker pack
 npm i @napi-rs/image # alternativa ao sharp
 ```
 
-Requer `ffmpeg` instalado no sistema (com suporte a `libopus`) para conversão automática de áudio PTT e para o sistema anti-fraude de pagamento processar mídia. Confirme com `ffmpeg -encoders | grep opus`.
+Requer `ffmpeg` instalado no sistema (com suporte a `libopus`) para conversão automática de áudio PTT. Confirme com `ffmpeg -encoders | grep opus`.
 
 ---
 
@@ -44,19 +44,21 @@ Requer `ffmpeg` instalado no sistema (com suporte a `libopus`) para conversão a
 9. [LID / JID — Sistema avançado](#9-lid--jid--sistema-avançado)
 10. [Username (@usuario)](#10-username-usuario)
 11. [MessageBuilder — Button, ButtonV2, Carousel, AIRich](#11-messagebuilder--button-buttonv2-carousel-airich)
-12. [Botões estendidos (v1.0.6)](#12-botões-estendidos-v106)
+12. [Botões estendidos](#12-botões-estendidos)
 13. [Grupos](#13-grupos)
 14. [Perfil e privacidade](#14-perfil-e-privacidade)
 15. [Eventos do socket](#15-eventos-do-socket)
 16. [Utilitários](#16-utilitários)
 17. [Fixar / Desfixar mensagens](#17-fixar--desfixar-mensagens)
 18. [Resolução de nomes (getName)](#18-resolução-de-nomes-getname)
-19. [PTT real com qualquer formato de entrada](#19-ptt-real-com-qualquer-formato-de-entrada)
-20. [Guard de pagamento stealth (anti-fraude)](#20-guard-de-pagamento-stealth-anti-fraude)
-21. [Bad MAC Handler — sessões Signal](#21-bad-mac-handler--sessões-signal)
+19. [PTT real com qualquer formato](#19-ptt-real-com-qualquer-formato)
+20. [Guard de pagamento stealth](#20-guard-de-pagamento-stealth-anti-fraude)
+21. [Bad MAC Handler](#21-bad-mac-handler--sessões-signal)
 22. [Resolução LID → telefone via grupo](#22-resolução-lid--telefone-via-grupo)
 23. [Versão do WhatsApp sempre atualizada](#23-versão-do-whatsapp-sempre-atualizada)
-24. [WhatsApp Flows — Formulários interativos](#24-whatsapp-flows--formulários-interativos)
+24. [WhatsApp Flows — Formulários](#24-whatsapp-flows--formulários-interativos)
+25. [Mensagens agendadas](#25-mensagens-agendadas)
+26. [Status em grupo (GroupStatusMessageV2)](#26-status-em-grupo-groupstatusmessagev2)
 
 ---
 
@@ -68,11 +70,11 @@ const {
     useMultiFileAuthState,
     DisconnectReason,
     Browsers,
-    fetchLatestWaWebVersion
+    getBestWaVersion
 } = require('@systemzero/baileys')
 
 const { state, saveCreds } = await useMultiFileAuthState('./session')
-const { version } = await fetchLatestWaWebVersion()
+const { version, isLatest, source } = await getBestWaVersion()
 
 const sock = makeWASocket({
     version,
@@ -91,21 +93,25 @@ sock.ev.on('creds.update', saveCreds)
 sock.ev.on('connection.update', ({ connection, lastDisconnect }) => {
     if (connection === 'close') {
         const code = lastDisconnect?.error?.output?.statusCode
-        if (code !== DisconnectReason.loggedOut) startBot()
+        if (code === DisconnectReason.loggedOut) {
+            process.exit()
+        } else if (code === DisconnectReason.forbidden) {
+            console.log('Sessão revogada pelo WhatsApp (403). Apague a sessão e re-pareie.')
+            process.exit()
+        } else {
+            startBot()
+        }
     }
 })
 ```
 
-> Veja a seção [23](#23-versão-do-whatsapp-sempre-atualizada) para um jeito mais robusto de buscar a versão, que não falha silenciosamente.
+> Use `getBestWaVersion()` em vez de `fetchLatestWaWebVersion()` — ela tenta as duas fontes e só aceita resultado se buscou fresco de verdade, sem cair silenciosamente num fallback desatualizado que pode causar erros 403.
 
 ### Pairing Code
 
 ```js
-// Automático
 const code = await sock.requestPairingCode('5511999999999')
-
-// Personalizado — exatamente 8 caracteres
-const code = await sock.requestPairingCode('5511999999999', 'MYBOT001')
+const code = await sock.requestPairingCode('5511999999999', 'MYBOT001') // personalizado — 8 chars
 ```
 
 ### Store em memória
@@ -134,47 +140,23 @@ store.bind(sock.ev)
 Todos os campos de mídia aceitam `Buffer`, `{ url: 'https://...' }` ou `{ stream }`.
 
 ```js
-// Texto
 await sock.sendMessage(jid, { text: 'Olá!' })
-
-// Texto com menção
-await sock.sendMessage(jid, {
-    text:     '@5511...!',
-    mentions: ['5511999999999@s.whatsapp.net']
-})
-
-// Imagem
+await sock.sendMessage(jid, { text: '@5511...!', mentions: ['5511999999999@s.whatsapp.net'] })
 await sock.sendMessage(jid, { image: { url: 'https://...' }, caption: 'Legenda' })
-
-// Vídeo
 await sock.sendMessage(jid, { video: buffer, caption: 'Legenda', gifPlayback: false })
-
-// Áudio normal (música)
 await sock.sendMessage(jid, { audio: buffer, mimetype: 'audio/mpeg', ptt: false })
-
-// Nota de voz (PTT) — ver seção 19 para conversão automática de qualquer formato
-await sock.sendMessage(jid, { audio: buffer, ptt: true })
-
-// Documento
+await sock.sendMessage(jid, { audio: buffer, ptt: true }) // PTT — converte automaticamente
 await sock.sendMessage(jid, { document: buffer, mimetype: 'application/pdf', fileName: 'doc.pdf' })
-
-// Figurinha
 await sock.sendMessage(jid, { sticker: buffer })
-
-// Album (mínimo 2 itens)
 await sock.sendMessage(jid, {
     album: [{ image: buffer1 }, { image: buffer2 }, { video: bufferVideo }]
 })
-
-// Contato
 await sock.sendMessage(jid, {
     contacts: {
         displayName: 'João',
         contacts: [{ vcard: 'BEGIN:VCARD\nVERSION:3.0\nFN:João\nTEL:+5511999999999\nEND:VCARD' }]
     }
 })
-
-// Localização
 await sock.sendMessage(jid, {
     location: { degreesLatitude: -23.55, degreesLongitude: -46.63, name: 'São Paulo' }
 })
@@ -185,38 +167,16 @@ await sock.sendMessage(jid, {
 ## 3. Mensagens especiais
 
 ```js
-// Reação
 await sock.sendMessage(jid, { react: { text: '❤️', key: message.key } })
-
-// Deletar
 await sock.sendMessage(jid, { delete: message.key })
-
-// Editar
 await sock.sendMessage(jid, { edit: message.key, text: 'Texto editado' })
-
-// Fixar — ver seção 17 para a versão completa
-await sock.sendMessage(jid, { pin: message.key, type: 1 })
-
-// View Once
 await sock.sendMessage(jid, { image: buffer, viewOnce: true })
 await sock.sendMessage(jid, { image: buffer, viewOnceV2: true })
-
-// Spoiler
 await sock.sendMessage(jid, { image: buffer, caption: '!', spoiler: true })
-
-// Status de grupo
 await sock.sendMessage(jid, { image: buffer, groupStatus: true })
-
-// Efêmera
 await sock.sendMessage(jid, { image: buffer, ephemeral: true })
-
-// Lottie sticker
 await sock.sendMessage(jid, { sticker: buffer, isLottie: true })
-
-// Mention All
 await sock.sendMessage(jid, { text: '@all', mentionAll: true })
-
-// External Ad Reply
 await sock.sendMessage(jid, {
     text: 'Confira!',
     externalAdReply: {
@@ -226,21 +186,15 @@ await sock.sendMessage(jid, {
         renderLargerThumbnail: true
     }
 })
-
-// Enquete
 await sock.sendMessage(jid, {
     poll: { name: 'Pergunta?', values: ['A', 'B', 'C'], selectableCount: 1 }
 })
-
-// Encaminhar
 const { generateForwardMessageContent, generateWAMessageFromContent } = require('@systemzero/baileys')
 const fwd = generateForwardMessageContent(message, false)
 const msg = generateWAMessageFromContent(jid, fwd, { quoted: m })
 await sock.relayMessage(jid, msg.message, { messageId: msg.key.id })
 ```
 
-> ⚠️ **Removido desta versão do README:** preview de link customizado (`linkPreview` manual) e áudio embutido em rodapé de card interativo (`audioFooter`). Os dois existem no proto do WhatsApp, mas em testes reais (Android e iOS) **não renderizaram corretamente** — o `audioFooter` não mostrou o player de áudio, e o `linkPreview` manual caiu num formato de card genérico em vez do esperado. Não são recursos confiáveis hoje.
-
 ---
 
 ## 4. Botões e interativos
@@ -264,40 +218,24 @@ const msg = generateWAMessageFromContent(jid, {
 await sock.relayMessage(jid, msg.message, { messageId: msg.key.id })
 ```
 
-### Tipos de botão (testados e funcionais)
-
 ```js
-// Resposta rápida
 { name: 'quick_reply', buttonParamsJson: JSON.stringify({ display_text: 'OK', id: 'ok' }) }
-
-// Link
-{ name: 'cta_url', buttonParamsJson: JSON.stringify({ display_text: 'Abrir', url: 'https://systemzone.store' }) }
-
-// Copiar
-{ name: 'cta_copy', buttonParamsJson: JSON.stringify({ display_text: 'Copiar', copy_code: 'CODIGO' }) }
-
-// Ligar
-{ name: 'cta_call', buttonParamsJson: JSON.stringify({ display_text: 'Ligar', phone_number: '5511999999999' }) }
-
-// Lista dropdown
+{ name: 'cta_url',    buttonParamsJson: JSON.stringify({ display_text: 'Abrir', url: 'https://systemzone.store' }) }
+{ name: 'cta_copy',   buttonParamsJson: JSON.stringify({ display_text: 'Copiar', copy_code: 'CODIGO' }) }
+{ name: 'cta_call',   buttonParamsJson: JSON.stringify({ display_text: 'Ligar', phone_number: '5511999999999' }) }
 {
     name: 'single_select',
     buttonParamsJson: JSON.stringify({
         title: 'Escolher',
-        sections: [{ title: 'Cat', rows: [
-            { header: 'Op1', title: 'Opção 1', description: 'Desc', id: 'op1' }
-        ]}]
+        sections: [{ title: 'Cat', rows: [{ header: 'Op1', title: 'Opção 1', description: 'Desc', id: 'op1' }] }]
     })
 }
 ```
 
-### Header com imagem (funciona — confirmado em teste real)
+### Header com imagem + nativeFlow
 
 ```js
-const { generateWAMessage, generateMessageIDV2 } = require('@systemzero/baileys')
-
-// Forma simplificada e já testada: usar `image` + `caption` direto no sendMessage,
-// junto com nativeFlow — a lib monta o header automaticamente.
+// Use `caption`, não `text` — `text` faz a lib pular o bloco do header
 await sock.sendMessage(jid, {
     image:      { url: 'https://...' },
     caption:    'Texto do card',
@@ -305,9 +243,19 @@ await sock.sendMessage(jid, {
 })
 ```
 
-> Use `caption`, não `text`, quando quiser header com imagem junto de `nativeFlow` — usar `text` faz a lib pular inteiro o bloco que monta o header.
+### Carousel
 
-### Template Buttons
+```js
+await sock.sendMessage(jid, {
+    cards: [
+        { image: buffer1, caption: 'Card 1', nativeFlow: [{ text: 'Ver', id: 'c1' }] },
+        { image: buffer2, caption: 'Card 2', nativeFlow: [{ text: 'Ver', id: 'c2' }] },
+    ],
+    footer: 'Rodapé'
+})
+```
+
+### Template Buttons / Sections
 
 ```js
 await sock.sendMessage(jid, {
@@ -318,16 +266,10 @@ await sock.sendMessage(jid, {
         { text: 'Ligar', call: '5511999999999' },
     ]
 })
-```
-
-### Sections
 
-```js
 await sock.sendMessage(jid, {
     text: 'Selecione', buttonText: 'Ver opções',
-    sections: [{ title: 'Cat', rows: [
-        { title: 'Item 1', description: 'Desc', id: 'i1' }
-    ]}]
+    sections: [{ title: 'Cat', rows: [{ title: 'Item 1', description: 'Desc', id: 'i1' }] }]
 })
 ```
 
@@ -340,37 +282,30 @@ await sock.sendMessage(jid, {
     cover:    bufferWebP,
     stickers: [
         { data: bufferWebP,  emojis: ['😂'] },
-        { data: bufferAnima, emojis: ['🔥'] },  // animada
-        { data: bufferPng,   emojis: ['✨'] },   // PNG converte auto
+        { data: bufferAnima, emojis: ['🔥'] },
+        { data: bufferPng,   emojis: ['✨'] },
     ],
-    name:        'Nome do Pack',
-    publisher:   'Autor',
-    description: 'Descrição'
+    name:      'Nome do Pack',
+    publisher: 'Autor',
 })
 ```
 
-> Tanto `cover` quanto cada item de `stickers[].data` esperam **Buffer**, não `{ url }`. Se você baixou as figurinhas de uma API, baixe o buffer primeiro (`axios.get(url, { responseType: 'arraybuffer' })`) antes de montar o objeto.
-
-Máximo 60 figurinhas, cada uma até 1MB. Requer `sharp` ou `@napi-rs/image` para PNG.
+`cover` e cada `stickers[].data` esperam **Buffer**. Máximo 60 figurinhas, até 1MB cada. Requer `sharp` ou `@napi-rs/image` para PNG.
 
 ---
 
 ## 6. Canais Newsletter
 
 ```js
-// Texto
 await sock.sendMessage('120363...@newsletter', { text: 'Novidade!' })
 
-// Mídia — sempre via generateWAMessage + relayMessage
 const { generateWAMessage, generateMessageIDV2 } = require('@systemzero/baileys')
-
 const fullMsg = await generateWAMessage(canalJid, { image: buffer, caption: 'Legenda' }, {
     upload: sock.waUploadToServer, userJid: sock.user.id,
     messageId: generateMessageIDV2(sock.user.id),
 })
 await sock.relayMessage(canalJid, fullMsg.message, { messageId: fullMsg.key.id })
 
-// Gerenciar
 const canal = await sock.newsletterCreate('Nome', 'Descrição')
 await sock.newsletterFollow(jid)
 await sock.newsletterUnfollow(jid)
@@ -392,14 +327,11 @@ const { subscribers } = await sock.newsletterSubscribers(jid)
 ## 7. Enquetes com decrypt
 
 ```js
-// Criar
 await sock.sendMessage(jid, {
     poll: { name: 'Pergunta?', values: ['A', 'B', 'C'], selectableCount: 1 }
 })
 
-// Receber votos — no connect.js após saveCreds:
 const { getAggregateVotesInPollMessage } = require('@systemzero/baileys/lib/Utils/messages.js')
-
 sock.ev.on('messages.update', async (updates) => {
     for (const { key, update } of updates) {
         if (!update.pollUpdates) continue
@@ -418,25 +350,13 @@ sock.ev.on('messages.update', async (updates) => {
 ## 8. AI Rich
 
 ```js
-// Texto com hyperlink
 await sock.sendRich(jid, [
-    sock.makeText('Acesse [nosso site](https://systemzone.store).')
-], quotedMsg)
+    sock.makeText('Acesse [nosso site](https://systemzone.store).'),
+    sock.makeCode('bash', 'npm i @systemzero/baileys'),
+    sock.makeTable([['Nome', 'Status'], ['Botões', '✅']]),
+    sock.makeList(['Item 1', 'Item 2']),
+], quotedMsg, ['RICH_RESPONSE_CODE', 'RICH_RESPONSE_TABLE'])
 
-// Código
-await sock.sendRich(jid, [
-    sock.makeCode('bash', 'npm i @systemzero/baileys')
-], null, ['RICH_RESPONSE_CODE'])
-
-// Tabela
-await sock.sendRich(jid, [
-    sock.makeTable([['Nome', 'Status'], ['Botões', '✅'], ['Canais', '✅']])
-], null, ['RICH_RESPONSE_TABLE'])
-
-// Lista
-await sock.sendRich(jid, [sock.makeList(['Item 1', 'Item 2'])])
-
-// Atalhos
 await sock.sendRichText(jid, 'Texto com [link](https://systemzone.store)', quotedMsg)
 await sock.sendRichCode(jid, 'Título', 'javascript', 'const x = 1', quotedMsg)
 await sock.sendRichList(jid, 'Lista', ['A', 'B'], quotedMsg)
@@ -447,10 +367,10 @@ await sock.sendRichList(jid, 'Lista', ['A', 'B'], quotedMsg)
 ## 9. LID / JID — Sistema avançado
 
 O WhatsApp usa dois tipos de identificador:
-- **JID** (`@s.whatsapp.net`) — formato baseado em número de telefone
-- **LID** (`@lid`) — identificador opaco, não contém o número de telefone
+- **JID** (`@s.whatsapp.net`) — baseado em número de telefone
+- **LID** (`@lid`) — identificador opaco sem número
 
-A partir da v1.0.6, a baileys resolve automaticamente LID↔JID em mensagens recebidas e na metadata de grupo (ver seção 22), via `sharedLidPhoneCache`.
+A partir da v1.0.6, a lib resolve automaticamente LID↔JID via `sharedLidPhoneCache`, inclusive ao buscar metadata de grupo (`groupMetadata`).
 
 ```js
 const {
@@ -458,29 +378,21 @@ const {
     getSenderInfo, sharedLidPhoneCache, isLidUser, isPnUser,
     getBotJid, setBotMap
 } = require('@systemzero/baileys')
-```
 
-```js
 const jid = lidToJid('123456@lid')
 const { jid, lid } = resolveAll('5511999999999@s.whatsapp.net')
-normalizeJid('5511999999999')         // → '5511999999999@s.whatsapp.net'
-normalizeJid('123456@lid')            // → resolve via cache
-const { isValid, error } = validateJid('5511999999999@s.whatsapp.net')
-const { jid, lid, isGroup, isValid } = getSenderInfo(message)
-```
-
-### Cache bidirecional
+const { jid, lid, isGroup } = getSenderInfo(message)
 
-O cache é populado automaticamente ao processar mensagens **e** ao buscar metadata de grupo (`groupMetadata`) — esse segundo ponto foi corrigido na v1.0.6, antes o par LID↔telefone que vem pronto na lista de participantes do grupo era descartado.
+normalizeJid('5511999999999')  // → '5511999999999@s.whatsapp.net'
+normalizeJid('123456@lid')     // → resolve via cache
 
-```js
-sharedLidPhoneCache.set('123456@lid', '5511999999999@s.whatsapp.net') // manual, raro
+sharedLidPhoneCache.set('123456@lid', '5511999999999@s.whatsapp.net')
 const jid = sharedLidPhoneCache.getPhoneForLid('123456@lid')
 const lid = sharedLidPhoneCache.getLidForPhone('5511999999999@s.whatsapp.net')
-console.log('Entradas no cache:', sharedLidPhoneCache.size)
+console.log('Cache size:', sharedLidPhoneCache.size)
 ```
 
-> ⚠️ Atenção com sufixo de dispositivo: identidades do **próprio bot** (`sock.user.id` / `sock.user.lid`) costumam vir como `numero:N@dominio` (ex: `558892659041:10@s.whatsapp.net`). Pra comparar com a lista de `participants` (que não tem sufixo), remova só o `:N`, preservando o domínio: `jid.replace(/:\d+(?=@)/, '')` — **não use** `jid.split(':')[0]`, isso corta o domínio inteiro junto.
+> ⚠️ Identidades do próprio bot (`sock.user.id`/`.lid`) vêm com sufixo de dispositivo (`numero:N@dominio`). Pra comparar com `participants`, remova só o `:N` preservando o domínio: `jid.replace(/:\d+(?=@)/, '')` — **não use** `split(':')[0]`.
 
 ---
 
@@ -489,9 +401,7 @@ console.log('Entradas no cache:', sharedLidPhoneCache.size)
 ```js
 const { resolveUsername, isUsername } = require('@systemzero/baileys')
 
-isUsername('@josue')    // true
-isUsername('josue')     // false
-
+isUsername('@josue')   // true
 const jid = await resolveUsername('@josue', sock.onWhatsApp.bind(sock))
 if (jid) await sock.sendMessage(jid, { text: 'Olá!' })
 ```
@@ -502,34 +412,28 @@ if (jid) await sock.sendMessage(jid, { text: 'Olá!' })
 
 ```js
 const { Button, ButtonV2, Carousel, AIRich } = require('@systemzero/baileys/lib/MB.cjs')
+// O socket vai sempre no construtor: new ButtonV2(sock)
 ```
 
-> O socket vai sempre no construtor: `new ButtonV2(sock)`
-
-### ButtonV2 — botões clássicos
+### ButtonV2
 
 ```js
 const msg = new ButtonV2(sock)
-msg.setTitle('Título')
-msg.setBody('Corpo')
-msg.setFooter('Rodapé')
+msg.setTitle('Título'); msg.setBody('Corpo'); msg.setFooter('Rodapé')
 msg.setThumbnail('https://exemplo.com/imagem.jpg')
 msg.addButton('✅ Opção 1', 'opcao_1')
 msg.addButton('❌ Opção 2', 'opcao_2')
 await msg.send(jid, { quoted: m })
+// clique chega como m.body === 'opcao_1'
 ```
 
-Capturar clique: `m.body` chega com o id do botão.
-
-### Button — native flow avançado
+### Button (native flow)
 
 ```js
 const msg = new Button(sock)
-msg.setTitle('Título')
-msg.setBody('Corpo')
 msg.addReply('✅ Confirmar', 'confirmar')
-msg.addUrl('🔗 Abrir site', 'https://systemzone.store')
-msg.addCopy('📋 Copiar código', 'PROMO2025')
+msg.addUrl('🔗 Abrir', 'https://systemzone.store')
+msg.addCopy('📋 Copiar', 'PROMO2025')
 msg.addCall('📞 Ligar', '5511999999999')
 await msg.send(jid, { quoted: m })
 ```
@@ -538,9 +442,9 @@ await msg.send(jid, { quoted: m })
 
 ```js
 const msg = new Carousel(sock)
-msg.setBody('Escolha um item:')
-msg.card(c => c.image('https://...').title('Card 1').text('Descrição').button('Ver', 'c1'))
-msg.card(c => c.image('https://...').title('Card 2').text('Descrição').button('Ver', 'c2'))
+msg.setBody('Escolha:')
+msg.card(c => c.image('https://...').title('Card 1').text('Desc').button('Ver', 'c1'))
+msg.card(c => c.image('https://...').title('Card 2').text('Desc').button('Ver', 'c2'))
 await msg.send(jid, { quoted: m })
 ```
 
@@ -549,27 +453,25 @@ await msg.send(jid, { quoted: m })
 ```js
 const msg = new AIRich(sock)
 msg.addText('Acesse [System Zero](https://systemzone.store).')
-msg.addCode('javascript', `const baileys = require('@systemzero/baileys')`)
-msg.addTable([['Comando', 'Descrição'], ['!menu', 'Abre o menu']])
+msg.addCode('javascript', `require('@systemzero/baileys')`)
+msg.addTable([['Comando', 'Desc'], ['!menu', 'Menu principal']])
 await msg.send(jid, { quoted: m })
 ```
 
 ---
 
-## 12. Botões estendidos (v1.0.6)
-
-> ⚠️ **Não verificado nesta versão do README.** Os tipos abaixo (`catalog`, `products`, `otp`, `orderDetails`, `flow`, etc) exigem conta **WhatsApp Business API verificada** com catálogo/pagamentos configurados — nenhum deles foi testado numa conta pessoal real. Os tipos mais simples (`reminder`, `address`, `location`, `phoneNumber`, `urlBtn`, `clearChat`) têm chance maior de funcionar em qualquer conta, mas também não foram confirmados em teste real. Trate como documentação do proto, não como garantia de funcionamento. Para formulários reais e testados, veja a seção 24.
+## 12. Botões estendidos
 
 ```js
+await sock.sendMessage(jid, { text: 'Mensagem', nativeFlow: [ /* botões */ ] })
+
 { text: '⏰ Me lembre', reminder: 'lembrete_id' }
 { text: '🔕 Cancelar', cancelReminder: 'lembrete_id' }
-{ text: '📍 Enviar endereço', address: true }
+{ text: '📍 Endereço', address: true }
 { text: '📡 Localização', location: true }
-{ text: '🛍️ Ver catálogo', catalog: '5511999999999@s.whatsapp.net' }
-{ text: '📦 Produtos', products: ['prod_id_1'], bizJid: '5511...@s.whatsapp.net' }
+{ text: '🛍️ Catálogo', catalog: '5511999999999@s.whatsapp.net' }
 { text: 'Copiar código', otp: '123456' }
 { text: '📞 Ligar', phoneNumber: '5511999999999' }
-{ text: '📋 Ver pedido', orderDetails: { order_id: '123', token: 'abc' } }
 { text: '🗑️ Limpar chat', clearChat: true }
 { text: '🔗 Abrir', urlBtn: 'https://systemzone.store' }
 ```
@@ -579,7 +481,7 @@ await msg.send(jid, { quoted: m })
 ```js
 sock.ev.on('messages.upsert', async ({ messages }) => {
     const msg = messages[0]
-    if (msg.isSystemNotification) return // ignora notificação de sistema
+    if (msg.isSystemNotification) return
 })
 ```
 
@@ -588,9 +490,8 @@ sock.ev.on('messages.upsert', async ({ messages }) => {
 ## 13. Grupos
 
 ```js
-const grupo = await sock.groupCreate('Nome', ['5511...@s.whatsapp.net'])
 const meta  = await sock.groupMetadata(jid)
-
+const grupo = await sock.groupCreate('Nome', ['5511...@s.whatsapp.net'])
 await sock.groupParticipantsUpdate(jid, ['5511...@s.whatsapp.net'], 'add')
 await sock.groupParticipantsUpdate(jid, ['5511...@s.whatsapp.net'], 'remove')
 await sock.groupParticipantsUpdate(jid, ['5511...@s.whatsapp.net'], 'promote')
@@ -598,12 +499,10 @@ await sock.groupParticipantsUpdate(jid, ['5511...@s.whatsapp.net'], 'demote')
 await sock.groupLeave(jid)
 await sock.groupUpdateSubject(jid, 'Novo Nome')
 await sock.groupUpdateDescription(jid, 'Nova descrição')
-
 const code = await sock.groupInviteCode(jid)
 await sock.groupRevokeInvite(jid)
 await sock.groupAcceptInvite('CODIGO')
 await sock.groupToggleEphemeral(jid, 86400)
-
 const grupos = await sock.groupFetchAllParticipating()
 ```
 
@@ -615,22 +514,16 @@ const grupos = await sock.groupFetchAllParticipating()
 const url = await sock.profilePictureUrl(jid, 'image')
 await sock.updateProfilePicture(jid, buffer)
 await sock.updateProfileStatus('🤖 Bot ativo')
-
 const [result] = await sock.onWhatsApp('5511999999999')
-
 await sock.updateBlockStatus(jid, 'block')
 await sock.updateBlockStatus(jid, 'unblock')
-
 await sock.sendPresenceUpdate('composing', jid)
 await sock.sendPresenceUpdate('available', jid)
 await sock.presenceSubscribe(jid)
-
 await sock.readMessages([message.key])
-
 await sock.chatModify({ archive: true }, jid)
 await sock.chatModify({ pin: true }, jid)
 await sock.chatModify({ mute: 8 * 60 * 60 * 1000 }, jid)
-
 await sock.logout()
 ```
 
@@ -650,7 +543,6 @@ sock.ev.on('group-participants.update', ({ id, participants, action }) => {})
 sock.ev.on('contacts.update',           (contacts) => {})
 sock.ev.on('connection.update',         ({ connection, lastDisconnect, qr }) => {})
 sock.ev.on('creds.update',              saveCreds)
-
 sock.ev.on('call', (calls) => {
     for (const call of calls) {
         if (call.status === 'offer') sock.rejectCall(call.id, call.from)
@@ -663,79 +555,57 @@ sock.ev.on('call', (calls) => {
 ## 16. Utilitários
 
 ```js
-const { downloadMediaMessage, downloadContentFromMessage } = require('@systemzero/baileys')
+const { downloadMediaMessage } = require('@systemzero/baileys')
 const buffer = await downloadMediaMessage(message, 'buffer', {})
 
 const { generateWAMessage, generateWAMessageFromContent, generateMessageIDV2 } = require('@systemzero/baileys')
+const { jidNormalizedUser, isJidGroup, isJidNewsletter, isLidUser, isPnUser } = require('@systemzero/baileys')
 
-const {
-    jidNormalizedUser, isJidGroup, isJidNewsletter,
-    isLidUser, isPnUser, isUsername,
-    normalizeJid, resolveAll, getSenderInfo,
-    jidEncode, jidDecode
-} = require('@systemzero/baileys')
-
-// Detectar dispositivo — analisa o FORMATO DO ID DA MENSAGEM, não o JID
+// Detectar dispositivo — analisa o ID DA MENSAGEM, não o JID
 const { getDevice } = require('@systemzero/baileys')
 const device = getDevice(message.key.id) // 'android' | 'ios' | 'web' | 'unknown'
 ```
 
-> `getDevice` só funciona em cima de um `message.key.id` real — não dá pra usar pra "descobrir o dispositivo" de alguém sem ter uma mensagem recente dela pra inspecionar.
-
 ---
 
 ## 17. Fixar / Desfixar mensagens
 
 ```js
-// Fixar (type: 1 = PIN_FOR_ALL)
-await sock.sendMessage(jid, { pin: quotedMsg.key, type: 1 })
-
-// Desfixar (type: 2 = UNPIN_FOR_ALL)
-await sock.sendMessage(jid, { pin: quotedMsg.key, type: 2 })
+await sock.sendMessage(jid, { pin: quotedMsg.key, type: 1 }) // PIN_FOR_ALL
+await sock.sendMessage(jid, { pin: quotedMsg.key, type: 2 }) // UNPIN_FOR_ALL
 ```
 
-`quotedMsg.key` precisa conter `remoteJid`, `fromMe`, `id` e (em grupos) `participant`.
-
 ---
 
 ## 18. Resolução de nomes (getName)
 
 ```js
 const { getName } = require('@systemzero/baileys')
-const nome = getName(msg, contactStore) // contactStore opcional: { [jid]: { name, notify, verifiedName } }
+const nome = getName(msg, contactStore)
+// Prioridade: contato salvo → verifiedName → pushName → @lid → telefone → "Usuário desconhecido"
 ```
 
-Ordem de prioridade: contato salvo localmente → `verifiedName` → `pushName`/`notify` → resolução `@lid` via cache → número formatado → `"Usuário desconhecido"`. Nunca retorna vazio.
-
 ---
 
-## 19. PTT real com qualquer formato de entrada
-
-Antes da correção, `ptt: true` só **etiquetava** o mimetype como opus sem converter os bytes de verdade — qualquer entrada que não já fosse opus puro dava "algo errado com o arquivo de áudio" no WhatsApp. Agora a lib transcodifica de verdade via `ffmpeg` quando necessário.
+## 19. PTT real com qualquer formato
 
 ```js
-await sock.sendMessage(jid, {
-    audio: { url: 'https://qualquer-formato.mp3' }, // mp3, m4a, wav, o que for
-    ptt: true
-})
+// Qualquer formato de entrada — a lib converte via ffmpeg automaticamente
+await sock.sendMessage(jid, { audio: { url: 'https://musica.mp3' }, ptt: true })
 ```
 
-A lib detecta se a fonte já é `.opus`/`.ogg` (pela extensão real, não pelo que você declarar em `mimetype`) e só converte quando necessário, pra mono/16kHz — a especificação que o player de voz do WhatsApp espera.
-
-> Requer `ffmpeg` com `libopus` no `PATH` do servidor.
+A lib detecta a extensão real da fonte (não o `mimetype` declarado) e converte pra mono/16kHz opus quando necessário. Requer `ffmpeg` com `libopus`.
 
 ---
 
 ## 20. Guard de pagamento stealth (anti-fraude)
 
-A lib emite o evento `messages.decrypt-failed` sempre que uma mensagem de grupo falha na descriptografia (PreKey/CIPHERTEXT) — cobre o golpe de cobrança "invisível": mensagem normal enviada, depois **editada** pra conteúdo de pagamento.
-
 ```js
 const { bindPaymentGuard } = require('@systemzero/baileys')
 
 bindPaymentGuard(sock, {
-    isPaymentMessage: (webMessage) => { /* sua lógica de detecção */ },
-    recordEnvelope:  (webMessage, isPayment) => { /* seu registro de corroboração */ },
+    isPaymentMessage: (webMessage) => { /* sua lógica */ },
+    recordEnvelope:  (webMessage, isPayment) => { /* seu registro */ },
     treatDecryptFailureAsSuspicious: true,
     onDetect: (detection) => {
         // detection.type: 'direct' | 'edited' | 'undecryptable'
@@ -745,29 +615,23 @@ bindPaymentGuard(sock, {
 
 | Caminho | Evento | Garantia |
 |---|---|---|
-| Mensagem direta | `messages.upsert` | Roda seu detector no conteúdo normal |
-| Mensagem editada | `messages.update` | Extrai `editedMessage` e roda o mesmo detector |
-| Falha de decrypt | `messages.decrypt-failed` | Nunca ignora em silêncio, mesmo sem conteúdo |
-
-> Falha de decrypt nunca foi lida pelo bot — não existe forma de confirmar que era pagamento. O guard garante que isso nunca passe sem nenhum aviso, não que vai "adivinhar" o conteúdo.
+| Mensagem direta | `messages.upsert` | Roda detector no conteúdo |
+| Mensagem editada | `messages.update` | Extrai `editedMessage` e roda detector |
+| Falha de decrypt | `messages.decrypt-failed` | Nunca ignora silenciosamente |
 
 ---
 
 ## 21. Bad MAC Handler — sessões Signal
 
 ```js
-const { BadMacHandler, badMacHandler } = require('@systemzero/baileys')
+const { badMacHandler } = require('@systemzero/baileys')
 
 if (badMacHandler.isBadMacError(error)) {
-    badMacHandler.handleError(error, 'algum-contexto')
+    badMacHandler.handleError(error, 'contexto')
 }
-
-// limpa sessões Signal problemáticas, preservando creds.json
-badMacHandler.clearProblematicSessionFiles()
+badMacHandler.clearProblematicSessionFiles() // preserva creds.json
 ```
 
-Erros "Bad MAC" são esperados ocasionalmente em qualquer cliente Signal Protocol (sessão desincronizada do outro lado) — esse handler conta, dá reset automático após um intervalo, e remove só arquivos de sessão por par, nunca as credenciais principais.
-
 ---
 
 ## 22. Resolução LID → telefone via grupo
@@ -777,7 +641,7 @@ const { resolveLidPhoneFromGroup } = require('@systemzero/baileys')
 const telefone = await resolveLidPhoneFromGroup(sock, groupJid, lid)
 ```
 
-Força a resolução de um `@lid` pro telefone real buscando a metadata do grupo (que já entrega o par pronto por participante) — útil quando o cache ainda não tem aquele par.
+Força resolução de `@lid` → telefone via `groupMetadata` — útil quando o cache ainda não tem aquele par.
 
 ---
 
@@ -786,17 +650,14 @@ Força a resolução de um `@lid` pro telefone real buscando a metadata do grupo
 ```js
 const { getBestWaVersion } = require('@systemzero/baileys')
 const { version, isLatest, source } = await getBestWaVersion()
+// tenta web.whatsapp.com → GitHub → fallback fixo (avisando explicitamente)
 ```
 
-Tenta `web.whatsapp.com`, depois GitHub, e só aceita um resultado se `isLatest === true` de verdade. Diferente de `fetchLatestWaWebVersion()`/`fetchLatestBaileysVersion()` isoladas, que sempre retornam algo (mesmo em falha, caindo num valor fixo antigo) sem deixar isso óbvio.
-
 ---
 
 ## 24. WhatsApp Flows — Formulários interativos
 
-> ⚠️ WhatsApp Flows é um recurso de **WhatsApp Business API**, normalmente exigindo um `flow_id` aprovado pela Meta pra sua conta/app específico. O exemplo abaixo é o que está em uso real no System Zero — funciona pro `flow_id` configurado nessa conta, mas **não é garantido que o mesmo `flow_id` funcione pra qualquer outra conta**. Pra criar seu próprio Flow, você precisa cadastrar e aprovar ele no Meta Business Manager.
-
-### Enviando o formulário
+> Requer `flow_id` aprovado no Meta Business Manager.
 
 ```js
 const { generateWAMessageFromContent } = require('@systemzero/baileys')
@@ -804,32 +665,22 @@ const { generateWAMessageFromContent } = require('@systemzero/baileys')
 const formMsg = generateWAMessageFromContent(jid, {
     viewOnceMessage: {
         message: {
-            messageContextInfo: {
-                deviceListMetadata: {},
-                deviceListMetadataVersion: 2
-            },
+            messageContextInfo: { deviceListMetadata: {}, deviceListMetadataVersion: 2 },
             interactiveMessage: {
-                body: { text: 'Formulário de teste\n\nPreencha seus dados.' },
+                body: { text: 'Preencha seus dados.' },
                 nativeFlowMessage: {
                     buttons: [{
                         name: 'galaxy_message',
                         buttonParamsJson: JSON.stringify({
                             flow_message_version: '4',
-                            flow_id: 'SEU_FLOW_ID_AQUI',
+                            flow_id: 'SEU_FLOW_ID',
                             flow_action_payload: {
                                 screen: 'contact_details',
-                                data: {
-                                    full_name_visible:    true,
-                                    phone_number_visible: true,
-                                    email_visible:        true,
-                                    offer_name:           'Olá, seja bem-vindo',
-                                    offer_description:    'Sistema de teste'
-                                }
+                                data: { full_name_visible: true, email_visible: true }
                             },
-                            well_version: 'V700',
-                            flow_cta:     '__localize:FLOWS_SIGN_UP_BUTTON_TITLE',
-                            flow_action:  'navigate',
-                            flow_token:   'T0ZGRVJfU0lHTlVQ'
+                            flow_cta: '__localize:FLOWS_SIGN_UP_BUTTON_TITLE',
+                            flow_action: 'navigate',
+                            flow_token: 'T0ZGRVJfU0lHTlVQ'
                         })
                     }],
                     messageParamsJson: '{}'
@@ -844,70 +695,285 @@ await sock.relayMessage(jid, formMsg.message, { messageId: formMsg.key.id })
 
 ### Recebendo a resposta
 
-A resposta do formulário chega como `interactiveResponseMessage`. O `nativeFlowResponseMessage.paramsJson` traz os dados preenchidos dentro de `wa_flow_response_params.response_message` (uma string JSON aninhada — precisa de `JSON.parse` duplo).
-
 ```js
 sock.ev.on('messages.upsert', async ({ messages }) => {
     const m = messages[0]
-    if (m.message?.interactiveResponseMessage) {
-        const nfr = m.message.interactiveResponseMessage.nativeFlowResponseMessage
-
-        if (nfr?.name === 'galaxy_message' && nfr?.paramsJson) {
-            const parsed = JSON.parse(nfr.paramsJson)
-            if (!parsed.wa_flow_response_params) return
-
-            const flowParams  = parsed.wa_flow_response_params
-            const flowId      = flowParams.flow_id || ''
-            const rawResponse = flowParams.response_message || ''
-
-            let screens = []
-            try { screens = JSON.parse(rawResponse).screens || [] } catch {}
-
-            // extrai só os campos preenchidos
-            const campos = {}
-            for (const screen of screens) {
-                for (const comp of (screen.components || [])) {
-                    if (comp.name && comp.value !== undefined && comp.value !== '') {
-                        campos[comp.name] = comp.value
-                    }
-                }
-            }
+    const nfr = m.message?.interactiveResponseMessage?.nativeFlowResponseMessage
+    if (nfr?.name !== 'galaxy_message' || !nfr?.paramsJson) return
 
-            // roteia por flow_id — adicione mais formulários aqui
-            if (flowId === 'SEU_FLOW_ID_AQUI') {
-                let resposta = 'Formulário recebido!\n\n'
-                if (campos.full_name)    resposta += `Nome: ${campos.full_name}\n`
-                if (campos.phone_number) resposta += `Telefone: +${campos.phone_number}\n`
-                if (campos.email)        resposta += `Email: ${campos.email}\n`
-                await sock.sendMessage(m.key.remoteJid, { text: resposta }, { quoted: m })
-            }
+    const parsed   = JSON.parse(nfr.paramsJson)
+    if (!parsed.wa_flow_response_params) return
+
+    const flowId  = parsed.wa_flow_response_params.flow_id
+    const screens = JSON.parse(parsed.wa_flow_response_params.response_message).screens || []
+
+    const campos = {}
+    for (const screen of screens) {
+        for (const comp of (screen.components || [])) {
+            if (comp.name && comp.value !== undefined && comp.value !== '')
+                campos[comp.name] = comp.value
         }
     }
+
+    if (flowId === 'SEU_FLOW_ID') {
+        let resposta = 'Formulário recebido!\n\n'
+        if (campos.full_name) resposta += `Nome: ${campos.full_name}\n`
+        if (campos.email)     resposta += `Email: ${campos.email}\n`
+        await sock.sendMessage(m.key.remoteJid, { text: resposta }, { quoted: m })
+    }
 })
 ```
 
 ---
 
+## 25. Mensagens agendadas
+
+Sistema de agendamento em memória. Auto-inicia o timer quando há mensagens na fila, auto-para quando a fila esvazia.
+
+```js
+const { createMessageScheduler } = require('@systemzero/baileys')
+
+const scheduler = createMessageScheduler(
+    (jid, content) => sock.sendMessage(jid, content),
+    {
+        onSent:   (s, msg) => console.log(`Enviado pra ${s.jid} — ID: ${s.id}`),
+        onFailed: (s, err) => console.error(`Falhou: ${err.message}`)
+    }
+)
+
+// Agendar para data/hora específica
+const entry = scheduler.schedule(
+    '5511999999999@s.whatsapp.net',
+    { text: 'Feliz Aniversário! 🎂' },
+    new Date('2026-12-25T09:00:00')
+)
+console.log('Agendado com ID:', entry.id)
+
+// Agendar com delay (30 minutos)
+scheduler.scheduleDelay(jid, { text: 'Lembrete!' }, 30 * 60 * 1000)
+
+// Agendar qualquer tipo de mensagem
+scheduler.schedule(groupJid, {
+    image: { url: './promo.jpg' },
+    caption: 'Promoção de fim de semana!'
+}, new Date('2026-12-20T08:00:00'))
+
+// Cancelar um agendamento
+scheduler.cancel(entry.id)
+
+// Cancelar todos de um JID
+scheduler.cancelForJid(jid)
+
+// Ver pendentes
+const pendentes = scheduler.getPending()
+
+// Parar/retomar
+scheduler.stop()
+scheduler.start()
+
+// Limpar tudo
+scheduler.clearAll()
+```
+
+**Objeto retornado:**
+```js
+{
+    id:            'sched_1782000000000_a3f2b1',
+    jid:           '5511...@s.whatsapp.net',
+    content:       { text: '...' },
+    scheduledTime: Date,
+    createdAt:     Date,
+    status:        'pending' | 'sent' | 'failed' | 'cancelled',
+    messageId:     '...',  // preenchido após envio
+    error:         '...'   // preenchido em caso de falha
+}
+```
+
+---
+
+## 26. Status em grupo (GroupStatusMessageV2)
+
+Posta conteúdo como status dentro de um grupo — texto, imagem, vídeo ou áudio. Suporta modo **Close Friends** (apenas amigos próximos), usando o mesmo mecanismo do status nativo do WhatsApp.
+
+```js
+const { generateWAMessageFromContent, prepareWAMessageMedia, downloadMediaMessage } = require('@systemzero/baileys')
+const crypto = require('crypto')
+
+// ── Texto para todos do grupo ────────────────────────────────────────────────
+const messageSecret = crypto.randomBytes(32)
+
+const msg = generateWAMessageFromContent(jid, {
+    messageContextInfo: { messageSecret },
+    groupStatusMessageV2: {
+        message: {
+            extendedTextMessage: {
+                text: 'Olá, grupo! 👋',
+                contextInfo: { isGroupStatus: true }
+            },
+            messageContextInfo: { messageSecret }
+        }
+    }
+}, {})
+
+await sock.relayMessage(jid, msg.message, { messageId: msg.key.id })
+```
+
+```js
+// ── Texto apenas para Amigos Próximos (Close Friends) ────────────────────────
+const messageSecret = crypto.randomBytes(32)
+
+const msg = generateWAMessageFromContent(jid, {
+    messageContextInfo: { messageSecret },
+    groupStatusMessageV2: {
+        message: {
+            extendedTextMessage: {
+                text: 'Só pra você que é chegado 🤫',
+                contextInfo: {
+                    isGroupStatus: true,
+                    statusAudienceMetadata: { audienceType: 1 } // 1 = Close Friends
+                }
+            },
+            messageContextInfo: { messageSecret }
+        }
+    }
+}, {})
+
+await sock.relayMessage(jid, msg.message, { messageId: msg.key.id })
+```
+
+```js
+// ── Imagem para todos do grupo ───────────────────────────────────────────────
+const messageSecret = crypto.randomBytes(32)
+
+const prep = await prepareWAMessageMedia(
+    { image: buffer },
+    { upload: sock.waUploadToServer }
+)
+
+const msg = generateWAMessageFromContent(jid, {
+    messageContextInfo: { messageSecret },
+    groupStatusMessageV2: {
+        message: {
+            imageMessage: {
+                ...prep.imageMessage,
+                caption:    'Legenda da imagem',
+                contextInfo: { isGroupStatus: true }
+            },
+            messageContextInfo: { messageSecret }
+        }
+    }
+}, {})
+
+await sock.relayMessage(jid, msg.message, { messageId: msg.key.id })
+```
+
+```js
+// ── Imagem apenas para Amigos Próximos ───────────────────────────────────────
+const messageSecret = crypto.randomBytes(32)
+
+const prep = await prepareWAMessageMedia(
+    { image: buffer },
+    { upload: sock.waUploadToServer }
+)
+
+const msg = generateWAMessageFromContent(jid, {
+    messageContextInfo: { messageSecret },
+    groupStatusMessageV2: {
+        message: {
+            imageMessage: {
+                ...prep.imageMessage,
+                caption:    'Só pra chegados 🤫',
+                contextInfo: {
+                    isGroupStatus: true,
+                    statusAudienceMetadata: { audienceType: 1 }
+                }
+            },
+            messageContextInfo: { messageSecret }
+        }
+    }
+}, {})
+
+await sock.relayMessage(jid, msg.message, { messageId: msg.key.id })
+```
+
+```js
+// ── Vídeo ─────────────────────────────────────────────────────────────────────
+const messageSecret = crypto.randomBytes(32)
+
+const prep = await prepareWAMessageMedia(
+    { video: buffer },
+    { upload: sock.waUploadToServer }
+)
+
+const msg = generateWAMessageFromContent(jid, {
+    messageContextInfo: { messageSecret },
+    groupStatusMessageV2: {
+        message: {
+            videoMessage: {
+                ...prep.videoMessage,
+                caption:    'Legenda do vídeo',
+                contextInfo: { isGroupStatus: true }
+            },
+            messageContextInfo: { messageSecret }
+        }
+    }
+}, {})
+
+await sock.relayMessage(jid, msg.message, { messageId: msg.key.id })
+```
+
+```js
+// ── Áudio ─────────────────────────────────────────────────────────────────────
+const messageSecret = crypto.randomBytes(32)
+
+const prep = await prepareWAMessageMedia(
+    { audio: buffer, mimetype: 'audio/mp4' },
+    { upload: sock.waUploadToServer }
+)
+
+const msg = generateWAMessageFromContent(jid, {
+    messageContextInfo: { messageSecret },
+    groupStatusMessageV2: {
+        message: {
+            audioMessage: {
+                ...prep.audioMessage,
+                contextInfo: { isGroupStatus: true }
+            },
+            messageContextInfo: { messageSecret }
+        }
+    }
+}, {})
+
+await sock.relayMessage(jid, msg.message, { messageId: msg.key.id })
+```
+
+**Pontos importantes:**
+- `messageSecret` deve ser um `Buffer` de 32 bytes gerado com `crypto.randomBytes(32)` — cada postagem precisa de um novo secret
+- `audienceType: 1` ativa o modo Close Friends; omitir `statusAudienceMetadata` posta para todos do grupo
+- Para repostar uma mensagem citada (quoted), baixe a mídia com `downloadMediaMessage` antes de fazer o `prepareWAMessageMedia`
+- O `groupStatus: true` no `sendMessage` simples (seção 3) existe como atalho, mas para controle de Close Friends e repost de mídias, use o `groupStatusMessageV2` direto como mostrado acima
+
+---
+
 ## Changelog
 
+### v1.0.7
+- **Fix PTT real** — `ptt: true` converte via `ffmpeg` antes do upload; corrigido bug `Cannot use 'in' operator to search for 'stream'` (caminho do arquivo transcrito era passado como string crua em vez de `{ url }`)
+- **Fix 403 / conexão** — `lidDbMigrated` no login agora reflete o estado real das credenciais; companion version usa a versão real do WA; `"forbidden"` mapeado corretamente pra `DisconnectReason.forbidden`
+- **Mensagens agendadas** — `MessageScheduler` / `createMessageScheduler` portado de innovatorssoft/baileys
+- **PreKey recovery melhorado** — upload de 30 chaves (era 5), delay de 2500ms (era 1000ms), parâmetro `force` pra ignorar `MIN_UPLOAD_INTERVAL` em recuperação de erro
+- **Fix groupMetadata → sharedLidPhoneCache** — pares LID↔telefone agora registrados automaticamente ao buscar metadata de grupo
+- Guard de pagamento stealth, Bad MAC Handler, getName, getBestWaVersion, resolveLidPhoneFromGroup, WhatsApp Flows
+
 ### v1.0.6
-- **Fix PTT real** — `ptt: true` agora transcodifica via `ffmpeg` quando necessário, em vez de só etiquetar o mimetype
-- **Fix groupMetadata → sharedLidPhoneCache** — pares LID↔telefone da lista de participantes de grupo agora são registrados no cache (antes eram descartados)
-- **Fix cleanId de identidade própria** — comparação de `sock.user.id`/`sock.user.lid` com sufixo de dispositivo (`:N`) agora preserva o domínio
-- **Guard de pagamento stealth** — `bindPaymentGuard`, evento `messages.decrypt-failed`
-- **Bad MAC Handler** — `BadMacHandler`, `badMacHandler`
-- **getName** — resolução de nome em cascata, nunca vazia
-- **getBestWaVersion** — busca de versão que não falha em silêncio
-- **resolveLidPhoneFromGroup** — força resolução via metadata de grupo
-- **WhatsApp Flows** — suporte documentado a formulários interativos (`nativeFlowResponseMessage`)
-- **isSystemNotification** — flag em mensagens de notificação de sistema
 - Sistema LID/JID avançado com cache bidirecional (`sharedLidPhoneCache`)
 - `lidToJid`, `resolveJid`, `resolveAll`, `normalizeJid`, `validateJid`, `getSenderInfo`
 - Suporte a `@username` — `isUsername`, `resolveUsername`
+- Botões estendidos (20+ tipos via `nativeFlow`)
+- Fix canal newsletter, fix groupStatus audio, `isSystemNotification`
 
 ### v1.0.5
-- Sticker Pack nativo com suporte a animadas e PNG
-- Fix canal newsletter (`extraAttrs` no `plaintext`)
+- Sticker Pack nativo com animadas e PNG
 - Album, Spoiler, ViewOnce V2, Ephemeral, Lottie, Evento
 - Native Flow, Carousel, Template Buttons
 - AI Rich (makeText, makeCode, makeTable, makeList, sendRich)
@@ -918,7 +984,7 @@ sock.ev.on('messages.upsert', async ({ messages }) => {
 
 <div align="center">
 
-**@systemzero/baileys v1.0.6**
+**@systemzero/baileys v1.0.7**
 
 Desenvolvido por [Josué </>](https://t.me/blackhzx) · [Canal WhatsApp](https://whatsapp.com/channel/0029VaqUb9aGk1FxqeKKOd2i) · [systemzone.store](https://systemzone.store)