📚 Navegação

Documentação Completa

🚀 Introdução

O Telegram + WhatsApp Monitor é um sistema completo que permite monitorar grupos e canais do Telegram e integrá-los com o WhatsApp, criando uma ponte de comunicação entre as duas plataformas.

Principais funcionalidades:

  • 📱 Monitoramento em tempo real de grupos/canais Telegram
  • 🤖 Gerenciamento de múltiplos bots WhatsApp
  • 🔗 Vinculação automática entre chats Telegram e WhatsApp
  • 🌐 Interface web moderna para administração
  • 📊 Dashboard com estatísticas em tempo real

📦 Instalação

Pré-requisitos

  • Node.js (v16 ou superior)
  • NPM ou Yarn
  • Token de bot do Telegram
  • Números de WhatsApp para os bots

Instalação Rápida

# 1. Clonar o repositório
git clone <url-do-repositorio>
cd telegram-wpp

# 2. Instalar dependências
PUPPETEER_SKIP_DOWNLOAD=true npm install --no-bin-links

# 3. Configurar variáveis de ambiente
cp .env.example .env

# 4. Iniciar o sistema
npm start

⚙️ Configuração

Arquivo .env

# Token do bot do Telegram (obrigatório)
TELEGRAM_BOT_TOKEN=seu_token_aqui

# IDs dos chats para monitorar (separados por vírgula)
MONITORED_CHATS=-1002749422156,-1001987654321

# Porta do servidor (opcional, padrão: 3030)
PORT=3030

# Modo debug (opcional, padrão: false)
DEBUG=false

Obtendo Token do Telegram

  1. Abra o Telegram e procure por @BotFather
  2. Envie /newbot e siga as instruções
  3. Copie o token fornecido para o arquivo .env

Obtendo IDs dos Chats

  1. Adicione o bot ao grupo/canal
  2. Envie /get_chat_id no chat
  3. Adicione o ID retornado no arquivo .env

🤖 Comandos do Telegram

Comando Descrição Exemplo
/get_chat_id Obtém ID do chat atual /get_chat_id
/status Mostra status e estatísticas /status
/link Ajuda sobre vinculação /link
/link [bot] [numero] [tipo] Cria link Telegram → WhatsApp /link 1 5511999999999 contact
/links Lista links ativos /links
/unlink [numero] Remove link específico /unlink 5511999999999
/clear [numero] Limpa mensagens (admins) /clear 100

📱 Bots WhatsApp

Criando um Bot

  1. Acesse http://localhost:3030/bots
  2. Clique em "Adicionar Novo Bot"
  3. Insira nome e número (formato: 5511999999999)
  4. Clique em "Criar Bot"

Conectando ao WhatsApp

  1. Clique em "Iniciar" no bot criado
  2. Escaneie o QR Code com o WhatsApp
  3. Aguarde a confirmação de conexão

Estados dos Bots

  • connected - Bot conectado e funcional
  • waiting_qr - Aguardando escaneamento do QR Code
  • disconnected - Bot desconectado
  • auth_failed - Falha na autenticação

🔗 Vinculação de Chats

Via Comando Telegram

# Sintaxe básica
/link [bot_id] [numero_whatsapp] [tipo]

# Exemplos
/link 1 5511999999999 contact      # Vincular a contato
/link 1 5511999999999-1234567890@g.us group  # Vincular a grupo

Via Interface Web

  1. Acesse a página de bots
  2. Clique em "Novo Link"
  3. Selecione o bot e configure o destino
  4. Clique em "Criar Link"

Fluxo de Integração

📱 Mensagem Telegram → 🔍 Verifica Links → 📲 Encaminha WhatsApp → 🌐 Feed Unificado

🔌 API REST

Endpoints Principais

Bots

GET /api/bots - Lista todos os bots
POST /api/bots - Cria novo bot
POST /api/bots/:id/start - Inicia bot
DELETE /api/bots/:id - Remove bot

Links

GET /api/links - Lista todos os links
POST /api/links - Cria novo link
DELETE /api/links/:id - Remove link

Dados

GET /api/messages - Obtém mensagens
GET /api/stats - Estatísticas do sistema

🛠️ Troubleshooting

Problemas Comuns

❌ Erro: "operation not permitted"

Use: PUPPETEER_SKIP_DOWNLOAD=true npm install --no-bin-links

⚠️ Bot WhatsApp não conecta

  • Verifique se o QR Code foi escaneado
  • Reinicie o bot via interface web
  • Verifique se o número não está sendo usado em outro dispositivo

ℹ️ Mensagens não aparecem no feed

  • Confirme se o chat ID está configurado no .env
  • Verifique se o bot tem permissões de leitura
  • Teste a conexão WebSocket no console do navegador

⚠️ Links não funcionam

  • Verifique se o bot WhatsApp está online
  • Confirme o formato do número (5511999999999)
  • Use /links para verificar configuração

Logs e Debug

Para ativar logs detalhados, configure DEBUG=true no arquivo .env e reinicie o sistema.

Suporte

Para mais ajuda:

  1. Verifique os logs com DEBUG=true
  2. Consulte o arquivo COMANDOS_BOT.md
  3. Acesse a interface /settings para diagnósticos
  4. Abra uma issue no repositório do projeto

🎉 Sistema Completo de Integração

Desenvolvido com ❤️ para conectar Telegram e WhatsApp de forma eficiente e moderna.