Ejecutar código personalizado con workers (beta)

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

• Sincronización de bases de datos

• Herramientas para agentes personalizados

• Activadores de webhook

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

• Un propietario del espacio de trabajo debe activar los workers para el espacio de trabajo.

• Si intentas implementar o administrar un worker, normalmente deberás seguir la documentación para desarrolladores y utilizar la CLI de Notion.

Descubre más sobre los precios para los workers en este artículo.

La sincronización de bases de datos (impulsada por Workers) incorpora información de herramientas externas en una base de datos de Notion y la mantiene actualizada automáticamente. Una vez configurada, la base de datos sincronizada se mantiene actualizada automáticamente, para que tu equipo y tus agentes siempre vean la información más recientes sin necesidad de copiar y pegar datos entre herramientas.

Algunos ejemplos comunes:

• Sincronizar 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 los permisos de uso compartido 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.

Prueba estos pasos en el orden indicado:

1. Asegúrate de que tu espacio de trabajo cumpla con los requisitos y de que el propietario del espacio de trabajo haya activado los workers. Los workers están disponibles en los planes Business y Enterprise, y requieren la habilitación de un administrador del espacio de trabajo.

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

3. Si la implementación de tu worker falla, verifica los permisos. Es posible que no tengas acceso para realizar la implementació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 realizar la acción de forma manual. Si no puedes realizar la misma modificación en Notion, probablemente se deba a un problema de permisos o de configuración del espacio de trabajo.

5. Si el costo parece superior al esperado, reduce la frecuencia de ejecución. Los workers que se ejecutan con mayor frecuencia costarán más. Comience con una frecuencia menor y auméntela una vez que tenga la certeza de que funciona correctamente.

6. ¿Aún tienes problemas? Consulta la documentación para desarrolladores para encontrar el mensaje de error específico. Allí encontrarás la solución más precisa.