Gmail Label Routing

Gmail Label Routing

Overview

Estandarizar cambios de etiquetas por remitente en Gmail con un flujo único y consistente. Priorizar el script local para evitar inconsistencias manuales entre filtro, retroaplicación y estado de INBOX.

Workflow

1. Confirmar intención del usuario:

• Etiqueta destino
• Uno o varios remitentes
• Si debe salir de INBOX (default: sí)
• Si debe reemplazar filtros existentes del remitente (solo cuando lo pida o haya conflictos)

2. Ejecutar el workflow:

python3 scripts/gws_gmail_label_workflow.py \
  --label "<Etiqueta>" \
  --sender "correo1@dominio.com" \
  --sender "correo2@dominio.com"

scripts/gws_gmail_label_workflow.py es ruta relativa al directorio de esta skill.

3. Variantes comunes:

• Mantener en INBOX: --keep-inbox
• Reemplazar filtros del remitente: --replace-sender-filters
• Simular sin cambios: --dry-run

4. Confirmar resultado con el JSON final del script:

• createdFilterId
• retroApplied
• withLabelCount
• inboxCount

Rules

• Repetir --sender por cada remitente.
• Mantener comillas en etiqueta y remitentes para evitar errores de parsing.
• Usar --replace-sender-filters cuando haya mezcla por reglas duplicadas para el mismo remitente.
• Si el usuario dice “haz lo mismo”, repetir el mismo patrón usado: etiqueta + filtro + retroactivo + manejo de INBOX.
• Si hay fallo de scopes en gws para filtros, usar el fallback ya implementado dentro del workflow (credenciales OAuth locales).

Reference

• Ver ejemplos listos en references/commands.md.