@systemzero/baileys 1.0.4 → 1.0.5

package/README.md

@@ -1,561 +1,419 @@
-# 📦 @systemzero/baileys `v1.0.4`
+<div align="center">
 
-> Biblioteca WhatsApp Web API em Node.js — fork ultra customizado com funções avançadas de envio de mensagens, grupos, mídias, IA e muito mais.
+<img src="https://files.catbox.moe/w1m2q4.jpg" width="120" style="border-radius:16px" />
 
----
+# @systemzero/baileys
+
+**v1.0.5** · Fork avançado do Baileys com suporte nativo a todos os tipos de mensagens do WhatsApp
 
-## 📋 Sumário
-
-- [Instalação](#instalação)
-- [Conexão Básica](#conexão-básica)
-- [📨 Envio de Mensagens](#-envio-de-mensagens)
-  - [Texto](#texto)
-  - [Imagem](#imagem)
-  - [Vídeo](#vídeo)
-  - [Áudio](#áudio)
-  - [Documento](#documento)
-  - [Sticker](#sticker)
-  - [Localização](#localização)
-  - [Contato](#contato)
-  - [Enquete (Poll)](#enquete-poll)
-  - [Reação](#reação)
-  - [Menção](#menção)
-  - [Link com Preview](#link-com-preview)
-  - [Resposta (Quoted)](#resposta-quoted)
-  - [Mensagem Editada](#mensagem-editada)
-  - [Mensagem Deletada](#mensagem-deletada)
-  - [Fixar Mensagem](#fixar-mensagem)
-  - [View Once](#view-once)
-  - [Modo Efêmero (Desaparecimento)](#modo-efêmero-desaparecimento)
-- [🎨 Mensagens Interativas (Botões)](#-mensagens-interativas-botões)
-  - [Botões Rápidos (Quick Reply)](#botões-rápidos-quick-reply)
-  - [Lista](#lista)
-  - [Botões Nativos (interactiveButtons)](#botões-nativos-interactivebuttons)
-  - [Pagamento Nativo](#pagamento-nativo)
-  - [Produto](#produto)
-- [🤖 Funções Rich (Meta AI Style)](#-funções-rich-meta-ai-style)
-  - [Texto Rico](#texto-rico)
-  - [Código Rico](#código-rico)
-  - [Lista Rica](#lista-rica)
-  - [Tabela Rica](#tabela-rica)
-  - [Rich Completo](#rich-completo)
-  - [Reels Ricos](#reels-ricos)
-  - [Perplexity IA](#perplexity-ia)
-- [📁 Tipos Especiais de Mensagem](#-tipos-especiais-de-mensagem)
-  - [Álbum de Fotos/Vídeos](#álbum-de-fotosvídeos)
-  - [Evento](#evento)
-  - [Resultado de Enquete](#resultado-de-enquete)
-  - [Story de Grupo](#story-de-grupo)
-  - [Pagamento (requestPayment)](#pagamento-requestpayment)
-- [👥 Funções de Grupo](#-funções-de-grupo)
-- [💬 Funções de Chat](#-funções-de-chat)
-- [🔒 Privacidade](#-privacidade)
-- [🏷️ Labels](#️-labels)
-- [📡 Presença](#-presença)
+[![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)
+[![Author](https://img.shields.io/badge/by-Josué%20%3C%2F%3E-ec4899?style=flat-square)](https://t.me/blackhzx)
+
+</div>
 
 ---
 
 ## Instalação
 
 ```bash
-npm install @systemzero/baileys
+npm i @systemzero/baileys
+```
+
+Dependências opcionais para sticker pack e thumbnail:
+```bash
+npm i sharp
 # ou
-yarn add @systemzero/baileys
+npm i @napi-rs/image
 ```
 
-> **Requisito:** Node.js >= 20.0.0
+---
+
+## Índice
+
+1. [Conexão](#1-conexão)
+2. [Mensagens de mídia](#2-mensagens-de-mídia)
+3. [Mensagens especiais](#3-mensagens-especiais)
+4. [Botões e interativos](#4-botões-e-interativos)
+5. [Sticker Pack nativo](#5-sticker-pack-nativo)
+6. [Canais Newsletter](#6-canais-newsletter)
+7. [Enquetes com decrypt](#7-enquetes-com-decrypt)
+8. [AI Rich](#8-ai-rich)
+9. [Grupos](#9-grupos)
+10. [Perfil e privacidade](#10-perfil-e-privacidade)
+11. [Eventos do socket](#11-eventos-do-socket)
+12. [Utilitários](#12-utilitários)
 
 ---
 
-## Conexão Básica
+## 1. Conexão
+
+### Setup básico
 
 ```js
-import makeWASocket, { useMultiFileAuthState, DisconnectReason } from '@systemzero/baileys'
+const {
+    default: makeWASocket,
+    useMultiFileAuthState,
+    DisconnectReason,
+    Browsers,
+    fetchLatestWaWebVersion
+} = require('@systemzero/baileys')
 
-const { state, saveCreds } = await useMultiFileAuthState('./auth_info')
+const { state, saveCreds } = await useMultiFileAuthState('./session')
+const { version } = await fetchLatestWaWebVersion()
 
 const sock = makeWASocket({
-    auth: state,
-    printQRInTerminal: true
+    version,
+    auth:    state,
+    browser: Browsers.ubuntu('Chrome'),
+    printQRInTerminal: false,
+    logger:  require('pino')({ level: 'silent' }),
+    getMessage: async (key) => {
+        const msg = await store.loadMessage(key.remoteJid, key.id)
+        return msg?.message || undefined
+    }
 })
 
 sock.ev.on('creds.update', saveCreds)
 
 sock.ev.on('connection.update', ({ connection, lastDisconnect }) => {
     if (connection === 'close') {
-        const shouldReconnect = lastDisconnect?.error?.output?.statusCode !== DisconnectReason.loggedOut
-        if (shouldReconnect) conectar()
-    } else if (connection === 'open') {
-        console.log('✅ Conectado ao WhatsApp!')
+        const code = lastDisconnect?.error?.output?.statusCode
+        if (code !== DisconnectReason.loggedOut) startBot()
     }
 })
 ```
 
----
+### Pairing Code
+
+```js
+// Código gerado automaticamente (ex: ABCD-EFGH)
+const code = await sock.requestPairingCode('5511999999999')
 
-## 📨 Envio de Mensagens
+// Código personalizado — exatamente 8 caracteres
+const code = await sock.requestPairingCode('5511999999999', 'MYBOT001')
+```
 
-Todas as funções de envio usam `sock.sendMessage(jid, conteúdo, opções?)`.
+### Store em memória
 
-O `jid` é o identificador do destinatário:
-- **Privado:** `'5511999999999@s.whatsapp.net'`
-- **Grupo:** `'120363xxxxxxxx@g.us'`
-- **Status:** `'status@broadcast'`
+```js
+const store = {
+    messages: {},
+    bind: (ev) => {
+        ev.on('messages.upsert', ({ messages }) => {
+            for (const msg of messages) {
+                if (!msg.key?.remoteJid) continue
+                store.messages[msg.key.remoteJid] ??= {}
+                store.messages[msg.key.remoteJid][msg.key.id] = msg
+            }
+        })
+    },
+    loadMessage: async (jid, id) => store.messages[jid]?.[id] || null
+}
+
+store.bind(sock.ev)
+```
 
 ---
 
-### Texto
+## 2. Mensagens de mídia
 
-Envia uma mensagem de texto simples.
+Todos os campos de mídia aceitam `Buffer`, `{ url: 'https://...' }` ou `{ stream: ReadableStream }`.
 
-```js
-await sock.sendMessage('5511999999999@s.whatsapp.net', {
-    text: 'Olá, mundo! 👋'
-})
-```
+### Texto
 
-Com formatação WhatsApp:
 ```js
+await sock.sendMessage(jid, { text: 'Olá!' })
+
+// Com menção
 await sock.sendMessage(jid, {
-    text: '*negrito* _itálico_ ~tachado~ `monoespaçado`'
+    text:     '@55119...!',
+    mentions: ['5511999999999@s.whatsapp.net']
 })
 ```
 
----
-
 ### Imagem
 
-Envia uma imagem com legenda opcional. Aceita **Buffer**, **URL** ou **caminho local**.
-
 ```js
-// Por URL
 await sock.sendMessage(jid, {
-    image: { url: 'https://exemplo.com/foto.jpg' },
-    caption: 'Uma linda foto 🖼️'
-})
-
-// Por Buffer
-import { readFileSync } from 'fs'
-await sock.sendMessage(jid, {
-    image: readFileSync('./imagem.jpg'),
-    caption: 'Foto do arquivo'
+    image:   { url: 'https://exemplo.com/foto.jpg' },
+    caption: 'Legenda'
 })
 ```
 
----
-
 ### Vídeo
 
-Envia um vídeo com legenda opcional. Aceita **Buffer**, **URL** ou **caminho local**.
-
 ```js
-// Por URL
-await sock.sendMessage(jid, {
-    video: { url: 'https://exemplo.com/video.mp4' },
-    caption: 'Assista esse vídeo! 🎬',
-    mimetype: 'video/mp4'
-})
-
-// Como GIF animado
 await sock.sendMessage(jid, {
-    video: readFileSync('./animacao.mp4'),
-    gifPlayback: true,   // Reproduz como GIF
-    caption: 'Olha esse gif!'
+    video:       { url: 'https://exemplo.com/video.mp4' },
+    caption:     'Legenda',
+    gifPlayback: false   // true envia como GIF silencioso
 })
 ```
 
----
-
 ### Áudio
 
-Envia um áudio. Use `ptt: true` para enviar como mensagem de voz (PTT).
-
 ```js
-// Áudio normal (arquivo de música)
+// Música
 await sock.sendMessage(jid, {
-    audio: { url: 'https://exemplo.com/musica.mp3' },
-    mimetype: 'audio/mp4'
+    audio:    buffer,
+    mimetype: 'audio/mpeg',
+    ptt:      false
 })
 
-// Mensagem de voz (PTT)
+// Nota de voz (PTT)
 await sock.sendMessage(jid, {
-    audio: readFileSync('./audio.ogg'),
+    audio:    buffer,
     mimetype: 'audio/ogg; codecs=opus',
-    ptt: true   // Aparece como áudio de voz
+    ptt:      true
 })
 ```
 
----
-
 ### Documento
 
-Envia um arquivo/documento com nome customizado.
-
 ```js
 await sock.sendMessage(jid, {
-    document: { url: 'https://exemplo.com/arquivo.pdf' },
+    document: buffer,
     mimetype: 'application/pdf',
-    fileName: 'Relatório Mensal.pdf',
-    caption: 'Segue o relatório em anexo 📄'
-})
-
-// Por Buffer
-await sock.sendMessage(jid, {
-    document: readFileSync('./contrato.docx'),
-    mimetype: 'application/vnd.openxmlformats-officedocument.wordprocessingml.document',
-    fileName: 'Contrato.docx'
+    fileName: 'relatorio.pdf',
+    caption:  'Segue o relatório'
 })
 ```
 
----
-
-### Sticker
-
-Envia um sticker (figurinha). Deve ser WebP ou convertido previamente.
+### Figurinha
 
 ```js
-await sock.sendMessage(jid, {
-    sticker: readFileSync('./figurinha.webp')
-})
-
-// Por URL
-await sock.sendMessage(jid, {
-    sticker: { url: 'https://exemplo.com/sticker.webp' }
-})
+await sock.sendMessage(jid, { sticker: buffer })
 ```
 
----
+### Album (múltiplas mídias agrupadas)
 
-### Localização
-
-Envia uma localização no mapa.
+Mínimo 2 itens.
 
 ```js
 await sock.sendMessage(jid, {
-    location: {
-        degreesLatitude: -23.5505,
-        degreesLongitude: -46.6333,
-        name: 'São Paulo, SP',
-        address: 'Av. Paulista, 1000'
-    }
+    album: [
+        { image: buffer1 },
+        { image: buffer2, caption: 'Segunda foto' },
+        { video: bufferVideo },
+    ]
 })
 ```
 
----
-
 ### Contato
 
-Envia um contato (vCard).
-
 ```js
-const vcard = `BEGIN:VCARD
-VERSION:3.0
-FN:João Silva
-ORG:Empresa LTDA;
-TEL;type=CELL;type=VOICE;waid=5511999999999:+55 11 99999-9999
-END:VCARD`
-
 await sock.sendMessage(jid, {
     contacts: {
-        displayName: 'João Silva',
-        contacts: [{ vcard }]
+        displayName: 'João',
+        contacts: [{
+            vcard: `BEGIN:VCARD\nVERSION:3.0\nFN:João Silva\nTEL:+5511999999999\nEND:VCARD`
+        }]
     }
 })
 ```
 
----
-
-### Enquete (Poll)
-
-Cria uma enquete interativa no WhatsApp.
+### Localização
 
 ```js
 await sock.sendMessage(jid, {
-    poll: {
-        name: 'Qual sua linguagem favorita?',
-        values: ['JavaScript', 'Python', 'TypeScript', 'Go'],
-        selectableCount: 1   // Quantas opções o usuário pode escolher
+    location: {
+        degreesLatitude:  -23.550520,
+        degreesLongitude: -46.633308,
+        name:             'São Paulo',
+        address:          'SP, Brasil'
     }
 })
 ```
 
 ---
 
-### Reação
+## 3. Mensagens especiais
 
-Reage a uma mensagem com um emoji.
+### Reação
 
 ```js
 await sock.sendMessage(jid, {
-    react: {
-        text: '❤️',   // Emoji da reação (string vazia para remover)
-        key: mensagem.key   // Key da mensagem que será reagida
-    }
+    react: { text: '❤️', key: message.key }
+    // text: '' remove a reação
 })
 ```
 
-Para remover uma reação:
+### Deletar mensagem
+
 ```js
-await sock.sendMessage(jid, {
-    react: { text: '', key: mensagem.key }
-})
+await sock.sendMessage(jid, { delete: message.key })
 ```
 
----
-
-### Menção
-
-Menciona um ou mais usuários no texto.
+### Editar mensagem
 
 ```js
 await sock.sendMessage(jid, {
-    text: 'Oi @5511999999999, tudo bem?',
-    mentions: ['5511999999999@s.whatsapp.net']
+    edit: message.key,
+    text: 'Texto editado'
 })
 ```
 
----
-
-### Link com Preview
-
-Envia uma mensagem de texto — o preview do link é gerado automaticamente se `generateHighQualityLinkPreview: true` estiver ativado na config.
+### Fixar mensagem
 
 ```js
 await sock.sendMessage(jid, {
-    text: 'Confira: https://github.com'
+    pin: {
+        type:       1,           // 1 = fixar, 2 = desfixar
+        time:       86400,       // duração em segundos
+        messageKey: message.key
+    }
 })
 ```
 
----
+### Encaminhar
 
-### Resposta (Quoted)
+```js
+const { generateForwardMessageContent, generateWAMessageFromContent } = require('@systemzero/baileys')
 
-Responde a uma mensagem específica.
+const content = generateForwardMessageContent(message, false)
+const msg     = generateWAMessageFromContent(jid, content, { quoted: m })
+await sock.relayMessage(jid, msg.message, { messageId: msg.key.id })
+```
+
+### View Once
 
 ```js
-// Dentro do handler de mensagens:
-sock.ev.on('messages.upsert', async ({ messages }) => {
-    const msg = messages[0]
-
-    await sock.sendMessage(msg.key.remoteJid, {
-        text: 'Essa é minha resposta!'
-    }, {
-        quoted: msg   // Passa a mensagem original para responder
-    })
-})
-```
+await sock.sendMessage(jid, { image: buffer, viewOnce: true })
 
----
+// V2
+await sock.sendMessage(jid, { image: buffer, viewOnceV2: true })
 
-### Mensagem Editada
+// V2 Extension
+await sock.sendMessage(jid, { image: buffer, viewOnceV2Extension: true })
+```
 
-Edita o conteúdo de uma mensagem já enviada.
+### Spoiler
 
 ```js
 await sock.sendMessage(jid, {
-    text: 'Texto corrigido ✏️',
-    edit: mensagemOriginal.key   // Key da mensagem a ser editada
+    image:   buffer,
+    caption: 'Spoiler!',
+    spoiler: true
 })
 ```
 
----
-
-### Mensagem Deletada
-
-Deleta uma mensagem (para todos).
+### Status de grupo
 
 ```js
 await sock.sendMessage(jid, {
-    delete: mensagem.key   // Key da mensagem a deletar
+    image:       buffer,
+    caption:     'Status do grupo',
+    groupStatus: true
 })
 ```
 
----
-
-### Fixar Mensagem
-
-Fixa uma mensagem no chat ou grupo.
+### Mensagem efêmera
 
 ```js
 await sock.sendMessage(jid, {
-    pin: mensagem.key,   // Key da mensagem a fixar
-    type: 1              // 1 = fixar, 2 = desfixar
+    image:    buffer,
+    ephemeral: true
 })
 ```
 
----
-
-### View Once
-
-Envia mídia que some após ser visualizada uma vez.
+### Lottie (sticker animado especial)
 
 ```js
 await sock.sendMessage(jid, {
-    image: readFileSync('./foto_secreta.jpg'),
-    viewOnce: true,
-    caption: 'Esta foto vai sumir! 🔥'
+    sticker:  buffer,
+    isLottie: true
 })
 ```
 
----
-
-### Modo Efêmero (Desaparecimento)
-
-Ativa ou desativa mensagens temporárias em grupos.
+### Keep (salvar mensagem)
 
 ```js
-// Ativar (86400 = 24h, 604800 = 7 dias, 7776000 = 90 dias)
 await sock.sendMessage(jid, {
-    disappearingMessagesInChat: 604800  // 7 dias em segundos
+    keep: message.key,
+    type: 1   // 1 = salvar, 2 = remover
 })
+```
+
+### Evento
 
-// Desativar
+```js
 await sock.sendMessage(jid, {
-    disappearingMessagesInChat: false
+    event: {
+        isCanceled:  false,
+        name:        'Reunião',
+        description: 'Alinhamento',
+        location:    { name: 'Sala 3', address: 'Rua X, 100' },
+        startTime:   Math.floor(Date.now() / 1000) + 3600,
+        endTime:     Math.floor(Date.now() / 1000) + 7200,
+    }
 })
 ```
 
----
-
-## 🎨 Mensagens Interativas (Botões)
-
-### Botões Rápidos (Quick Reply)
-
-Envia botões de resposta rápida usando a sintaxe simplificada.
+### Enquete
 
 ```js
 await sock.sendMessage(jid, {
-    text: 'Escolha uma opção:',
-    footer: 'Sistema de Atendimento',
-    buttons: [
-        { buttonText: { displayText: '✅ Sim' }, buttonId: 'sim' },
-        { buttonText: { displayText: '❌ Não' }, buttonId: 'nao' },
-        { buttonText: { displayText: '❓ Talvez' }, buttonId: 'talvez' }
-    ]
+    poll: {
+        name:            'Qual seu time?',
+        values:          ['Flamengo', 'Corinthians', 'Palmeiras'],
+        selectableCount: 1   // 0 = múltipla escolha
+    }
 })
 ```
 
----
+### Invoice (nota fiscal)
 
-### Lista
+```js
+await sock.sendMessage(jid, {
+    image:       buffer,
+    invoiceNote: 'Pagamento pedido #1234'
+})
+```
 
-Envia uma lista interativa de opções (menu).
+### External Ad Reply
 
 ```js
 await sock.sendMessage(jid, {
-    listMessage: {
-        title: 'Menu Principal',
-        text: 'Selecione uma opção abaixo:',
-        footer: 'Powered by SystemZero',
-        buttonText: 'Ver Opções',
-        sections: [
-            {
-                title: 'Serviços',
-                rows: [
-                    { title: 'Suporte', description: 'Falar com atendente', rowId: 'suporte' },
-                    { title: 'Financeiro', description: 'Ver cobranças', rowId: 'financeiro' }
-                ]
-            }
-        ]
+    text: 'Confira!',
+    externalAdReply: {
+        title:                 'System Zero',
+        body:                  'Descrição do produto',
+        thumbnail:             bufferImagem,
+        mediaType:             1,
+        sourceUrl:             'https://systemzone.store',
+        renderLargerThumbnail: true
     }
 })
 ```
 
----
-
-### Botões Nativos (interactiveButtons)
-
-Botões nativos com suporte a imagem/vídeo no cabeçalho.
+### Mention All
 
 ```js
 await sock.sendMessage(jid, {
-    interactiveButtons: [
-        {
-            name: 'quick_reply',
-            buttonParamsJson: JSON.stringify({
-                display_text: '📋 Ver Cardápio',
-                id: 'cardapio'
-            })
-        },
-        {
-            name: 'cta_url',
-            buttonParamsJson: JSON.stringify({
-                display_text: '🌐 Acessar Site',
-                url: 'https://meusite.com',
-                merchant_url: 'https://meusite.com'
-            })
-        },
-        {
-            name: 'cta_call',
-            buttonParamsJson: JSON.stringify({
-                display_text: '📞 Ligar',
-                phone_number: '+5511999999999'
-            })
-        }
-    ],
-    text: 'Olá! Como posso te ajudar?',
-    footer: 'Atendimento 24h'
+    text:       '👋 @all',
+    mentionAll: true
 })
 ```
 
----
-
-### Pagamento Nativo
-
-Solicita um pagamento pelo WhatsApp Pay.
+### Convite de pagamento
 
 ```js
 await sock.sendMessage(jid, {
-    interactiveButtons: [
-        {
-            name: 'review_and_pay',
-            buttonParamsJson: JSON.stringify({
-                currency: 'BRL',
-                total_amount: { value: 5000, offset: 100 },  // R$ 50,00
-                reference_id: 'PEDIDO-001',
-                type: 'physical-goods',
-                order: {
-                    status: 'pending',
-                    subtotal: { value: 5000, offset: 100 },
-                    order_type: 'ORDER',
-                    items: [{
-                        name: 'Produto X',
-                        amount: { value: 5000, offset: 100 },
-                        quantity: 1,
-                        sale_amount: { value: 5000, offset: 100 }
-                    }]
-                }
-            })
-        }
-    ],
-    text: 'Seu pedido está pronto para pagamento!'
+    paymentInviteServiceType: 3
 })
 ```
 
----
-
-### Produto
-
-Exibe um produto com imagem, preço e botões de ação.
+### Resultado de enquete (snapshot)
 
 ```js
 await sock.sendMessage(jid, {
-    productMessage: {
-        title: 'Tênis Nike Air Max',
-        description: 'Conforto e estilo para o dia a dia.',
-        thumbnail: { url: 'https://exemplo.com/tenis.jpg' },
-        productId: 'PRODUTO-001',
-        retailerId: 'LOJA-BR',
-        priceAmount1000: 39900,   // R$ 399,00
-        currencyCode: 'BRL',
-        url: 'https://minhaloja.com/produto',
-        body: 'Aproveite a oferta!',
-        footer: 'Frete grátis acima de R$ 200',
-        buttons: [
-            {
-                name: 'quick_reply',
-                buttonParamsJson: JSON.stringify({ display_text: '🛒 Comprar', id: 'comprar' })
-            }
+    pollResult: {
+        name:     'Pergunta?',
+        pollType: 0,   // 0 = poll, 1 = quiz
+        votes: [
+            { name: 'Opção A', voteCount: 12 },
+            { name: 'Opção B', voteCount: 7 },
         ]
     }
 })
@@ -563,530 +421,600 @@ await sock.sendMessage(jid, {
 
 ---
 
-## 🤖 Funções Rich (Meta AI Style)
-
-Estas funções enviam mensagens no estilo do Meta AI com formatação especial.
+## 4. Botões e interativos
 
-### Texto Rico
+### Estrutura base
 
 ```js
-await sock.sendRichText(jid, 'Esta é uma mensagem de texto rica! ✨')
+const { generateWAMessageFromContent, proto } = require('@systemzero/baileys')
 
-// Com resposta (quoted)
-await sock.sendRichText(jid, 'Mensagem rica em resposta', mensagemOriginal)
-```
-
----
-
-### Código Rico
-
-Exibe um bloco de código com syntax highlighting.
+const msg = generateWAMessageFromContent(jid, {
+    viewOnceMessage: {
+        message: {
+            interactiveMessage: proto.Message.InteractiveMessage.create({
+                header: { title: 'Título', hasMediaAttachment: false },
+                body:   { text: 'Texto do corpo' },
+                footer: { text: 'Rodapé' },
+                nativeFlowMessage: {
+                    buttons: [ /* tipos abaixo */ ]
+                }
+            })
+        }
+    }
+}, { quoted: m })
 
-```js
-await sock.sendRichCode(
-    jid,
-    'Exemplo em JavaScript:',   // Título (opcional)
-    'javascript',               // Linguagem
-    `function soma(a, b) {
-    return a + b;
-}
-console.log(soma(2, 3));`
-)
+await sock.relayMessage(jid, msg.message, { messageId: msg.key.id })
 ```
 
----
-
-### Lista Rica
-
-Exibe uma lista de itens formatada.
+### Tipos de botão
 
 ```js
-await sock.sendRichList(
-    jid,
-    '📋 Lista de Tarefas:',           // Título
-    ['Estudar Node.js', 'Fazer deploy', 'Testar bot', 'Dormir']
-)
-```
+// Resposta rápida
+{ name: 'quick_reply', buttonParamsJson: JSON.stringify({ display_text: 'Confirmar', id: 'confirmar' }) }
 
----
+// Link externo
+{ name: 'cta_url', buttonParamsJson: JSON.stringify({ display_text: 'Abrir', url: 'https://systemzone.store' }) }
 
-### Tabela Rica
+// Copiar texto
+{ name: 'cta_copy', buttonParamsJson: JSON.stringify({ display_text: 'Copiar código', copy_code: 'PROMO2025' }) }
 
-Exibe uma tabela formatada (primeira linha é o cabeçalho).
+// Ligar
+{ name: 'cta_call', buttonParamsJson: JSON.stringify({ display_text: 'Ligar', phone_number: '5511999999999' }) }
 
-```js
-await sock.sendRichTable(
-    jid,
-    '📊 Relatório de Vendas',             // Título
-    [
-        ['Produto', 'Qtd', 'Valor'],       // Cabeçalho
-        ['Camiseta', '10', 'R$ 300'],
-        ['Calça', '5', 'R$ 500'],
-        ['Tênis', '3', 'R$ 900']
-    ],
-    'Total: R$ 1.700'                      // Rodapé (opcional)
-)
-```
+// Webview interno
+{ name: 'cta_webview', buttonParamsJson: JSON.stringify({ title: 'Painel', url: 'https://systemzone.store' }) }
 
----
+// Lista dropdown com seções
+{
+    name: 'single_select',
+    buttonParamsJson: JSON.stringify({
+        title: 'Escolher',
+        sections: [{
+            title: 'Categoria',
+            rows: [
+                { header: 'Op 1', title: 'Opção 1', description: 'Desc', id: 'op1' },
+                { header: 'Op 2', title: 'Opção 2', description: 'Desc', id: 'op2' },
+            ]
+        }]
+    })
+}
+```
 
-### Rich Completo
+### Header com imagem
 
-Combina texto, código, lista e tabela em uma única mensagem.
+Upload da imagem antes de usar no header:
 
 ```js
-await sock.sendRichFull(jid, {
-    title: '🚀 Relatório Completo',
-    code: `const resultado = calcular()`,
-    language: 'javascript',
-    items: ['Item A', 'Item B', 'Item C'],
-    table: [
-        ['Campo', 'Valor'],
-        ['Status', 'Ativo'],
-        ['Versão', '1.0.3']
-    ],
-    footer: '© SystemZero Baileys'
+const { generateWAMessage, generateMessageIDV2 } = require('@systemzero/baileys')
+
+const uploaded = await generateWAMessage(jid, { image: buffer }, {
+    upload:    sock.waUploadToServer,
+    userJid:   sock.user.id,
+    messageId: generateMessageIDV2(sock.user.id),
 })
-```
+const img = uploaded.message?.imageMessage
 
----
+// No header:
+header: {
+    title:              '',
+    hasMediaAttachment: true,
+    imageMessage: {
+        url:               img.url,
+        mimetype:          img.mimetype,
+        fileSha256:        img.fileSha256,
+        fileLength:        img.fileLength,
+        mediaKey:          img.mediaKey,
+        fileEncSha256:     img.fileEncSha256,
+        directPath:        img.directPath,
+        mediaKeyTimestamp: img.mediaKeyTimestamp,
+        jpegThumbnail:     img.jpegThumbnail,
+    }
+}
+```
 
-### Reels Ricos
+### Catálogo (product no header)
+
+```js
+header: {
+    title:              'Produto',
+    hasMediaAttachment: true,
+    productMessage:     proto.Message.ProductMessage.create({
+        product: proto.Message.ProductMessage.ProductSnapshot.create({
+            productImage:    proto.Message.ImageMessage.create({ ...img }),
+            productId:       'ID-001',
+            title:           'Nome do Produto',
+            description:     'Descrição completa',
+            currencyCode:    'BRL',
+            priceAmount1000: 29990,   // R$ 29,99
+            retailerId:      'minha-loja',
+            url:             'https://loja.com/produto',
+            productImageCount: 1,
+        }),
+        businessOwnerJid: sock.user.id
+    })
+}
+```
 
-Envia uma mensagem no estilo de resultado de busca com reels/vídeos.
+### Carousel
 
 ```js
-await sock.sendRichReels(
-    jid,
-    'Resultado da Busca',        // Título
-    'Vídeos encontrados',        // Header
-    'gatos fofinhos',            // Query de busca
-    [
+await sock.sendMessage(jid, {
+    cards: [
+        {
+            image:      buffer1,
+            caption:    'Texto do card 1',
+            title:      'Card 1',
+            nativeFlow: [
+                { text: 'Ver mais', id: 'card1' },
+                { text: 'Site', url: 'https://systemzone.store' }
+            ]
+        },
         {
-            title: 'Gato dançando',
-            url: 'https://video1.com',
-            thumbnail: 'https://thumb1.com/img.jpg'
+            image:      buffer2,
+            caption:    'Texto do card 2',
+            nativeFlow: [{ text: 'Clique', id: 'card2' }]
         }
-    ]
-)
+    ],
+    footer: 'Rodapé'
+})
 ```
 
----
-
-### Perplexity IA
-
-Consulta a API Perplexity e envia a resposta no chat.
+### Template Buttons
 
 ```js
-await sock.sendPerplexity(
-    jid,
-    'Qual a capital do Brasil?'
-)
-
-// Com opções (ex: responder a uma mensagem)
-await sock.sendPerplexity(
-    jid,
-    'Explique inteligência artificial',
-    { quoted: mensagemOriginal }
-)
+await sock.sendMessage(jid, {
+    text:            'Escolha:',
+    templateButtons: [
+        { text: 'Resposta', id:   'res1' },
+        { text: 'Site',     url:  'https://systemzone.store' },
+        { text: 'Ligar',    call: '5511999999999' },
+    ]
+})
 ```
 
----
-
-## 📁 Tipos Especiais de Mensagem
-
-### Álbum de Fotos/Vídeos
-
-Envia múltiplas fotos/vídeos como um álbum agrupado.
+### Sections (lista clássica)
 
 ```js
 await sock.sendMessage(jid, {
-    albumMessage: [
-        { image: { url: 'https://exemplo.com/foto1.jpg' }, caption: 'Foto 1' },
-        { image: { url: 'https://exemplo.com/foto2.jpg' }, caption: 'Foto 2' },
-        { video: { url: 'https://exemplo.com/clip.mp4' }, caption: 'Vídeo do evento' }
-    ]
+    text:       'Selecione',
+    buttonText: 'Ver opções',
+    sections: [{
+        title: 'Categoria',
+        rows: [
+            { title: 'Item 1', description: 'Desc', id: 'item1' },
+            { title: 'Item 2', description: 'Desc', id: 'item2' },
+        ]
+    }]
 })
 ```
 
----
-
-### Evento
-
-Cria um evento no grupo ou conversa.
+### Interactive como Template
 
 ```js
 await sock.sendMessage(jid, {
-    eventMessage: {
-        name: '🎉 Reunião de Equipe',
-        description: 'Reunião semanal de alinhamento da equipe de desenvolvimento.',
-        location: {
-            degreesLatitude: -23.5505,
-            degreesLongitude: -46.6333,
-            name: 'Escritório Central, São Paulo'
-        },
-        joinLink: 'https://meet.google.com/abc-xyz',
-        startTime: Date.now() + 86400000,      // Amanhã
-        endTime: Date.now() + 86400000 + 3600000,  // +1 hora
-        extraGuestsAllowed: true,
-        isCanceled: false
-    }
+    nativeFlow: [{ text: 'Clique', id: 'btn' }],
+    text:       'Mensagem',
+    interactiveAsTemplate: true
 })
 ```
 
----
-
-### Resultado de Enquete
-
-Envia um snapshot de resultado de votação.
+### Botões com imagem no corpo (não no header)
 
 ```js
 await sock.sendMessage(jid, {
-    pollResultMessage: {
-        name: 'Qual sua linguagem favorita?',
-        pollVotes: [
-            { optionName: 'JavaScript', optionVoteCount: 42 },
-            { optionName: 'Python', optionVoteCount: 35 },
-            { optionName: 'TypeScript', optionVoteCount: 28 }
-        ]
-    }
+    image:   buffer,
+    caption: 'Escolha:',
+    buttons: [
+        { text: 'Opção 1', id: 'op1' },
+        { text: 'Link', url: 'https://systemzone.store' },
+    ]
 })
 ```
 
----
-
-### Story de Grupo
-
-Envia uma mensagem como story/status de grupo.
+### Áudio no rodapé de interativo
 
 ```js
 await sock.sendMessage(jid, {
-    groupStatusMessage: {
-        image: { url: 'https://exemplo.com/story.jpg' },
-        caption: 'Nosso grupo é o melhor! 🔥'
-    }
-})
-
-// Com vídeo
-await sock.sendMessage(jid, {
-    groupStatusMessage: {
-        video: { url: 'https://exemplo.com/story.mp4' },
-        caption: 'Evento da semana'
-    }
+    text:        'Ouça e escolha:',
+    nativeFlow:  [{ text: 'Opção', id: 'op' }],
+    audioFooter: bufferAudio
 })
 ```
 
 ---
 
-### Pagamento (requestPayment)
+## 5. Sticker Pack nativo
 
-Solicita um pagamento com nota ou sticker.
+Envia um pack de figurinhas que aparece na aba de stickers do WhatsApp, igual a um pack real.
 
 ```js
 await sock.sendMessage(jid, {
-    requestPaymentMessage: {
-        amount: 15000,              // R$ 150,00 (em centavos × 10)
-        currency: 'BRL',
-        from: '5511999999999@s.whatsapp.net',
-        expiry: Math.floor(Date.now() / 1000) + 86400,  // 24h
-        note: 'Pagamento do serviço de bot 🤖'
-    }
+    cover:    { url: 'https://exemplo.com/capa.webp' },
+    stickers: [
+        { data: buffer1,       emojis: ['😂'] },
+        { data: bufferAnimado, emojis: ['🔥', '💀'] },
+        { data: bufferPng,     emojis: ['🐱'] },    // PNG converte automaticamente
+    ],
+    name:        'Nome do Pack',
+    publisher:   'Autor',
+    description: 'Descrição opcional'
 })
 ```
 
+`cover` aceita `Buffer`, `{ url }` ou `{ stream }`. O mesmo vale para cada `sticker.data`.
+
+Limites: máximo **60 figurinhas** por pack, cada uma com até **1MB**.
+
+Requer `sharp` ou `@napi-rs/image` para conversão de PNG e geração de thumbnail. Sem eles, apenas WebP é aceito.
+
 ---
 
-## 👥 Funções de Grupo
+## 6. Canais Newsletter
 
-### Criar Grupo
+### Enviar texto
 
 ```js
-const grupo = await sock.groupCreate('Nome do Grupo', [
-    '5511999999999@s.whatsapp.net',
-    '5521888888888@s.whatsapp.net'
-])
-console.log('Grupo criado:', grupo.id)
+await sock.sendMessage('120363...@newsletter', { text: 'Novidade!' })
 ```
 
----
+### Enviar mídia
 
-### Metadados do Grupo
+`sendMessage` não passa pelo `encodeNewsletterMessage` corretamente para mídia. Use sempre `generateWAMessage` + `relayMessage`:
 
 ```js
-const info = await sock.groupMetadata('120363xxxxxxxx@g.us')
-console.log(info.subject)       // Nome do grupo
-console.log(info.participants)  // Lista de participantes
-console.log(info.desc)          // Descrição
+const { generateWAMessage, generateMessageIDV2 } = require('@systemzero/baileys')
+
+const canalJid = '120363...@newsletter'
+
+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,
+})
 ```
 
----
+Funciona para `image`, `video`, `audio`, `sticker`, `document`.
 
-### Adicionar / Remover / Promover / Rebaixar Participantes
+### Gerenciar canais
 
 ```js
-// Adicionar
-await sock.groupParticipantsUpdate(jid, ['5511999999999@s.whatsapp.net'], 'add')
+// Criar
+const canal = await sock.newsletterCreate('Nome do Canal', 'Descrição')
+
+// Seguir / deixar
+await sock.newsletterFollow(jid)
+await sock.newsletterUnfollow(jid)
 
-// Remover
-await sock.groupParticipantsUpdate(jid, ['5511999999999@s.whatsapp.net'], 'remove')
+// Silenciar
+await sock.newsletterMute(jid)
+await sock.newsletterUnmute(jid)
 
-// Tornar admin
-await sock.groupParticipantsUpdate(jid, ['5511999999999@s.whatsapp.net'], 'promote')
+// Metadata
+const meta = await sock.newsletterMetadata('jid', jid)
+const meta = await sock.newsletterMetadata('invite', 'CODIGO')
 
-// Remover admin
-await sock.groupParticipantsUpdate(jid, ['5511999999999@s.whatsapp.net'], 'demote')
+// Atualizar
+await sock.newsletterUpdateName(jid, 'Novo Nome')
+await sock.newsletterUpdateDescription(jid, 'Nova descrição')
+await sock.newsletterUpdatePicture(jid, buffer)
+await sock.newsletterRemovePicture(jid)
+
+// Reagir a mensagem
+await sock.newsletterReactMessage(jid, serverId, '❤️')
+
+// Listar mensagens
+const msgs = await sock.newsletterFetchMessages(jid, 30, 0, 0)
+
+// Admin
+const count    = await sock.newsletterAdminCount(jid)
+await sock.newsletterChangeOwner(jid, novoDonoJid)
+await sock.newsletterDemote(jid, usuarioJid)
+await sock.newsletterDelete(jid)
+
+// Seguidores
+const { subscribers } = await sock.newsletterSubscribers(jid)
 ```
 
 ---
 
-### Atualizar Nome e Descrição
+## 7. Enquetes com decrypt
+
+### Criar enquete
 
 ```js
-await sock.groupUpdateSubject(jid, 'Novo Nome do Grupo ✨')
-await sock.groupUpdateDescription(jid, 'Nova descrição incrível do grupo!')
+await sock.sendMessage(jid, {
+    poll: {
+        name:            'Pergunta?',
+        values:          ['A', 'B', 'C'],
+        selectableCount: 1   // 0 = múltipla escolha
+    }
+})
 ```
 
----
+### Receber e descriptografar votos
 
-### Link de Convite
+No `connect.js`, após `saveCreds`:
 
 ```js
-// Obter link
-const code = await sock.groupInviteCode(jid)
-console.log(`https://chat.whatsapp.com/${code}`)
+const { getAggregateVotesInPollMessage } = require('@systemzero/baileys/lib/Utils/messages.js')
 
-// Revogar e gerar novo link
-await sock.groupRevokeInvite(jid)
+sock.ev.on('messages.update', async (updates) => {
+    for (const { key, update } of updates) {
+        if (!update.pollUpdates) continue
+
+        const pollMsg = await store.loadMessage(key.remoteJid, key.id)
+        if (!pollMsg?.message) continue
 
-// Entrar por código
-await sock.groupAcceptInvite('CodigoAqui')
+        const result = getAggregateVotesInPollMessage({
+            message:     pollMsg.message,
+            pollUpdates: update.pollUpdates,
+        })
 
-// Info do grupo pelo link
-const info = await sock.groupGetInviteInfo('CodigoAqui')
+        // [{ name: 'Opção A', voters: ['5511...@s.whatsapp.net'] }]
+        console.log(result)
+
+        if (!global.pollResults) global.pollResults = {}
+        global.pollResults[key.id] = { options: result, jid: key.remoteJid }
+    }
+})
 ```
 
+O `getMessage` precisa estar configurado no `makeWASocket` (veja seção 1).
+
 ---
 
-### Configurações do Grupo
+## 8. AI Rich
 
-```js
-// Apenas admins enviam mensagens
-await sock.groupSettingUpdate(jid, 'announcement')
+Mensagens com formatação avançada: markdown, código, tabelas, hyperlinks clicáveis no texto.
 
-// Todos podem enviar
-await sock.groupSettingUpdate(jid, 'not_announcement')
+### Direto pelo socket
 
-// Apenas admins editam info
-await sock.groupSettingUpdate(jid, 'locked')
+```js
+// Texto com hyperlink
+await sock.sendRich(jid, [
+    sock.makeText('Acesse [nosso site](https://systemzone.store).')
+], quotedMsg)
 
-// Todos editam info
-await sock.groupSettingUpdate(jid, 'unlocked')
+// Código
+await sock.sendRich(jid, [
+    sock.makeCode('bash', 'npm i @systemzero/baileys')
+], null, ['RICH_RESPONSE_CODE'])
 
-// Modo de adição de membros
-await sock.groupMemberAddMode(jid, 'all_member_add')  // Todos podem adicionar
-await sock.groupMemberAddMode(jid, 'admin_add')        // Só admins
+// Tabela
+await sock.sendRich(jid, [
+    sock.makeTable([
+        ['Nome',    'Status'],
+        ['Botões',  '✅'],
+        ['Canais',  '✅'],
+    ])
+], null, ['RICH_RESPONSE_TABLE'])
 
-// Aprovação para entrar
-await sock.groupJoinApprovalMode(jid, 'on')   // Ativar aprovação
-await sock.groupJoinApprovalMode(jid, 'off')  // Desativar
-```
+// Lista
+await sock.sendRich(jid, [
+    sock.makeList(['Item 1', 'Item 2', 'Item 3'])
+])
 
----
+// Tudo junto
+await sock.sendRich(jid, [
+    sock.makeText('# Título\nConteúdo com [link](https://systemzone.store)'),
+    sock.makeCode('javascript', 'const x = require("@systemzero/baileys")'),
+    sock.makeTable([['Col A', 'Col B'], ['val1', 'val2']]),
+], quotedMsg, ['RICH_RESPONSE_CODE', 'RICH_RESPONSE_TABLE'])
+```
 
-### Sair do Grupo
+### Atalhos
 
 ```js
-await sock.groupLeave(jid)
+await sock.sendRichText(jid, 'Texto com [link](https://systemzone.store)', quotedMsg)
+await sock.sendRichCode(jid, 'Título', 'javascript', 'console.log("hi")', quotedMsg)
+await sock.sendRichList(jid, 'Lista', ['A', 'B', 'C'], quotedMsg)
 ```
 
----
-
-### Solicitações de Participação
+### Usando a classe AIRich
 
 ```js
-// Listar solicitações pendentes
-const solicitacoes = await sock.groupRequestParticipantsList(jid)
+const { AIRich } = require('@systemzero/baileys/lib/MB.cjs')
 
-// Aprovar ou rejeitar
-await sock.groupRequestParticipantsUpdate(jid, ['5511999999999@s.whatsapp.net'], 'approve')
-await sock.groupRequestParticipantsUpdate(jid, ['5511999999999@s.whatsapp.net'], 'reject')
+const msg = new AIRich(sock)
+msg.addText('Texto com [link](https://systemzone.store)')
+msg.addCode('javascript', 'const x = 1')
+msg.addTable([['Col', 'Valor'], ['linha', 'dado']])
+await msg.send(jid, { quoted: m })
 ```
 
 ---
 
-## 💬 Funções de Chat
-
-### Modificar Chat
+## 9. Grupos
 
 ```js
-// Arquivar conversa
-await sock.chatModify({ archive: true, lastMessages: [mensagem] }, jid)
+// Criar
+const grupo = await sock.groupCreate('Nome', ['5511...@s.whatsapp.net'])
 
-// Marcar como não lida
-await sock.chatModify({ markRead: false, lastMessages: [mensagem] }, jid)
+// Participantes
+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')
+await sock.groupParticipantsUpdate(jid, ['5511...@s.whatsapp.net'], 'demote')
 
-// Mutar por 8 horas
-await sock.chatModify({ mute: 8 * 60 * 60 * 1000 }, jid)
+// Sair
+await sock.groupLeave(jid)
 
-// Desmutar
-await sock.chatModify({ mute: null }, jid)
+// Nome e descrição
+await sock.groupUpdateSubject(jid, 'Novo Nome')
+await sock.groupUpdateDescription(jid, 'Nova descrição')
 
-// Fixar conversa
-await sock.chatModify({ pin: true }, jid)
+// Convite
+const code = await sock.groupInviteCode(jid)
+await sock.groupRevokeInvite(jid)
+await sock.groupAcceptInvite('CODIGO')
 
-// Limpar mensagens
-await sock.chatModify({ clear: { messages: [{ id: 'ID_MSG', fromMe: true }] } }, jid)
+// Mensagens efêmeras (0 = desativar)
+await sock.groupToggleEphemeral(jid, 86400)
 
-// Deletar conversa
-await sock.chatModify({ delete: true, lastMessages: [mensagem] }, jid)
+// Metadata
+const meta   = await sock.groupMetadata(jid)
+const grupos = await sock.groupFetchAllParticipating()
 ```
 
 ---
 
-### Marcar como Lida
+## 10. Perfil e privacidade
 
 ```js
-const key = { remoteJid: jid, id: mensagem.key.id, participant: mensagem.key.participant }
-await sock.readMessages([key])
-```
+// Foto de perfil
+const url = await sock.profilePictureUrl(jid, 'image')
+await sock.updateProfilePicture(jid, buffer)
 
----
+// Bio
+await sock.updateProfileStatus('🤖 Bot ativo')
 
-### Status e Perfil
+// Verificar número
+const [result] = await sock.onWhatsApp('5511999999999')
+// { exists: true, jid: '5511...@s.whatsapp.net' }
 
-```js
-// Ver foto de perfil
-const url = await sock.profilePictureUrl('5511999999999@s.whatsapp.net', 'image')
+// Bloquear / desbloquear
+await sock.updateBlockStatus(jid, 'block')
+await sock.updateBlockStatus(jid, 'unblock')
 
-// Atualizar foto de perfil
-await sock.updateProfilePicture(jid, readFileSync('./nova_foto.jpg'))
+// Presence
+await sock.sendPresenceUpdate('composing', jid)    // digitando
+await sock.sendPresenceUpdate('recording', jid)    // gravando
+await sock.sendPresenceUpdate('available', jid)    // online
+await sock.sendPresenceUpdate('unavailable')        // offline
+await sock.presenceSubscribe(jid)                   // receber presence de contato
 
-// Remover foto de perfil
-await sock.removeProfilePicture(jid)
+// Marcar como lido
+await sock.readMessages([message.key])
 
-// Atualizar status (bio)
-await sock.updateProfileStatus('Desenvolvendo bots 🤖')
+// Privacidade da foto
+await sock.updateProfilePicturePrivacy('all')    // 'all' | 'contacts' | 'none'
 
-// Atualizar nome
-await sock.updateProfileName('Meu Bot')
+// Modificar chat
+await sock.chatModify({ archive: true }, jid)
+await sock.chatModify({ pin: true }, jid)
+await sock.chatModify({ mute: 8 * 60 * 60 * 1000 }, jid)
+await sock.chatModify({ star: { messages: [{ id, fromMe }], star: true } }, jid)
+await sock.chatModify({ clear: { messages: [{ id, fromMe, timestamp }] } }, jid)
 
-// Ver status de outro usuário
-const status = await sock.fetchStatus('5511999999999@s.whatsapp.net')
+// Desconectar
+await sock.logout()
 ```
 
 ---
 
-### Bloquear / Desbloquear
+## 11. Eventos do socket
 
 ```js
-await sock.updateBlockStatus('5511999999999@s.whatsapp.net', 'block')
-await sock.updateBlockStatus('5511999999999@s.whatsapp.net', 'unblock')
+sock.ev.on('messages.upsert',         ({ messages, type }) => {})
+sock.ev.on('messages.update',          (updates) => {})
+sock.ev.on('messages.delete',          (item) => {})
+sock.ev.on('messages.reaction',        (reactions) => {})
+sock.ev.on('presence.update',          ({ id, presences }) => {})
+sock.ev.on('groups.update',            (updates) => {})
+sock.ev.on('group-participants.update', ({ id, participants, action }) => {})
+sock.ev.on('contacts.update',          (contacts) => {})
+sock.ev.on('chats.update',             (chats) => {})
+sock.ev.on('connection.update',        ({ connection, lastDisconnect, qr }) => {})
+sock.ev.on('creds.update',             saveCreds)
 
-// Ver lista de bloqueados
-const bloqueados = await sock.fetchBlocklist()
+// Chamadas
+sock.ev.on('call', (calls) => {
+    for (const call of calls) {
+        if (call.status === 'offer') {
+            sock.rejectCall(call.id, call.from)
+        }
+    }
+})
 ```
 
 ---
 
-### Contatos
+## 12. Utilitários
+
+### Download de mídia
 
 ```js
-// Adicionar ou editar contato
-await sock.addOrEditContact({
-    jid: '5511999999999@s.whatsapp.net',
-    notify: 'João Silva'
-})
+const { downloadMediaMessage } = require('@systemzero/baileys')
 
-// Remover contato
-await sock.removeContact('5511999999999@s.whatsapp.net')
+const buffer = await downloadMediaMessage(message, 'buffer', {})
+const stream = await downloadMediaMessage(message, 'stream', {})
 ```
 
----
-
-## 🔒 Privacidade
+### Download manual por stream
 
 ```js
-// Último visto: 'all' | 'contacts' | 'contact_blacklist' | 'none'
-await sock.updateLastSeenPrivacy('contacts')
-
-// Online: 'all' | 'match_last_seen'
-await sock.updateOnlinePrivacy('all')
-
-// Foto de perfil: 'all' | 'contacts' | 'contact_blacklist' | 'none'
-await sock.updateProfilePicturePrivacy('contacts')
-
-// Status: 'all' | 'contacts' | 'contact_blacklist' | 'none'
-await sock.updateStatusPrivacy('contacts')
-
-// Confirmação de leitura: 'all' | 'none'
-await sock.updateReadReceiptsPrivacy('all')
+const { downloadContentFromMessage } = require('@systemzero/baileys')
 
-// Adição em grupos: 'all' | 'contacts' | 'contact_blacklist' | 'none'
-await sock.updateGroupsAddPrivacy('contacts')
-
-// Chamadas: 'all' | 'contacts' | 'contact_blacklist' | 'none'
-await sock.updateCallPrivacy('contacts')
-
-// Preview de links: 'all' | 'none'
-await sock.updateDisableLinkPreviewsPrivacy('none')
-
-// Modo de desaparecimento padrão
-await sock.updateDefaultDisappearingMode(604800) // 7 dias
+const stream = await downloadContentFromMessage(
+    { mediaKey, directPath, url },
+    'image'   // 'image' | 'video' | 'audio' | 'sticker' | 'document'
+)
+const chunks = []
+for await (const chunk of stream) chunks.push(chunk)
+const buffer = Buffer.concat(chunks)
 ```
 
----
-
-## 🏷️ Labels
+### Geração de mensagem manual
 
 ```js
-// Criar/editar label
-await sock.addLabel({ id: '1', name: 'Cliente VIP', color: 1 })
+const {
+    generateWAMessage,
+    generateWAMessageFromContent,
+    generateMessageIDV2,
+    generateForwardMessageContent
+} = require('@systemzero/baileys')
 
-// Label em chat
-await sock.addChatLabel(jid, '1')
-await sock.removeChatLabel(jid, '1')
+// Com upload automático de mídia
+const msg = await generateWAMessage(jid, { image: buffer }, {
+    upload:    sock.waUploadToServer,
+    userJid:   sock.user.id,
+    messageId: generateMessageIDV2(sock.user.id),
+})
 
-// Label em mensagem
-await sock.addMessageLabel(jid, msgId, '1')
-await sock.removeMessageLabel(jid, msgId, '1')
+// Sem upload (proto manual)
+const msg = generateWAMessageFromContent(jid, { ... }, { quoted: m })
 
-// Favoritar mensagem
-await sock.star(jid, [{ id: msgId, fromMe: true }], true)
+// Enviar o proto
+await sock.relayMessage(jid, msg.message, { messageId: msg.key.id })
 ```
 
----
-
-## 📡 Presença
+### Detectar dispositivo
 
 ```js
-// Tipos: 'available' | 'unavailable' | 'composing' | 'recording' | 'paused'
-await sock.sendPresenceUpdate('composing', jid)   // "digitando..."
-await sock.sendPresenceUpdate('recording', jid)   // "gravando áudio..."
-await sock.sendPresenceUpdate('available', jid)   // Online
-await sock.sendPresenceUpdate('unavailable', jid) // Offline
-
-// Inscrever-se na presença de alguém
-await sock.presenceSubscribe(jid)
-
-// Ouvir updates de presença
-sock.ev.on('presence.update', ({ id, presences }) => {
-    console.log(presences)
-})
+const { getDevice } = require('@systemzero/baileys')
+const device = getDevice(message.key.id)
+// 'android' | 'ios' | 'web' | 'unknown'
 ```
 
----
+### JID utils
 
-## 📌 Notas
+```js
+const {
+    jidNormalizedUser,
+    isJidGroup,
+    isJidNewsletter,
+    jidEncode,
+    jidDecode
+} = require('@systemzero/baileys')
 
-- Todas as funções que enviam mensagens retornam o objeto `WAMessage` com a `key` da mensagem.
-- O campo `key.id` pode ser usado para referenciar a mensagem em edições, deleções e fixações.
-- Ao enviar mídia para grupos, certifique-se que o bot está participante do grupo.
-- Funções Rich (`sendRich*`) requerem que o WhatsApp do destinatário seja uma versão recente.
+jidNormalizedUser('5511999999999@s.whatsapp.net')
+isJidGroup('120363...@g.us')            // true
+isJidNewsletter('120363...@newsletter') // true
+```
 
 ---
 
 <div align="center">
 
-**@systemzero/baileys v1.0.3** · Feito com ❤️ por [blackhzx](https://t.me/blackhzx)
+**@systemzero/baileys v1.0.5**
+
+Desenvolvido por [Josué </>](https://t.me/blackhzx) · [Canal WhatsApp](https://whatsapp.com/channel/0029VaqUb9aGk1FxqeKKOd2i) · [systemzone.store](https://systemzone.store)
 
-</div>
+</div>