Ejecutar código personalizado con workers (beta)

Los Workers de Notion son 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 agentes personalizados

• Activadores de webhook

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

• De forma predeterminada, los Workers están habilitados para el espacio de trabajo (solo 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 intentas implementar o administrar un Worker, normalmente 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, usa la CLI de Notion o la herramienta de programación de tu equipo. Descubre más sobre el modo desarrollador →

Descubre más sobre los precios para los workers en 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 actualizada 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 comunes:

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

• Sincroniza cuentas de Salesforce en un registro de procesos.

• Sincroniza datos de una herramienta o base de datos interna.

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

Las herramientas para agentes (impulsadas por workers) amplían lo que tus agentes personalizados pueden hacer más allá de las acciones integradas de Notion y MCP, con capacidades adaptadas a la forma de trabajar de tu equipo.

Algunos ejemplos comunes:

• Consultar un almacén de datos.

• Generar recursos a partir de un documento de Notion.

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

Los activadores de webhook (impulsados por workers) permiten que un evento en otra herramienta inicie un flujo de trabajo en Notion o en cualquier otro sistema conectado.

Algunos ejemplos comunes:

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

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

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

Una vez configurado, el flujo de trabajo se ejecuta automáticamente cada vez que ocurre el evento, para que tu equipo no tenga que mover 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. Usa esta vista para comprobaciones rápidas y acciones básicas. En Notion, puedes:

• Ve todos los Workers en una lista.

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

• Lee los registros de un Worker.

• Desactiva o elimina un Worker.

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

De forma predeterminada, solo la persona que creó un Worker puede modificarlo y agregarlo 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 administrarlo.

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

Prueba estos pasos en el orden indicado:

1. Asegúrate de que tu espacio de trabajo sea elegible y de que un propietario del espacio de trabajo haya habilitado los Workers. Los Workers están disponibles en los planes Business y Enterprise, y requieren habilitar por parte de un admin del espacio de trabajo.

2. Confirma que estás utilizando la ruta de configuración prevista. Para la mayoría de las configuraciones, usará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, generalmente se trata de un problema de permisos o de configuración del espacio de trabajo.

5. Si el costo 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. Comienza con una frecuencia más baja y luego aumenta cuando estés seguro de que funciona.

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