¿Qué hace whatsapp?
Utiliza esto como primera parada para trabajo con WhatsApp. Mantén clara la separación de fuentes:
wacrawl: archivo principal de WhatsApp Desktop. Solo lectura, mejor historial local, sin red, sin envío.wacli: cuentas de dispositivo vinculado. Úsalo para cuentas alternativas, sincronización en vivo, autenticación, envío, mutaciones de chats/grupos y preguntas sobre el protocolo de WhatsApp Web.
Si el usuario menciona trabajo específico con los repositorios wacrawl o wacli, lee también la habilidad propia de esa herramienta.
Enrutamiento
- Lecturas/búsquedas/historial principal de WhatsApp: usa
wacrawl. - Conteos de leídos/no leídos de WhatsApp Desktop: usa
wacrawl; tiene conteos de no leídos a nivel de chat, no estado de lectura por mensaje. - Lecturas principales sensibles a frescura: verifica
wacrawl status; ejecutawacrawl synccuando se solicite o cuando los datos actuales importen. - Cuentas alternativas como
me,moltyo almacenes nombrados: usawacli --account NOMBRE. - Envío, reacciones, presencia, archivar/fijar/silenciar/marcar como leído, mutaciones de grupos/canales: usa
waclisolo después de una intención explícita del usuario. - Comparación de cobertura entre fuentes: trata
wacrawlcomo la verdad del archivo de escritorio para el historial principal, ywaclicomo cobertura de dispositivo vinculado/en vivo con límites de protocolo.
Seguridad
- Nunca envíes ni mutes el estado de WhatsApp a menos que se solicite explícitamente.
- Prefiere comandos de solo lectura de
waclipara inspección: pasa--read-onlyo estableceWACLI_READONLY=1. - No escribas dentro del contenedor de la aplicación de WhatsApp Desktop.
- No edites
session.dbdewaclidirectamente. - Mantén las cuentas nombradas de
wacliaisladas; no combines almacenes. - Reporta frescura de la fuente, nombre de la cuenta y brechas conocidas al responder desde almacenes locales.
Comandos Comunes
Archivo Principal
Frescura y estado:
wacrawl status
wacrawl doctor
wacrawl sync
Triaje de no leídos:
wacrawl chats --limit 20
wacrawl unread --limit 20
wacrawl --json unread --limit 100
Buscar y segmentar mensajes:
wacrawl messages --after 2026-01-01 --limit 50
wacrawl messages --chat JID --asc --limit 100
wacrawl messages --has-media --limit 50
wacrawl --json search "consulta"
wacrawl search "consulta" --after 2026-01-01 --from-them
Archivar medios o copias de seguridad, solo cuando se solicite:
wacrawl import --copy-media
wacrawl backup status
wacrawl --sync never backup push
Cuentas Alternativas/En Vivo
Descubrimiento de cuentas e inspección de solo lectura:
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 "consulta"
Sincronización en vivo en segundo plano, solo cuando se solicite. Prefiere tmux para modo de seguimiento:
wacli --account me sync --follow --events
wacli --account me sync --once --events
Medios, envío y mutaciones en vivo, solo cuando se solicite explícitamente:
wacli --account me media download --chat JID --id ID_MENSAJE
wacli --account me send text --to JID_O_NOMBRE --message "mensaje"
wacli --account me send file --to JID_O_NOMBRE --file ./archivo.jpg --caption "título"
wacli --account me send text --to JID --reply-to ID_MENSAJE --message "respuesta"
Comparaciones
Al comparar wacrawl y wacli, compara ambos conteos y superposición:
- conteos de mensajes y rangos de fechas
- conteos de chats
- marca de tiempo del mensaje más reciente
- superposición por
msg_id - superposición por
chat_jid + msg_idcuando los JIDs están suficientemente normalizados - brechas obvias explicadas por límites de historial de dispositivo vinculado frente a cobertura del archivo de escritorio
Referencias a Repositorios
~/Projects/wacrawl: importador/búsqueda/copia de seguridad del archivo de escritorio.~/Projects/wacli: cliente/sincronización/envío de dispositivo vinculado.- Copias globales de habilidades:
~/Projects/agent-scripts/skills/wacrawly~/Projects/agent-scripts/skills/wacli.