FocusBot 🧠

Documentación Oficial

Bienvenido al manual operativo de FocusBot. Tu segundo cerebro funciona mejor cuando sabes cómo hablarle.

1. Instalación (Discord)

FocusBot es flexible. Puedes usarlo de dos formas:

  • Privado (DM): Autorízalo en tu cuenta personal para chatear en directo.
  • Servidor (Guild): Invítalo a un servidor ("My Brain" o "HQ") para usar canales dedicados.
👤 DM (Privado)🏰 Server (Guild)

2. Onboarding (/start)

Una vez conectado, escribe /start en Discord para iniciar el asistente de configuración. Él te guiará para conectar tu Calendario y Notion.

/start
setup_wizard()

Despliega el panel de control para vincular integraciones y definir horario.

Modo Deep Work 🍅

El núcleo de FocusBot. Protege tu atención bloqueando distracciones.

/focus start
Iniciar Sesión

/focus start minutes:90 task:Refactor API
Cronómetro de alta precisión.

/focus pause
Pausar Timer

Para interrupciones breves. Usa /focus resume para volver.

/focus stop
Terminar Sesión

Cierra la sesión y registra las estadísticas en tu DB.

Entrada por Voz (Telegram) 🎙️

Captura ideas mientras caminas. No necesitas instalar nada extra, solo habla con el bot en Telegram.

🔄 Cómo Vincular Telegram:
  1. Abre el bot en Telegram: @focuzAppBot
  2. Pulsa "Start". Te pedirá conectar con Discord.
  3. Pulsa el botón "Conectar Discord" y autoriza.
  4. ¡Listo! Tu voz en Telegram se procesará en tu Discord.

Tipos de Intención

El bot analiza tu voz con GPT-4 y decide qué hacer:

  • "Recuérdame..." → Crea una nota rápida (Low Energy).
  • "Agenda una reunión..." → Crea un evento en GCal (Próximamente).
  • "Tengo que hacer..." → Crea una tarea en Notion (Accionable).
  • "Redacta un correo..." → Crea un borrador. Luego usa [✏️ Editar]para refinarlo.

Smart Notes 🧠✨

Las notas ahora son inteligentes. FocusBot distingue entre una nota rápida (que va a Notion) y una tarea agendada (que también va a tu Calendar).

🎯 Reglas del Juego:
  • Sin Fecha → Solo Notion (tu inbox limpio)
  • Con Fecha → Notion + Google Calendar (acción programada)
  • Fecha Vaga → El bot te pregunta si quieres agendarla

Ejemplos Prácticos

🎤
"Anotame comprar leche"

✅ Se guarda en Notion como nota simple.
🚫 NO aparece en tu Calendar (para no saturarlo).

🎤
"Anotame mañana a las 5 revisar el reporte"

✅ Se guarda en Notion como tarea.
✅ Se crea un evento en Google Calendar automáticamente.

🎤
"Recuérdame hacer esto la próxima semana"

🤔 El bot detecta ambigüedad y pregunta:
"¿Quieres ponerle fecha exacta o lo guardo como nota simple?"

Sincronización Bidireccional 🔄

El verdadero poder viene cuando Notion se convierte en tu Centro de Mando:

  1. Envías una nota de voz: "Anotame revisar tema Spark Chevrolet"
  2. Se guarda en Notion sin fecha (tu inbox limpio).
  3. Luego, mientras revisas Notion, decides que sí necesitas hacerlo mañana.
  4. Le pones fecha en Notion → 🪄 El bot lo detecta y crea el evento en Calendar solo.
💡 Por qué esto importa:

Notion es tu Source of Truth. Puedes capturar rápido por voz y organizar después con calma. El bot sincroniza automáticamente cualquier cambio que hagas en Notion hacia tu Calendar, sin que tengas que duplicar trabajo.

Hablando con FocusBot 💬

FocusBot ya no es solo una línea de comandos. Ahora entiende preguntas naturales sobre tu vida y trabajo.

💡 Ejemplos de lo que puedes preguntar:
  • "¿Qué hice ayer?" (Te da un resumen de tareas completadas)
  • "¿Qué tengo para hoy?" (Lista tareas pendientes y eventos)
  • "¿Tengo tiempo libre mañana en la tarde?" (Revisa tu calendario)
  • "¿Cuántas sesiones de foco hice esta semana?" (Analiza tu productividad)

Funciona tanto en Telegram como en Discord. Es la misma inteligencia.

Rituales de Trabajo ☀️🌙

FocusBot no es solo un gestor de tareas, es un Sistema Operativo Cognitivo. Te ayuda a delimitar cuándo empieza y termina tu trabajo.

☀️ Inicio de Día (/start-day)

No empieces reaccionando. Define tu intención.

  • Define tiempo disponible (ej: "2 horas").
  • Elige el Modo: 🔥 Ejecutar, 🌱 Explorar, etc.
  • El bot bloquea distracciones y selecciona tareas acordes a tu energía.
🌙 Cierre de Día (/end-day)

Evita el "efecto Zeigarnik" (ansiedad por tareas incompletas).

  • Registra pequeñas victorias ("¿Qué avancé hoy?").
  • Captura pendientes abiertos para vaciar tu mente.
  • Define UNA prioridad para mañana.

Brain Dump (/import) 🧠

¿Tienes una lista caótica de tareas en tus notas o un email largo? No pierdas tiempo organizando manualmente.

/import
Importar Caos

Abre un modal donde puedes pegar texto sin formato. La IA extraerá tareas, eventos y notas automáticamente.

Cheat Sheet de Comandos

/task new

Crear nueva tarea manualmente.

/task list

Ver tus tareas activas pendientes.

/note

Guardar un pensamiento rápido o URL.

/stats

Ver tu reporte de productividad semanal.

/subscribe

Gestionar tu suscripción Premium.

Integraciones: Notion & Calendar

FocusBot vive donde tú trabajas. La conexión es bidireccional y en tiempo real.

Configuración de Notion 📝

Al conectar Notion (/connect notion o vía /start), recomendamos encarecidamente usar nuestro template.

🌟 Opción A: Template Recomendado (Obligatorio para Sync)

¿Por qué es necesario? Para que la sincronización bidireccional funcione, el bot necesita leer y escribir en campos exactos. Si usas tu propio sistema, perderás funcionalidades clave.

⚠️ CAMPOS INTOCABLES (NO RENOMBRAR):
  • Title (Name)
  • Status (Select: TODO, IN_PROGRESS, DONE)
  • Priority (Select: A, B, C)
  • Due Date (Date)
  • Type (Select: FOCUS, LOW_ENERGY)

💡 Cómo instalar:Durante la autenticación, elige "Duplicar Template". Es la forma más segura de empezar.

Opción B: Tu Propio Workspace (Avanzado)

Si conectas tu propia base de datos, asegúrate de que tenga exactamente las propiedades listadas arriba. De lo contrario, el bot no podrá guardar tus tareas.