WhatsApp

Roteador para WhatsApp: histórico/pesquisa/leitura/envio; wacrawl leitura, wacli ao vivo.

O que é WhatsApp?

Esta habilidade é um roteador centralizado para tarefas do WhatsApp, projetado para agentes de IA que precisam interagir com o WhatsApp de forma segura e eficiente. Ela opera duas ferramentas distintas: `wacrawl` para acesso apenas de leitura ao arquivo do WhatsApp Desktop (ideal para histórico e pesquisa offline) e `wacli` para contas de dispositivos vinculados, permitindo ações ao vivo como envio, sincronização e consultas de protocolo. A habilidade prioriza a segurança, exigindo intenção explícita do usuário antes de qualquer mutação (envio, reação, arquivamento) e oferecendo modos de inspeção apenas de leitura. Suporta contas alternativas (ex.: `me`, `molty`) e mantém uma separação clara entre fontes de dados, comparando contagens e sobreposições para garantir consistência. Comandos comuns incluem verificação de frescor, busca de mensagens, gerenciamento de contas e sincronização ao vivo, sempre com a orientação de usar `wacrawl` para histórico primário e `wacli` para interações ao vivo e autorizadas.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/steipete/agent-scripts/tree/main/skills/whatsapp

Installed? Explore more Produtividade e Colaboração skills: steipete/gemini, steipete/gh-issues, steipete/skill-creator · View all 6 →

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

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; execute wacrawl sync quando solicitado ou quando dados atuais forem importantes.
  • Contas alternativas como me, molty ou armazenamentos nomeados: use wacli --account NOME.
  • Envio, reações, presença, arquivar/ fixar/ silenciar/ marcar como lido, mutações de grupos/canais: use wacli apenas após intenção explícita do usuário.
  • Comparando cobertura entre fontes: trate wacrawl como a verdade do arquivo Desktop para histórico primário, e wacli como 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 wacli somente leitura para inspeção: use --read-only ou defina WACLI_READONLY=1.
  • Não escreva dentro do contêiner do aplicativo WhatsApp Desktop.
  • Não edite session.db do wacli diretamente.
  • Mantenha contas nomeadas do wacli isoladas; 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_id quando 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/wacrawl e ~/Projects/agent-scripts/skills/wacli.

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

steipete/agent-transcript

GitHub PR/issue agent transcripts: redact, preview, and insert safely.

steipete/beeper

Beeper cache: contact hints, room lookup, WhatsApp/iMessage traces, FTS.

steipete/browser-use

Existing Chrome automation: Chrome plugin first, mcporter fallback.

steipete/clawsweeper-status

ClawSweeper status: URLs, workflow health, active workers, ops snapshot.

steipete/clickclack

ClickClack ops: chat app, Hetzner deploy, DNS/docs/app, Docker rollout.

steipete/cloudflare-registrar

Cloudflare Registrar: domain availability, prices, registration via mcporter.

steipete/codex-debugging

Codex debugging: codex-rs core/tui/exec/cli/app-server/config.

steipete/create-cli

CLI UX/spec: args, flags, help, output, errors, config, dry-run.

steipete/discord-clawd

Discord-backed OpenClaw agent/session relay; not archive search.

steipete/domain-dns-ops

DNS/domain ops: registrars, zones, redirects, DNS/HTTP verify, manager truth.

steipete/frontend-design

Frontend UI: pages, apps, components, polished non-generic design.

steipete/github-author-context

GitHub contributor context: identity, activity, trust, company/team signal.

steipete/github-cache-hygiene

GitHub quota/cache hygiene: gh, ghx, xcache, gitcrawl, mirrors, limits.

steipete/github-deep-review

GitHub deep review: bugs, PRs, best fix, stale-or-real, read code first.

steipete/github-project-triage

GitHub issue/PR triage: queues, CI, blockers, risk, proof, next actions.

steipete/hopper-debugger

Hopper debugging: macOS/iOS binaries, ObjC/Swift symbols, dyld, LLDB.

steipete/instruments-profiling

Instruments/xctrace profiling: macOS/iOS traces, binaries, args, exports.

steipete/mac-maintenance

Mac upkeep: brew update/upgrade, pull clean repos, empty Trash.

steipete/maintainer-orchestrator

Open-source maintainer orchestration: Codex app workers, work recovery, dependencies, vision, releases.

steipete/markdown-converter

Markdown conversion: PDF, Office, HTML, data, OCR, audio, ZIP, YouTube.

Habilidades Relacionadas