Skip to main content
Una ejecución programada llama a tu app alojada según un cron en lugar de en respuesta a una solicitud. Úsala para trabajo que ningún evento de Whop desencadena, como obtener pedidos nuevos de otro sistema cada 15 minutos o conciliar pagos salientes durante la noche.

Configurar una programación

Una app tiene dos programaciones. Configura una o ambas con Update app:
Ambos aceptan una expresión cron de cinco campos, interpretada en UTC, de 64 caracteres como máximo. La expresión tiene que dispararse al menos una vez. schedule no tiene intervalo mínimo. Envía null o una cadena vacía para borrar una programación. Una expresión no válida devuelve un 400. La clave necesita developer:update_app en la cuenta propietaria de la app.

Gestionar la ejecución

Exporta scheduled() junto a fetch() en el punto de entrada del servidor de tu build:
src/server.ts
ctx.props indica de qué ejecución se trata: controller.cron es la expresión que programó la ejecución, y controller.scheduledTime es la franja en milisegundos desde el epoch. Una ejecución usa el mismo isolate que tus handlers de solicitudes, así que los secretos y la clave de API inyectada funcionan igual. Una ejecución puede durar hasta 15 minutos, mientras que un handler de solicitudes dispone de 30 segundos.
Guarda un cursor de sincronización por instalación en la metadata de la instalación, como se describe en Instalaciones de apps. Cada ejecución lo lee de ctx.props.app_installation.metadata y escribe el nuevo valor cuando termina.

Reintentos y ejecuciones repetidas

Si una ejecución falla, Whop la reintenta una vez, un minuto después, y luego la descarta. Para omitir el reintento, llama a controller.noRetry() antes de lanzar el error. En el reintento, attempt es 2 y scheduled_at sigue siendo la franja original. La misma franja puede llegar a tu app más de una vez, y un reintento puede empezar mientras la ejecución de la siguiente franja ya está en curso. Si tu trabajo no debe ocurrir dos veces, registra cada ejecución que termines con run_id más app_installation.id, y omite una ejecución que ya hayas registrado.

Franjas omitidas

No se produce ninguna ejecución mientras la app no tenga un build web de producción con punto de entrada de servidor. Whop no pone en cola una franja omitida ni la recupera más tarde, así que diseña cada ejecución para que continúe a partir de lo que guardó la anterior.

Registros

La salida de console de una ejecución y los errores no capturados aparecen en los registros de tu app, junto a sus solicitudes.

Próximos pasos

Instalaciones de apps

La instalación que incluye cada ejecución por instalación y dónde guardar un cursor de sincronización.

Alojamiento

Builds, secretos, la clave de API inyectada y los registros.