Ejecuta código personalizado con los workers (beta)

Los Workers de Notion forman parte de nuestra Plataforma para desarrolladores. Ejecutan código personalizado en la infraestructura de Notion para potenciar:

• Sincronización de bases de datos

• Herramientas para los agentes personalizados

• Disparadores de webhooks

• Los workers están disponibles en los planes Business y Enterprise.

• Por defecto, los Workers están activados para el espacio de trabajo (solo para propietarios).

• Los propietarios del espacio de trabajo pueden:

  • Limitar la creación de Workers solo a los propietarios.

  • Permitir que miembros o grupos específicos creen Workers.

  • Desactivar los Workers para el espacio de trabajo.

• Si estás intentando implementar o gestionar un Worker, por lo general, deberás seguir nuestra documentación para desarrolladores y utilizar la CLI de Notion.

• Puedes activar el Modo desarrollador para ver los Workers en Notion, leer registros y desactivar o eliminar Workers. Para implementar un Worker o cambiar su código o configuración, utiliza la CLI de Notion o la herramienta de programación de tu equipo. Más información sobre el modo desarrollador →

Para obtener más información sobre los precios de los workers, consulta este artículo.

La sincronización de bases de datos (impulsada por Workers) trae información de herramientas externas a una base de datos de Notion y la mantiene actualizada automáticamente. Una vez configurada, la Base de datos sincronizada se mantiene al día por sí sola, por lo que tu equipo y tus agentes siempre ven los datos más recientes sin que nadie tenga que copiar y pegar entre herramientas.

Algunos ejemplos habituales:

• Sincronizar los tickets de soporte de Zendesk en una base de datos de clasificación.

• Sincronizar cuentas de Salesforce en una herramienta de seguimiento de procesos.

• Sincronizar información de una herramienta o base de datos interna.

Una vez que está activa, la Base de datos sincronizada se comporta como cualquier otra base de datos en Notion. El acceso se rige por los permisos para compartir estándar de Notion.

Las herramientas para agentes (basadas en workers) amplían el potencial de tus agentes personalizados más allá de las acciones integradas de Notion y de MCP, con funciones adaptadas a la forma de trabajar de tu equipo.

Algunos ejemplos habituales:

• Formular una consulta a un almacén de datos.

• Generar recursos a partir de un documento de Notion.

• Operar en otra aplicación que no sea compatible de forma nativa o que no esté disponible a través de MCP.

Los disparadores de webhooks (basados en workers) permiten que un evento en otra herramienta active un flujo de trabajo en Notion o en cualquier otro sistema conectado.

Algunos ejemplos habituales:

• Cerrar una tarea cuando se fusiona una solicitud de extracción.

• Actualizar un registro de CRM cuando cambie una suscripción.

• Crear un documento de incorporación cuando se firme una oferta.

Una vez configurado, el flujo de trabajo se ejecuta automáticamente cada vez que se produce el evento, de modo que tu equipo no tiene que trasladar la información entre herramientas de forma manual.

Con el Modo desarrollador, puedes abrir los Workers desde la sección de desarrollador en tu barra lateral. Utiliza esta vista para comprobaciones rápidas y acciones básicas. En Notion, puedes:

• Ver todos los Workers en una lista.

• Abrir un Worker y ver la descripción general, los registros, las variables de entorno y la configuración.

• Leer los registros de un Worker.

• Desactivar o eliminar un Worker.

Para implementar un Worker o cambiar su código o configuración, utiliza la CLI de Notion o la herramienta de programación de tu equipo.

Por defecto, solo la persona que creó un Worker puede modificarlo y añadirlo como una nueva conexión. Comparte un Worker con tus compañeros de equipo para que puedan conectarlo a un Agente Personalizado o ayudar a gestionarlo.

Más información sobre cómo compartir un Worker →

Prueba estos pasos en orden:

1. Asegúrate de que tu espacio de trabajo sea apto y de que un propietario del espacio de trabajo haya activado los Workers. Los Workers están disponibles en los planes Business y Enterprise, y requieren que un administrador del espacio de trabajo los habilite.

2. Confirma que estás utilizando la ruta de configuración prevista. Para la mayoría de las configuraciones, utilizarás la CLI de Notion además de la documentación para desarrolladores.

3. Si la implementación de tu Worker falla, comprueba los permisos a continuación. Es posible que no tengas acceso para implementar en ese espacio de trabajo, incluso si puedes ver páginas en él.

4. Si tu Worker se ejecuta pero no cambia nada en Notion, prueba la acción manualmente primero. Si no puedes realizar el mismo cambio en Notion, normalmente se trata de un problema de permisos o de configuración del espacio de trabajo.

5. Si el coste parece más alto de lo esperado, reduce la frecuencia de ejecución. Los Workers que se ejecutan con más frecuencia costarán más. Empieza con una programación más lenta y auméntala una vez que estés seguro de que funciona.

6. ¿Sigues atascado? Sigue la documentación para desarrolladores para el mensaje de error específico, que tendrá la solución más precisa.