Documentación

App de Slack

Captura y actualiza tareas desde Slack con /done o @done. Cada usuario de Slack vincula su propia cuenta de Done, así que todo lo que agregas queda limitado a tus propias tareas.

Qué puedes hacer

/done buy milk tomorrow urgent #errands
Crea una tarea — las fechas en lenguaje natural, la prioridad, la ~estimación y el #proyecto se extraen de la línea, igual que con Agregar rápido en la app.
/done done review the PR
Marca como terminada la primera tarea abierta cuyo título coincida con “review the PR”.
/done update groceries :: friday, low priority
Aplica las indicaciones de fecha y prioridad que van después de :: a la tarea que coincida y publica el texto como comentario en ella.
/done list
Muestra tus cinco tareas abiertas más relevantes.
/done connect
Vincula esta cuenta de Slack con tu cuenta de Done (una sola vez).
/done disconnect
Desvincula esta cuenta de Slack. Tus tareas se quedan; solo se elimina la conexión con Slack.
/done help
Muestra la referencia de comandos.

@done … en un canal donde está el bot funciona igual que /done ….

Agrega Done a tu espacio de trabajo

Una persona instala la app para todo el espacio de trabajo. Basta un clic y no requiere configuración — no creas ninguna app de Slack ni tocas ningún secreto.

Agregar a Slack

Al instalarla, Done recibe tres alcances de bot — commands, chat:write y app_mentions:read — y nada más. La instalación por sí sola no conecta las tareas de nadie: cada persona vincula su propia cuenta como se explica abajo, así que un administrador no puede conectar el espacio de trabajo a los datos de Done de otra persona.

Conecta tu cuenta

  1. En Slack, ejecuta /done connect.
  2. Abre el enlace con el que te responde e inicia sesión en Done si todavía no lo has hecho.
  3. Aprueba en la pantalla de consentimiento de Slack. Done pide un único alcance, identity.basic, que solo nos dice qué usuario de Slack eres.
  4. Listo — /done ahora gestiona las tareas de tu cuenta. Ejecuta /done disconnect cuando quieras desvincularla.

Las dos mitades de la conexión se demuestran; una URL nunca basta para afirmarlas: tu cuenta de Done sale de la sesión de tu navegador, y tu identidad de Slack, del propio intercambio de tokens de Slack. El enlace que te da /done connect es el mismo para todos y no dice nada sobre quién se está conectando — así que reenviárselo a otra persona no hace nada en tu nombre; solo inicia su conexión con su propia cuenta.

Configúralo (administrador del espacio de trabajo)

Solo es necesario si alojas Done por tu cuenta. En trydone.app la app ya está publicada — usa el botón Agregar a Slack de arriba. Alojarlo por tu cuenta significa crear tu propia app de Slack apuntando a tu instancia y configurar cuatro secretos; mientras no estén configurados, las rutas /slack/* quedan inactivas y responden “not configured”.

  1. En api.slack.com/apps, crea una app para tu espacio de trabajo.
  2. Slash Commands → agrega /done con la URL de solicitud https://trydone.app/slack/commands, y agrega el alcance de bot commands — Slack no deja guardar una app que declara un comando de barra sin él.
  3. Interactivity & Shortcuts → actívalo, con la URL de solicitud https://trydone.app/slack/interactivity. Las alertas de aprobación te llegan por mensaje directo con los botones Approve / Request changes; sin esta URL, Slack no tiene adónde enviar el clic, así que los botones aparecen pero no hacen nada.
  4. Event Subscriptions (opcional, para @done) → URL de solicitud https://trydone.app/slack/events, suscríbete al evento de bot app_mention y agrega los alcances chat:write y app_mentions:read — suscribirse a app_mention requiere este último.
  5. OAuth & Permissions → agrega la URL de redirección https://trydone.app/slack/oauth/callback y el alcance de token de usuario identity.basic. Vincular cuentas es un intercambio OAuth de ida y vuelta; sin esto, /done connect no tiene adónde enviar a las personas.
  6. Instala la app en el espacio de trabajo y luego configura los secretos en el Worker:
wrangler secret put SLACK_SIGNING_SECRET   # de Basic Information → App Credentials
wrangler secret put SLACK_CLIENT_ID        # Basic Information → App Credentials → Client ID
wrangler secret put SLACK_CLIENT_SECRET    # …→ Client Secret (necesario para /done connect)

Configura SLACK_SIGNING_SECRET antes de agregar la URL de Event Subscriptions. Slack verifica esa URL enviándole un desafío url_verification, y /slack/events comprueba la firma de la solicitud antes de responder al desafío — así que, mientras el secreto no esté configurado, el endpoint responde “not configured” y Slack rechaza la URL. Ningún otro paso tiene esa restricción — Event Subscriptions es el único que Slack verifica al guardar.

Prueba rápida: /done connect → aprueba en Slack → /done buy milk tomorrow urgent #errands → /done list. Luego haz que un agente deje una propuesta pendiente y presiona Approve en el mensaje directo — ese último paso es el único que demuestra que Interactivity está bien conectado.

Notas

  • Cada solicitud de Slack se verifica con la firma basada en el secreto de firma de Slack; las solicitudes vencidas (reenviadas) se rechazan.
  • Todo el trabajo queda limitado a la propia cuenta del usuario vinculado — el mismo aislamiento que aplican la app y el endpoint MCP.
  • Las tareas creadas desde Slack son tareas normales: asígnalas a un agente de IA, define dependencias o trabájalas en la app.