O que WhatsApp faz?
Use isto como primeira parada para trabalhos com WhatsApp. Mantenha a fronteira entre as fontes bem definida:
wacrawl: arquivo primário do WhatsApp Desktop. Somente leitura, melhor histórico local, sem rede, sem envio.wacli: contas de dispositivos vinculados. Use para contas alternativas, sincronização ao vivo, autenticação, envio, mutação de chats/grupos e perguntas sobre o protocolo do WhatsApp Web.
Se o usuário mencionar trabalho específico nos repositórios wacrawl ou wacli, leia também a habilidade dessa ferramenta.
Roteamento
- Leituras/pesquisas/histórico primários do WhatsApp: use
wacrawl. - Contagens de lidos/não lidos do WhatsApp Desktop: use
wacrawl; ele tem contagens de não lidos por chat, não estado de leitura por mensagem. - Leituras primárias sensíveis a frescor: verifique
wacrawl status; executewacrawl syncquando solicitado ou quando dados atuais forem importantes. - Contas alternativas como
me,moltyou armazenamentos nomeados: usewacli --account NOME. - Envio, reações, presença, arquivar/ fixar/ silenciar/ marcar como lido, mutações de grupos/canais: use
wacliapenas após intenção explícita do usuário. - Comparando cobertura entre fontes: trate
wacrawlcomo a verdade do arquivo Desktop para histórico primário, ewaclicomo cobertura ao vivo/vinculada com limites de protocolo.
Segurança
- Nunca envie ou mude o estado do WhatsApp a menos que explicitamente solicitado.
- Prefira comandos
waclisomente leitura para inspeção: use--read-onlyou definaWACLI_READONLY=1. - Não escreva dentro do contêiner do aplicativo WhatsApp Desktop.
- Não edite
session.dbdowaclidiretamente. - Mantenha contas nomeadas do
wacliisoladas; não mescle armazenamentos. - Relate frescor da fonte, nome da conta e lacunas conhecidas ao responder a partir de armazenamentos locais.
Comandos Comuns
Arquivo Primário
Frescor e status:
wacrawl status
wacrawl doctor
wacrawl sync
Triagem de não lidos:
wacrawl chats --limit 20
wacrawl unread --limit 20
wacrawl --json unread --limit 100
Pesquisar e fatiar mensagens:
wacrawl messages --after 2026-01-01 --limit 50
wacrawl messages --chat JID --asc --limit 100
wacrawl messages --has-media --limit 50
wacrawl --json search "query"
wacrawl search "query" --after 2026-01-01 --from-them
Mídia do arquivo ou backups, apenas quando solicitado:
wacrawl import --copy-media
wacrawl backup status
wacrawl --sync never backup push
Contas Alternativas/Ao Vivo
Descoberta de conta e inspeção somente leitura:
wacli accounts list --json
wacli --account me auth status --read-only --json
wacli --account me chats list --read-only --json
wacli --account me messages list --read-only --json --limit 50
wacli --account me messages search --read-only --json "query"
Sincronização ao vivo em segundo plano, apenas quando solicitado. Prefira tmux para modo de acompanhamento:
wacli --account me sync --follow --events
wacli --account me sync --once --events
Mídia, envio e mutações ao vivo, apenas quando explicitamente solicitado:
wacli --account me media download --chat JID --id MESSAGE_ID
wacli --account me send text --to JID_OR_NAME --message "mensagem"
wacli --account me send file --to JID_OR_NAME --file ./arquivo.jpg --caption "legenda"
wacli --account me send text --to JID --reply-to MESSAGE_ID --message "resposta"
Comparações
Ao comparar wacrawl e wacli, compare ambas as contagens e a sobreposição:
- contagens de mensagens e intervalos de data
- contagens de chats
- timestamp da mensagem mais recente
- sobreposição por
msg_id - sobreposição por
chat_jid + msg_idquando os JIDs estão suficientemente normalizados - lacunas óbvias explicadas pelos limites de histórico de dispositivos vinculados vs. cobertura do arquivo Desktop
Apontadores de Repositórios
~/Projects/wacrawl: importador/pesquisa/backup de arquivo Desktop.~/Projects/wacli: cliente/sincronização/envio de dispositivo vinculado.- Cópias globais de habilidades:
~/Projects/agent-scripts/skills/wacrawle~/Projects/agent-scripts/skills/wacli.