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 e incluyen estas funciones:

• 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.

• Un propietario del espacio de trabajo debe activar los workers en dicho espacio.

• 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.

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

La sincronización basada en workers incorpora información de herramientas externas a una base de datos de Notion y la mantiene actualizada de forma automática. Una vez configurada, la base de datos sincronizada se actualiza sola, de modo que tu equipo y tus agentes siempre verán los datos más recientes sin tener que copiar ni pegar información 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 activada, la base de datos sincronizada funciona como cualquier otra base de datos en Notion. El acceso se rige por tus permisos de uso compartido 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.

Prueba estos pasos en orden:

1. Comprueba que tu espacio de trabajo cumple los requisitos y que el propietario ha activado los workers. Los workers están disponibles en los planes Business y Enterprise, y debe activarlos un administrador del espacio.

2. Verifica que estás utilizando la ruta de configuración adecuada. Para la mayoría de las configuraciones, deberás utilizar la CLI de Notion y la documentación para desarrolladores.

3. Seguidamente, si la implementación de tu worker falla, comprueba los permisos. Es posible que no tengas los necesarios para llevar a cabo esa acción en ese espacio de trabajo, incluso si puedes ver las páginas que contiene.

4. Si tu worker se ejecuta, pero no modifica nada en Notion, prueba primero a ejecutar la acción de forma manual. Si no puedes realizar el mismo cambio en Notion, lo más probable es que se trate de un problema de permisos o de configuración del espacio de trabajo.

5. Si el coste supera tus previsiones, reduce la frecuencia de ejecución. A mayor uso de los workers, mayor coste. Te recomendamos empezar poco a poco e ir aumentando dicha frecuencia cuando tengas claro que todo funciona bien.

6. ¿Sigues sin poder avanzar? Consulta la documentación para desarrolladores correspondiente al mensaje de error en cuestión. Allí encontrarás la solución precisa.