Importar WhatsApp — Manual Expedição Glider Brasil

O que é

A funcionalidade de Importação de WhatsApp permite que administradores importem o histórico de mensagens do grupo de WhatsApp da expedição diretamente para o app Expedição Glider Brasil. O objetivo é preservar as discussões, decisões e informações trocadas no WhatsApp dentro do ambiente organizado do app, onde todos podem consultá-las offline.

O processo usa uma Cloud Function TypeScript no Firebase que processa o arquivo de exportação do WhatsApp (.txt), analisa cada mensagem, identifica o autor, a data e o conteúdo, e armazena tudo no Firestore em uma subcoleção de mensagens importadas. As mensagens ficam disponíveis para consulta offline por todos os participantes, organizadas por data e autor.

A importação suporta mensagens de texto e indicadores de mídia (imagem omitida, vídeo omitido) — mídias em si não são importadas, pois o arquivo de exportação do WhatsApp sem mídia não as inclui. Mensagens do sistema (entradas/saídas do grupo) são filtradas automaticamente e não são importadas.

Privacidade: antes de importar, certifique-se de que todos os membros do grupo estão cientes de que as mensagens serão importadas para o app. A importação inclui mensagens de todos os participantes do grupo, não apenas dos membros da expedição que têm conta no app.

Exportar do WhatsApp

O primeiro passo é exportar o histórico do grupo WhatsApp da expedição. O processo é diferente no Android e iOS:

No Android:

Abra o WhatsApp e acesse o grupo da expedição.
Toque nos três pontos (⋮) no canto superior direito.
Selecione Mais → Exportar conversa.
Quando perguntado sobre mídias, selecione "Sem mídia" (recomendado — mais rápido e menor tamanho de arquivo).
Escolha como compartilhar o arquivo: use Google Drive, e-mail ou qualquer app de transferência para enviar o arquivo para o dispositivo onde o app está instalado.
O arquivo gerado será um .zip contendo um arquivo .txt com todo o histórico.

No iOS (iPhone):

Abra o WhatsApp e acesse o grupo da expedição.
Toque no nome do grupo no topo para abrir as informações.
Role até o final e toque em "Exportar conversa".
Selecione "Sem mídia".
Compartilhe o arquivo via AirDrop, iCloud Drive, e-mail ou outro método para ter o arquivo acessível.

Dica: para grupos muito ativos com anos de histórico, o arquivo .txt pode ter vários MB. Exporte apenas o período relevante (últimos 6-12 meses) para um arquivo menor e importação mais rápida.

Importar no app

Com o arquivo .txt do WhatsApp disponível no dispositivo, siga os passos abaixo para importá-lo no app:

No app Expedição Glider, acesse o Painel Admin pelo menu lateral.
Na aba Conteúdo, toque em "Importar WhatsApp".
Toque em "Selecionar arquivo" e navegue até o arquivo .txt exportado. Se o arquivo estiver em um .zip, extraia o .txt antes.
O app fará uma análise prévia do arquivo: exibe quantas mensagens encontrou, o período coberto (data da primeira e última mensagem) e uma lista dos autores detectados.
Verifique se a análise prévia está correta. Se o número de mensagens parecer muito baixo, verifique se o arquivo está completo.
Prossiga para a etapa de mapeamento de autores (seção abaixo).
Após confirmar o mapeamento, toque em "Iniciar importação".
Aguarde o processamento — a Cloud Function pode levar 1 a 5 minutos dependendo do tamanho do arquivo.
Ao concluir, um relatório exibe: mensagens importadas, ignoradas, autores mapeados e eventuais erros.

Processamento na nuvem: o arquivo é enviado para a Cloud Function TypeScript no Firebase para processamento. O app não processa o arquivo localmente — é necessária conexão com a internet para realizar a importação.

Mapeamento de autores

Uma das etapas mais importantes da importação é o mapeamento de autores. No arquivo de exportação do WhatsApp, cada mensagem é identificada pelo nome salvo no contato do exportador — que pode ser diferente do nome real ou do nome cadastrado no app.

O app extrai automaticamente todos os nomes únicos encontrados no arquivo e exibe uma tela de mapeamento onde o admin associa cada nome do WhatsApp ao perfil correspondente no app:

Para cada nome do WhatsApp exibido, toque no campo ao lado para buscar o piloto correspondente no app.
Digite as primeiras letras do nome do piloto para filtrar a lista.
Selecione o piloto correto. O mapeamento é salvo.
Para nomes que não correspondem a nenhum piloto (ex: participantes do WhatsApp que não estão no app), selecione "Não mapear" — as mensagens desse autor serão importadas com o nome original do WhatsApp.
Para excluir completamente as mensagens de um autor da importação, selecione "Ignorar este autor".
Após mapear todos os autores, toque em "Confirmar mapeamento" e prossiga.

O mapeamento é salvo no Firebase e reutilizado em importações futuras — se você importar um arquivo mais recente do mesmo grupo, os autores já mapeados anteriormente são automaticamente reconhecidos.

Dica: dedique tempo nesta etapa. Um mapeamento correto garante que as mensagens apareçam com o nome e avatar corretos dos pilotos no histórico importado.

Resultado da importação

Após a conclusão da importação, as mensagens ficam disponíveis em uma seção especial chamada "Histórico WhatsApp", acessível pela tela de Notícias ou pelo menu lateral. A visualização é similar a um chat: mensagens em ordem cronológica, com avatar do autor, nome, data e hora.

Importações repetidas do mesmo grupo são tratadas de forma incremental — o app detecta mensagens já importadas (por hash de conteúdo) e não as duplica. Só mensagens novas são adicionadas em cada reimportação, tornando seguro fazer importações periódicas para manter o histórico atualizado.

O relatório final da importação exibe: total de mensagens no arquivo, mensagens importadas com sucesso, mensagens duplicadas ignoradas, mensagens de sistema filtradas, autores mapeados para perfis do app e autores com nome original mantido.

Subcoleção no Firestore: as mensagens importadas são armazenadas em uma subcoleção separada (imported_messages) e não se misturam com outros conteúdos do app. Elas podem ser excluídas completamente sem afetar outros dados.

Problemas comuns

O app não reconhece o arquivo selecionado.
Certifique-se de selecionar o arquivo .txt e não o .zip. Se você recebeu um arquivo .zip, extraia-o primeiro. O arquivo .txt deve estar no formato padrão de exportação do WhatsApp (ex: WhatsApp Chat - Expedição Glider.txt).

A análise prévia mostra 0 mensagens.
O formato do arquivo pode estar incorreto. O WhatsApp usa formatos diferentes de data dependendo do idioma e região do celular (DD/MM/AAAA vs MM/DD/AAAA). O app tenta detectar automaticamente o formato, mas pode falhar com formatos incomuns. Verifique se o arquivo de texto contém linhas no padrão: [DD/MM/AAAA, HH:MM:SS] Autor: mensagem ou DD/MM/AAAA HH:MM - Autor: mensagem.

A Cloud Function demorou mais de 10 minutos e não retornou resultado.
Cloud Functions têm um timeout máximo de 9 minutos. Arquivos muito grandes (grupos ativos por anos) podem ultrapassar este limite. Tente exportar apenas os últimos 6 meses do grupo e importar em partes menores. O app detecta duplicatas e não reimportará mensagens já processadas.

As mensagens importadas aparecem sem avatar ou com nome errado.
Reveja o mapeamento de autores na tela de configurações da importação. Acesse Painel Admin → Conteúdo → Histórico WhatsApp → Gerenciar Mapeamento para corrigir associações incorretas. As mensagens já importadas são atualizadas automaticamente após corrigir o mapeamento.

Atenção: não é possível reverter uma importação de forma automática após a confirmação. Se precisar remover um lote importado, acesse Painel Admin → Conteúdo → Histórico WhatsApp → Excluir importação e selecione o lote pelo período.