Aprobaciones

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

Qué 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 de ellos hayan decidido, o hasta que se agote el tiempo.
4. Registra el resultado, luego el flujo de trabajo continúa en el camino correspondiente.

Una ejecución en pausa 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
responsibility:<key>	Todos en tu workspace que tienen esa responsabilidad, como responsibility:vendor contracts
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á pendiente, su voto ya no es aceptado.

Una responsabilidad es una etiqueta corta que el propietario del workspace asigna a un miembro en Configuración → Workspace → Miembros (ver Perfil del workspace y personas). Las mayúsculas y espacios adicionales no importan, así que responsibility:Finance encuentra a alguien listado bajo finance. Si nadie tiene la responsabilidad cuando comienza el paso, la solicitud no puede enviarse a nadie, por lo que el paso informa que no pudo encontrar un aprobador en lugar de esperar. Un veto (veto) debe nombrar a personas (user:) o a un rol (role:), no a una responsabilidad. Cualquiera que pueda editar miembros puede agregar una responsabilidad, por lo que no se puede confiar en que decida quién puede detener una solicitud por su cuenta.

Cuántos deben estar de acuerdo

Configuración	Qué hace
quorum	Cuántas aprobaciones se necesitan. Un número, o all.
stages	Pregunta a los grupos uno tras otro, por ejemplo, primero a un gerente, luego a legal.
veto	Personas cuyo rechazo único detiene la solicitud de inmediato.
min_humans	Cuántas de las aprobaciones deben provenir 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 en cada etapa, por ejemplo, 2d. El valor predeterminado es siete días.
on_timeout	Lo que sucede cuando se agota el tiempo: timed_out (predeterminado), rejected o approved.
remind_after	Envía un recordatorio a cualquiera que no haya respondido.
escalation	Después de un tiempo determinado, 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:

Opció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 y 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 ha sido registrado. Si la solicitud se estaba cerrando en ese 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 utiliza la integración de Slack, también puedes enviarle 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.

Elegir el siguiente paso

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

Una conexión sin resultado nombrado se ejecuta solo cuando la solicitud es aprobada. Por lo tanto, “aprobar y luego enviar” es seguro por defecto. Para hacer algo en caso de rechazo, agrega una conexión etiquetada como rejected. Los pasos a los que no llega ninguna conexión son omitidos.

unresolvable significa que nadie podría ser preguntado; por ejemplo, el rol que nombraste no tiene miembros. El paso se detiene de inmediato en lugar de esperar a que nadie responda.

Pasos de decisión

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

Monto	Ruta	Aprobadores	Quorum
> 10000	review	team:finance	2
(cualquiera)	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 silenciosamente la ruta predeterminada: una regla que no se puede leer, un valor que no se puede comparar, o una configuración que la tabla no soporta detienen toda la ejecución e indican qué regla y columna. Cada regla también debe evaluarse en pocos segundos, por lo que una regla que recorre una lista muy grande también detiene la ejecución.

Aprobar acciones dentro de un paso de agente

Algunas herramientas, como enviar un correo electrónico, pueden configurarse para necesitar aprobación antes de ejecutarse. Cuando un agente quiere usar una, la ejecución se pausa y solicita aprobación para esa acción en particular, 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 los votos no se aceptan hasta que hay un plan activo nuevamente. Un voto de Slack también es rechazado mientras el workspace ha superado su presupuesto de uso, y la respuesta del bot indica cuál de los dos fue.