Aprobaciones y permisos

Por defecto, cada llamada pasa directa. Tú eliges dónde una llamada espera a una persona: un agente, una conexión y una clase cada vez.

Elige qué llamadas te esperan

Abre Agentes y elige el agente. Su lista Acceso tiene una fila por conexión.

• Activa Preguntar en cada llamada para aprobar cada llamada de esa conexión.
• O ajusta las columnas Lectura, Escritura y Destructiva una a una. Automático ejecuta la llamada, Requiere aprobación espera a una persona, Denegado la rechaza.
• Marca Código para pedir un código de seis dígitos del autenticador en las llamadas destructivas. La columna aparece cuando configuras App de autenticación en Configuración.

Sallyport clasifica una llamada por su método HTTP. GET, HEAD y OPTIONS leen. POST, PUT y PATCH escriben. DELETE y cualquier otro método son destructivos. Una lectura pasa a ser escritura cuando un tramo de la ruta empieza por una palabra como send, run, exec, build, trigger, invoke o webhook. La receta de un servicio puede ajustar esto para las llamadas que conoce.

Una llamada que supera un presupuesto que fijaste espera, consulta Límites.

Dónde te llega la tarjeta

La tarjeta llega a la persona en cuyo nombre actúa el agente y a cada propietario y administrador. Decide la primera respuesta. Los canales se ajustan en Notificaciones.

Cada canal conectado tiene Enviar una prueba. La tabla Qué te llega y dónde elige qué eventos usan Navegador, Telegram y Correo electrónico. Para una llamada destructiva, Telegram solo ofrece Deny y un enlace a la tarjeta.

Responde la tarjeta

La tarjeta muestra qué se enviará, qué agente pregunta y desde qué espacio de trabajo. Detalles guarda la regla, la clave, el ID de la llamada, el plazo y las palabras del propio agente, marcadas como no verificadas. La tarjeta muestra cada parte de la solicitud hasta 2 KiB. Si una parte es más larga, lo dice encima de los botones, y Mostrar la solicitud completa la carga entera. Detalles también muestra una cabecera que el agente envió en el lugar de la clave, con el valor que envió; esa cabecera no sale.

Aprobar una llamada destructiva también pide un motivo. Si esa fila tiene Código marcado, la tarjeta pide además el código de seis dígitos de tu autenticador.

Un permiso creado desde la tarjeta dura lo que marca Permiso más largo (segundos) en Configuración, Organización: 24 horas por defecto. Cubre 200 lecturas, 20 escrituras o 1 llamada destructiva. Approve for 1 hour en Telegram da 20 llamadas durante una hora. Revisa y revoca permisos en Permisos, que se abre desde Aprobaciones; la página de un agente lista sus permisos activos.

El botón a partir de ahora aparece solo mientras la clase está en Requiere aprobación. El cambio queda en Cambios de reglas, donde Revertir lo deshace. Poner una clase en Denegado revoca los permisos que cubría.

Qué ve el agente mientras espera

Cada respuesta de espera lleva un call_id y un approve_url. Repetir con el mismo call_id continúa la misma llamada y nunca inicia una segunda.

• Un cliente MCP que envía un token de progreso mantiene la llamada abierta. Sallyport informa del progreso cada 10 segundos, hasta 240 segundos.
• Un cliente sin token de progreso espera hasta 45 segundos.
• Cuando termina esa espera, el agente recibe APPROVAL_PENDING con call_id, approve_url, expires_at y poll_after_ms. Luego get_call responde al instante, y repetir con call_id vuelve a esperar.
• Un cliente compatible con MCP Tasks recibe una tarea que consultar. Un cliente compatible con URL elicitation te muestra approve_url y repite la llamada por sí mismo.
• En /p/ la respuesta es 202 con X-Sallyport-Call-Id. Consulta GET https://mcp.sallyport.cloud/p/calls/{call_id}: 202 mientras espera, la respuesta del servicio tras la aprobación, 403 tras un rechazo, 410 tras caducar.

Una respuesta llega al instante a la llamada que espera. Claude Code pasa a segundo plano una llamada que espera más de 2 minutos y entrega el resultado cuando llega.

Cuánto espera una tarjeta

• Por defecto, una tarjeta sigue abierta 60 minutos. Plazo de aprobación (segundos) en Configuración, Organización, lo cambia.
• Abrir la tarjeta completa añade 5 minutos, como mucho dos veces. La tarjeta de la esquina no añade nada.
• Los recordatorios salen 2, 15 y 45 minutos después de que se abrió la tarjeta. Un recordatorio que caería después del plazo no se envía.
• Tras un rechazo, el agente recibe APPROVAL_DENIED con tu motivo. No se ejecutó nada.
• Tras caducar, el agente recibe APPROVAL_EXPIRED. No se ejecutó nada; si la acción aún hace falta, el agente la repite sin call_id.

Ráfagas de llamadas

• Las llamadas idénticas de un mismo agente se suman a la tarjeta que ya está abierta, sin importar el tiempo entre ellas. La llamada se ejecuta una vez y cada copia recibe su resultado.
• Un agente con 20 tarjetas abiertas, o una organización con 100, ya no crea más. El agente se pausa, una tarjeta explica por qué, y Reanudar agente en su página lo pone en marcha.

Cuando al agente le falta una clave

Una tarjeta responde a una llamada que ya tiene clave. Una llamada a un servicio sin clave abre una solicitud en Falta una clave y le da al agente su enlace.

Lo mismo ocurre con una conexión en pausa, una clave retirada o un inicio de sesión OAuth caducado. Añade la clave con Conceder acceso, y el agente repite su llamada. Consulta Claves y agentes.