Webhooks, polling y ahora tareas — una tercera forma de encargarle trabajo a la IA

Hola, soy Chae-won.

En un artículo anterior comparé los webhooks y el polling con el envío de un paquete. El polling es llamar una y otra vez al repartidor para preguntar "¿Ya llegó?". Un webhook es el timbre que suena cuando el paquete llega.

Hoy en día, mucha gente trabaja directamente dentro de asistentes de IA como ChatGPT o Claude. Buscan información, redactan textos y, cada vez más, le piden a la IA que haga cosas en sus propios sistemas. Así empezamos a recibir una petición nueva: "¿Cómo le pido a mi IA que haga un trabajo y me traiga el resultado?"

Hoy te cuento por qué ni los webhooks ni el polling encajaban del todo con esa petición, y por qué creamos las tareas para resolverla.

Hasta ahora, había que montarlo a mano

Antes de las tareas ya había una forma de hacerlo: usar dos endpoints como un canal entre tu IA y tu propio sistema. El flujo era así:

1. La IA escribe el trabajo en un endpoint de "solicitudes"
2. Tu servidor lo recoge, ya sea con un webhook o haciendo polling
3. Tu servidor hace el trabajo y escribe el resultado en un endpoint de "resultados"
4. La IA consulta el endpoint de resultados y te cuenta qué pasó

Es como dos personas que se dejan notas en dos buzones. Funciona, pero pronto aparecen tres incomodidades.

Una conversación con la IA no se queda esperando

Generar un informe, convertir un lote de archivos, registrar un pedido en tu ERP: este tipo de trabajos tarda minutos o incluso horas. La respuesta de una IA no puede esperar tanto.

Tampoco puede la IA decir "vuelvo a mirar en 10 minutos" y ponerse una alarma. Solo actúa cuando tú le escribes. Así que el resultado se revisa la próxima vez que hablas con ella.

Lo que necesitas es poder encargar el trabajo ahora y preguntar por él más tarde. En términos de paquetería, necesitas un número de seguimiento.

Por qué los webhooks no encajan: no hay puerta donde poner el timbre

Un webhook dice "te aviso cuando llegue". Eso solo funciona si hay una dirección a la que enviar el aviso.

Una ventana de chat no tiene esa dirección. No es un servidor al que se pueda llegar. Cuando llega un resultado, no hay forma de tocar el timbre y despertar a la IA dentro de tu conversación.

También había un problema de seguridad. Configurar un webhook desde una conversación con la IA implicaba escribir secretos, como un encabezado de autenticación, en el chat. Y el historial de una conversación acaba en más sitios de los que imaginas. Por eso, a partir de esta actualización, los encabezados de autenticación de los webhooks solo se configuran desde el Panel. Los que ya tenías guardados se siguen enviando igual que antes.

Por qué el polling sale caro: casi todas las consultas vuelven vacías

En realidad, el polling encaja bien con una conversación con la IA: preguntas cuando te interesa. El problema está en el lado que hace el trabajo.

Con el sistema de los dos buzones, tu servidor tiene que preguntar sin parar "¿Hay trabajos nuevos?", aunque solo lleguen unos pocos al día. Si consulta una vez por minuto, son 43.200 llamadas al mes, y casi todas responden "no". Cada una de ellas cuenta para tu límite mensual de llamadas.

Por eso creamos las tareas

Las tareas convierten esos dos buzones en un mostrador de envíos.

1. Registra un worker una sola vez — en el Panel, indica el nombre, la descripción y la URL del lugar que hará el trabajo (el worker)
2. La IA encarga el trabajo — di "Haz un pedido de 30 unidades de A-1042 en nuestro ERP" y la IA crea una tarea y recibe su número de seguimiento (el ID de la tarea)
3. 3Min API la entrega al worker — la envía firmada a la URL del worker y la reintenta automáticamente si falla
4. El worker hace el trabajo y envía el resultado — no importa si tarda; una tarea puede durar hasta 24 horas
5. La IA revisa el resultado — la próxima vez que preguntes "¿Qué pasó con ese pedido?", consulta la tarea y te lo cuenta

La IA elige a qué worker enviar el trabajo solo por su nombre y descripción. La URL del worker, sus credenciales y el secreto de firma se quedan en el Panel y nunca aparecen en la conversación.

¿Quién crea las tareas?

Quizá te estés preguntando: "Hay infinitos tipos de trabajo. ¿3Min API los trae todos ya preparados?"

No. 3Min API no hace el trabajo. Se encarga de entregarlo a tu worker y de registrar en qué estado está, igual que una empresa de paquetería no fabrica lo que va dentro de la caja.

• Un worker es donde se hace el trabajo. Es tu servidor o programa, y es el worker el que decide qué tipo de trabajo hace
• Una tarea es un solo trabajo encargado a un worker. Piénsalo como una etiqueta de envío, no como una lista de funciones

Registra un worker que "haga pedidos" y tu IA podrá hacer pedidos. Registra uno que "genere informes" y podrá generar informes. Lo que tu IA puede hacer crece con cada worker que conectas.

No hace falta empezar de cero

"Entonces, ¿tengo que montar un servidor nuevo?" No necesariamente. Un worker solo tiene que hacer dos cosas:

1. Recibir la solicitud que envía 3Min API
2. Enviar el resultado a 3Min API cuando termine

Cualquier cosa que pueda recibir y enviar una solicitud HTTP puede ser un worker. Así que tienes varias formas de aprovechar lo que ya tienes:

• Un script o programa que ya usas — envuélvelo en una capa fina que reciba la solicitud, ejecute tu programa y devuelva el resultado
• Una herramienta de automatización que pueda recibir y enviar solicitudes — conecta un paso de "recibir" con uno de "enviar" y tendrás un worker sin escribir código
• Algo que solo funciona en tu propio equipo — dale una dirección pública con un túnel (te lo explico abajo) y tu equipo se convierte en un worker
• Pídele a tu IA que escriba la capa — di "Créame un worker de tareas de 3minapi" y la IA leerá la documentación de 3Min API y escribirá el código por ti

Si tu worker está en tu equipo o en la red de la oficina: usa un túnel

Para entregar un trabajo, 3Min API tiene que llegar a tu worker a través de una dirección accesible desde internet. Pero los equipos de casa o de la oficina están detrás de un router, así que no se ven desde fuera. localhost solo funciona en ese mismo equipo, y direcciones como 192.168.x.x, solo dentro de esa red.

Un túnel resuelve este problema. Ejecutas un comando en tu equipo y crea una dirección pública (por ejemplo, https://xxxx.trycloudflare.com) que redirige a tu máquina. No hay que tocar la configuración del router. Registra esa dirección como URL de tu worker y listo.

Dos opciones populares son Cloudflare Tunnel y ngrok. Ten en cuenta que los trabajos no se pueden entregar mientras tu equipo esté apagado o el túnel cerrado, y que la dirección temporal que obtienes sin cuenta cambia cada vez que lo inicias. Encontrarás los detalles en la guía de tareas.

Un detalle importante: poner directamente la dirección de una API interna que ya tienes como URL del worker no funciona. 3Min API envía las solicitudes con un formato fijo y espera que le devuelvas el resultado cuando el trabajo termina. Por eso necesitas la capa fina de la que hablábamos entre tu sistema actual y 3Min API.

En el fondo, las tareas son solo solicitudes HTTP

Las tareas no usan ningún protocolo especial. Son el mismo tipo de solicitudes que los webhooks y las llamadas a la API del artículo anterior, solo que van pasando en orden:

Paso	De → A	Qué ocurre	Llamadas contadas
—	IA → 3Min API	Consultar los workers (si hace falta)	1
①	IA → 3Min API	Encargar el trabajo	1
②	3Min API → worker	Entregarlo al worker (se reintenta si falla)	No cuenta
③	Worker → 3Min API	Enviar el resultado (el progreso es opcional)	1 por envío
④	IA → 3Min API	Revisar el resultado	1–2

La clave está en el paso ②. La entrega es 3Min API haciendo por ti lo que antes hacía un webhook. Si el webhook de un endpoint te envía datos que llegan de fuera, la entrega de una tarea le envía a tu worker un trabajo que encargó tu IA. Usa el mismo sistema de firma que los webhooks, y ni las entregas ni los reintentos cuentan como llamadas.

Así, tu worker nunca tiene que preguntar "¿Hay trabajos nuevos?". El trabajo simplemente llega cuando lo hay. Sin actualizaciones de progreso, una tarea completa usa 3–5 llamadas, contando la consulta de workers. Compáralo con las 43.200 llamadas al mes que se van en consultar cada minuto.

Endpoints o tareas: ¿cuándo usar cada uno?

• Si quieres recibir, guardar y recopilar datos → endpoints (webhooks y polling)
• Si quieres que tu IA haga trabajo en tus sistemas y te traiga el resultado → tareas

Uno no sustituye al otro. Si tu worker guarda su resultado en un endpoint, tu IA también puede encargarse de procesar los datos que llegan y dejarlos archivados. Funcionan mejor juntos.

En resumen

• Los webhooks necesitan una dirección de entrega, y una conversación con la IA no la tiene
• El polling encaja con las conversaciones con la IA, pero el lado que hace el trabajo gasta llamadas en consultas vacías
• Las tareas siguen el flujo encargar → entregar → revisar después. 3Min API se encarga de la entrega y del registro; el trabajo lo hacen los workers que conectas
• No hace falta crear un worker desde cero. Cualquier cosa que pueda recibir y enviar solicitudes puede conectarse a lo que ya tienes

Una tarea puede durar hasta 24 horas. En la guía de tareas encontrarás cómo registrar un worker, el formato de las solicitudes y los límites de cada plan. Cuando quieras, abre Tareas en tu Panel para empezar.

¿Dónde puedes usar las tareas ahora mismo? (a 16 de septiembre de 2026)

• Claude, Cursor y herramientas similares — abre una conversación (sesión) nueva y las herramientas de tareas estarán listas. Puede que no aparezcan en una conversación que ya tenías abierta, así que empieza una nueva
• ChatGPT — las herramientas de tareas todavía no están disponibles. Cuando se añaden herramientas nuevas a una app de ChatGPT, tiene que pasar de nuevo la revisión de OpenAI, que suele tardar entre 2 y 4 semanas. En cuanto la aprueben, avisaremos por correo a los miembros de 3Min API
• ¿Quieres probarlo ya en ChatGPT? — activa el modo desarrollador en los ajustes de ChatGPT, añade una app tú mismo e introduce la dirección MCP https://3minapi.com/api/mcp. Podrás usarlo al momento