Aprobaciones

Un paso de aprobación pausa un flujo de trabajo hasta que las personas que elijas hayan decidido. El flujo de trabajo luego continúa por el camino que coincide con la decisión. Un paso de decisión observa los datos y elige un camino — por ejemplo, envía pedidos grandes para aprobar y aprueba automáticamente los pequeños.

Lo que hace un paso de aprobación

1. Determina quién debe aprobar, según la política que escribiste.
2. Les envía un correo electrónico y lista la solicitud en su bandeja de entrada de Aprobaciones.
3. Espera hasta que suficientes hayan decidido, o hasta que se agote el tiempo.
4. Registra el resultado, luego el flujo de trabajo continúa por el camino correspondiente.

Una ejecución pausada muestra quién ha respondido hasta ahora, por ejemplo 1/2 aprobado.

Quién puede aprobar

Nombras a los aprobadores en la política del paso. Cada entrada es una de estas:

Entrada	Significa
user:<id>	Una persona en tu workspace
role:<name>	Todos en tu workspace con ese rol
team:<slug>	Todos en ese equipo que también están en tu workspace
agent:<name>	Un agente de IA que revisa la solicitud y vota

Solo las personas en el workspace que ejecuta el flujo de trabajo pueden aprobar. Si alguien deja el workspace mientras una solicitud está en espera, su voto ya no será aceptado.

Cuántos deben estar de acuerdo

Configuración	Qué hace
quorum	Cuántas aprobaciones se necesitan. Un número, o all.
stages	Pregunta a grupos uno tras otro, por ejemplo un gerente primero, luego legal.
veto	Personas cuya única rechazo detiene la solicitud de inmediato.
min_humans	Cuántas de las aprobaciones deben venir de personas. Un agente puede votar, pero no puede decidir solo.

El paso deja de esperar tan pronto como el resultado es cierto. No espera el último voto si suficientes personas ya han aprobado, o si la aprobación ya no es posible.

Límites de tiempo, recordatorios y escalación

Configuración	Qué hace
timeout	Cuánto esperar por cada etapa, por ejemplo 2d. El predeterminado es siete días.
on_timeout	Qué sucede cuando se agota el tiempo: timed_out (el predeterminado), rejected o approved.
remind_after	Envía un recordatorio a cualquiera que no ha respondido.
escalation	Después de un tiempo establecido, también pregunta a más personas.

Los tiempos se escriben como un número seguido de s, m, h o d, por ejemplo 36h.

Un ejemplo completo:

{
  "stages": [
    { "approvers": "role:manager" },
    { "approvers": "team:legal", "quorum": "all" }
  ],
  "veto": ["role:general-counsel"],
  "remind_after": "1d",
  "timeout": "3d",
  "escalation": { "after": "2d", "approvers": "role:director" }
}

Respondiendo

Abre Aprobaciones para ver qué está esperando por ti en el workspace actual. Para cada solicitud puedes:

Elección	Significado
Aprobar	Sí, tal como está.
Rechazar	No. Agrega un comentario para decir por qué.
Abstenerse	No tienes una opinión. Esto no cuenta como una aprobación.
Editar antes de aprobar	Cambia el contenido, luego aprueba. El flujo de trabajo continúa con tus cambios. Cuando el paso declara qué campos pueden cambiar, recibes un formulario solo con esos campos; de lo contrario, editas el contenido directamente.

Después de que respondes, normalmente ves Tu voto está registrado. Si la solicitud se estaba cerrando en el mismo momento, puedes ver Tu voto fue enviado y está siendo procesado en su lugar; la ejecución recoge el voto un momento después, y el registro de la solicitud muestra el resultado.

El correo electrónico enlaza directamente a la solicitud. Si tu workspace usa la integración de Slack, también puedes enviar un mensaje al bot: approve 1a2b3c4d, o reject 1a2b3c4d demasiado caro. El código está en el correo electrónico. Si el bot responde que más de una solicitud coincide con el código, responde desde Aprobaciones en su lugar.

Eligiendo el siguiente paso

Cada conexión que sale de un paso de aprobación puede nombrar los resultados para los que se ejecuta: approved, approved_with_changes, rejected, timed_out o unresolvable.

Una conexión sin resultado nombrado se ejecuta solo cuando la solicitud está aprobada. Así que “aprobar, luego enviar” es seguro por defecto. Para hacer algo en caso de rechazo, agrega una conexión etiquetada como rejected. Los pasos que no alcanzan ninguna conexión se omiten.

unresolvable significa que no se pudo preguntar a nadie — por ejemplo, el rol que nombraste no tiene miembros. El paso se detiene de inmediato en lugar de esperar a que no haya nadie.

Pasos de decisión

Un paso de decisión contiene una pequeña tabla de reglas. Cada regla verifica valores de la entrada del flujo de trabajo o de pasos anteriores, y establece salidas. La primera regla que coincide gana.

Cantidad	Ruta	Aprobadores	Quorum
> 10000	review	team:finance	2
(cualquier cosa)	auto

Las conexiones que salen de un paso de decisión pueden nombrar una ruta. Un paso de aprobación puede tomar su política de la decisión, por lo que la tabla decide tanto si preguntar como a quién preguntar. Una tabla con un error en ella detiene la ejecución con un error claro, en tu idioma. Nunca toma el camino predeterminado en silencio: una regla que no se puede leer, un valor que no se puede comparar, o una configuración que la tabla no soporta detendrán la ejecución y dirán qué regla y columna. Cada regla también debe evaluarse en unos pocos segundos, por lo que una regla que recorre una lista muy grande también detiene la ejecución.

Aprobando acciones dentro de un paso de agente

Algunas herramientas, como enviar un correo electrónico, pueden configurarse para necesitar aprobación antes de que se ejecuten. Cuando un agente quiere usar una, la ejecución se pausa y solicita aprobación para esa única acción, mostrando los detalles exactos. Aprobar con cambios ejecuta la acción con tus ediciones. Rechazarla le dice al agente que no, junto con tu comentario.

Registros

Cada solicitud de aprobación se mantiene en un registro permanente. El registro muestra quién fue preguntado, quién respondió y cómo, cualquier comentario y cambios, y el resultado. Nadie puede editar el registro. Si la suscripción de tu workspace ha caducado, las solicitudes dejan de enviar correos electrónicos y no se aceptan votos hasta que haya un plan activo nuevamente. Un voto de Slack también es rechazado mientras el workspace esté por encima de su presupuesto de uso, y la respuesta del bot dice cuál de los dos fue.