Skip to content
ver .md sin procesar

Muestra la pantalla de inicio de Plan en una sola solicitud

Arma una pantalla de inicio de Dailybot Plan con una sola llamada: conteos, tu trabajo pendiente, tableros recientes, objetivos, proyectos, elementos que requieren atención y actividad, con caché por ETag.

Beta

Plan está en beta. Todo lo que está bajo /plan en la aplicación web, los comandos del CLI y de la agent skill para proyectos, objetivos, tableros y tareas, y la API pública /v1/plan/ puede cambiar antes de la disponibilidad general. ¿Quieres probarlo con tu equipo? Escribe a [email protected].

Una pantalla de inicio suele necesitar media docena de listas: conteos, tu trabajo pendiente, tableros recientes, objetivos, proyectos, lo que requiere atención y la actividad reciente. GET /v1/plan/pulse/ las devuelve todas en una sola solicitud, y tú decides cuándo incluir las partes más pesadas con include.

La llamada

curl -sS "https://api.dailybot.com/v1/plan/pulse/?include=projects,attention,activity,goal_progress" \
  -H "Authorization: Bearer $DAILYBOT_TOKEN"

Desde el CLI (próxima versión), el mismo inicio con las cuatro bandas:

dailybot plan tasks status --json

Lo que siempre recibes

Campo Para qué sirve
counts Indicadores enteros: open_tasks, overdue_tasks, blocked_tasks, active_boards, active_projects, active_goals, open_tasks_on_goal_linked_projects
my_preview Tus conteos overdue y due_today y tus top_tasks
recent_boards · featured_boards Tarjetas de tableros para retomar el trabajo
goals_preview Objetivos con su periodo y estado
timeline_teaser Lo que vence pronto, en una ventana corta
agent_summary Tableros donde actúan agentes y aprobaciones pendientes
unread_count Tus elementos sin leer de la bandeja de entrada
scope Siempre viewer_visible: todo cuenta solo lo que tú puedes ver

Bandas opcionales

Cada token de include agrega una banda. Una banda que no pides no aparece y no tiene costo:

Token Agrega
projects projects_preview: proyectos activos visibles, con su progreso y su actualización más reciente
attention attention: tu trabajo abierto que está vencido o bloqueado
activity recent_activity: los eventos más recientes, con la misma forma que GET /v1/plan/activity/
goal_progress progress y projects en cada fila de goals_preview

Un token desconocido devuelve 400 invalid_filter_value.

Cada indicador tiene su consulta

Cuando alguien hace clic en un indicador, abre la lista que lo reproduce:

Indicador Consulta de la lista
Abiertas GET /v1/plan/tasks/?state=open
Vencidas GET /v1/plan/tasks/?due_before=<today>&state=open
Bloqueadas GET /v1/plan/tasks/?blocked=true&state=open

Los números coinciden porque el indicador y la lista aplican las mismas reglas a las mismas tareas visibles. Los conteos siempre son enteros sobre lo que puedes ver; no hay desglose por persona.

Guárdalo en caché con ETag

La respuesta trae un ETag. Envíalo de vuelta en If-None-Match en la siguiente actualización; si nada cambió, recibes 304 Not Modified y conservas lo que ya tienes:

curl -sS -i "https://api.dailybot.com/v1/plan/pulse/?include=projects,attention,activity,goal_progress" \
  -H "Authorization: Bearer $DAILYBOT_TOKEN" \
  -H "If-None-Match: $ETAG"

Modo de inicio y modo de salud del tablero

El mismo endpoint tiene un segundo modo. Agrega group_by (por ejemplo, group_by=state) y devuelve en su lugar un agregado de salud del tablero: totales, rendimiento por semana y tiempo de ciclo. Sin group_by, siempre recibes la pantalla de inicio que se describe aquí. include solo aplica al modo de inicio.

Referencia