Home

Zyra Wiki

Bem-vindo à Wiki do Zyra.

O Zyra é um bot para WhatsApp focado em automação, moderação, observabilidade e persistência de dados.
Ele usa Baileys como base de conexão com o WhatsApp e oferece uma arquitetura pronta para crescer com comandos, eventos e integrações.

O que é o projeto

O Zyra é uma aplicação Node.js/TypeScript que:

• conecta sessões WhatsApp com suporte a multi-dispositivo
• processa eventos em tempo real (mensagens, grupos, reações, mídia, etc.)
• persiste dados em MySQL e Redis (com fallback local)
• disponibiliza estrutura de comandos para funcionalidades de bot
• inclui mecanismos de estabilidade operacional (logs, reconexão, backfill, PM2)

Para que pode ser usado

Você pode usar o Zyra para:

• Atendimento e automação: respostas automáticas, comandos utilitários, fluxos internos
• Moderação de grupos: anti-link, controle de participantes, ações administrativas
• Observabilidade e auditoria: trilha de eventos, histórico de mensagens, diagnóstico
• Inteligência operacional: base de dados para métricas, relatórios e análise de uso
• Plataforma de extensão: criação de novos comandos e integrações customizadas

Principais recursos

• Comandos modulares (fácil de manter e expandir)
• Persistência SQL robusta (mensagens, mídia, eventos, usuários, grupos)
• Cache e aceleração com Redis
• Backfill para completar e normalizar dados históricos
• Download e gestão de mídia local com metadados
• Execução em produção com PM2

Arquitetura (visão rápida)

• src/events → assinatura e tratamento dos eventos do WhatsApp
• src/router / src/commands → roteamento e execução de comandos
• src/store → persistência (SQL/Redis/cache)
• src/core → runtime, conexão, banco e infraestrutura
• docs → modelo de banco e documentação auxiliar

Requisitos

• Node.js (LTS)
• MySQL 8+
• Redis (opcional, recomendado)
• PM2 (opcional, recomendado para produção)

Começando

1. Configurar variáveis de ambiente (.env)
2. Inicializar schema: npm run db:init
3. Rodar em dev: npm run dev
4. Produção com PM2: npm run pm2:start

Status da Wiki

Esta é a página inicial e será expandida com:

• instalação detalhada
• configuração de ambiente
• guia de comandos
• modelagem de banco
• operação em produção
• troubleshooting