WhatsApp History Export

Exporte seu historico COMPLETO do WhatsApp - incluindo conversas de 10+ anos

Sobre • Por que usar • Metodos • Inicio Rapido • FAQ • Contribuir

---

Sobre

O WhatsApp History Export e um guia completo para exportar seu historico de conversas do WhatsApp, incluindo mensagens muito antigas que o export nativo nao consegue recuperar.

O Problema

• O export nativo do WhatsApp e limitado (maximo ~40.000 mensagens por chat)
• Conversas anteriores a 2016 frequentemente nao aparecem no export
• Midias antigas (fotos, videos, audios) se perdem
• Backup do Google Drive/iCloud nao permite acesso direto aos dados

A Solucao

Este repositorio oferece 3 metodos progressivos para exportar seu historico:

Metodo	Dificuldade	Recupera Historico Antigo	Requer Root/Jailbreak
Export Nativo	Facil	Nao	Nao
Backup Local	Medio	Parcial	Nao
Database Extraction	Avancado	Sim, completo	Nao

---

Por que usar

Casos de Uso

• Memorias familiares - Conversas com pessoas que ja se foram
• Evidencias legais - Processos que requerem historico completo
• Migracao de dispositivo - Trocar de Android para iPhone (ou vice-versa)
• Backup permanente - Ter seus dados em formato aberto (HTML/JSON)
• Analise de dados - Pesquisadores e jornalistas

Diferenciais deste Guia

• Tutorial 100% em Portugues (PT-BR)
• Passo a passo visual com screenshots e GIFs
• Scripts automatizados para cada etapa
• Suporte a historicos muito antigos (2009+)
• Sem root/jailbreak necessario
• Funciona com criptografia mais recente (crypt14, crypt15)

---

Metodos

Metodo 1: Export Nativo

Dificuldade: Facil | Tempo: 5 minutos | Limitacao: ~40k mensagens

O metodo oficial do WhatsApp. Util para conversas recentes e pequenas.

Ver tutorial completo

WhatsApp > Conversa > Menu (3 pontos) > Mais > Exportar conversa

Limitacoes:

• Maximo ~40.000 mensagens por conversa
• Midias opcionais (aumenta muito o tamanho)
• Nao exporta mensagens apagadas
• Formato .txt simples

---

Metodo 2: Backup Local (Android)

Dificuldade: Medio | Tempo: 30 minutos | Limitacao: Backup atual apenas

Extrai o backup local do Android sem precisar de root.

Ver tutorial completo

Requisitos:

• Computador com Windows/Mac/Linux
• Cabo USB
• ADB instalado (incluso neste repo)
• Depuracao USB ativada no celular

O que recupera:

• Todas as conversas do backup atual
• Midias em tamanho original
• Formato HTML navegavel

---

Metodo 3: Database Extraction (Completo)

Dificuldade: Avancado | Tempo: 1-2 horas | Limitacao: Nenhuma

O metodo mais completo. Extrai o banco de dados criptografado e descriptografa localmente.

Ver tutorial completo

Requisitos:

• Computador com Windows/Mac/Linux
• Cabo USB
• ADB + scrcpy (inclusos neste repo)
• Python 3.8+
• WhatsApp instalado no celular

O que recupera:

• TODO o historico desde a criacao da conta
• Mensagens apagadas (se ainda no banco)
• Midias em qualidade original
• Metadados completos (horarios exatos, status de leitura)

---

Inicio Rapido

1. Clone o repositorio

git clone https://github.com/raphaelmarra/whatsapp-history-export.git
cd whatsapp-history-export

2. Instale as dependencias

# Windows
.\scripts\setup-windows.bat

# Linux/Mac
chmod +x scripts/setup-unix.sh && ./scripts/setup-unix.sh

3. Escolha seu metodo

• Conversas pequenas/recentes → Metodo 1
• Backup completo atual → Metodo 2
• Historico completo desde sempre → Metodo 3

---

Ferramentas Incluidas

Ferramenta	Versao	Descricao
ADB	Latest	Android Debug Bridge - comunicacao com Android
scrcpy	2.x	Espelhamento de tela Android no PC
WhatsApp-Chat-Exporter	0.12+	Parser de banco de dados WhatsApp
wa-crypt-tools	Latest	Descriptografia de backups crypt14/15

---

Estrutura do Projeto

whatsapp-history-export/
├── README.md                 # Voce esta aqui
├── LICENSE                   # MIT License
├── CONTRIBUTING.md           # Guia de contribuicao
├── SECURITY.md               # Politica de seguranca
│
├── docs/                     # Documentacao detalhada
│   ├── METODO-1-EXPORT-NATIVO.md
│   ├── METODO-2-BACKUP-LOCAL.md
│   ├── METODO-3-DATABASE-EXTRACTION.md
│   ├── TROUBLESHOOTING.md
│   └── FAQ.md
│
├── tools/                    # Ferramentas necessarias
│   ├── adb/                  # Android Debug Bridge
│   ├── scrcpy/               # Screen Copy
│   └── scripts/              # Scripts de automacao
│
├── examples/                 # Exemplos de output
│   ├── android/
│   └── ios/
│
├── assets/                   # Imagens e diagramas
│   ├── screenshots/
│   └── diagrams/
│
└── .github/                  # GitHub configs
    ├── ISSUE_TEMPLATE/
    └── workflows/

---

FAQ

Isso e legal?

Sim. Voce esta exportando seus proprios dados. O WhatsApp pertence a voce, nao a Meta. A LGPD (Brasil) e GDPR (Europa) garantem seu direito de acesso aos proprios dados.

Funciona com WhatsApp Business?

Sim, todos os metodos funcionam com WhatsApp Business.

Preciso de root/jailbreak?

Nao. Nenhum dos metodos requer root (Android) ou jailbreak (iOS).

Meu backup esta criptografado, e agora?

O Metodo 3 inclui ferramentas para descriptografar backups crypt12, crypt14 e crypt15 (os mais recentes).

Posso migrar de Android para iPhone?

Sim! Exporte usando este guia e importe no novo dispositivo. Veja MIGRACAO.md.

---

Contribuir

Contribuicoes sao bem-vindas! Veja CONTRIBUTING.md para detalhes.

Formas de Contribuir

• Reportar bugs ou problemas
• Sugerir novos recursos
• Melhorar documentacao
• Traduzir para outros idiomas
• Compartilhar o projeto

---

Avisos Legais

• Este projeto nao e afiliado ao WhatsApp ou Meta
• Use apenas para seus proprios dados
• Nao utilize para acessar dados de terceiros sem autorizacao
• Os autores nao se responsabilizam por uso indevido

---

Agradecimentos

• KnugiHK/WhatsApp-Chat-Exporter - Parser de referencia
• YuvrajRaghuvanshiS/WhatsApp-Key-Database-Extractor - Extracao de chaves
• Comunidade open-source brasileira

---

Licenca

Distribuido sob a licenca MIT. Veja LICENSE para mais informacoes.

---

Se este projeto te ajudou, deixe uma estrela!