Automatice Transept con activadores de webhook

Abra un flujo de trabajo guardado en el creador y fíjese en la tarjeta de activación de la parte superior —la que dice Usted lo ejecuta manualmente. Es un interruptor. Manual es la opción predeterminada: usted mismo pulsa Ejecutar. Webhook le asigna al flujo de trabajo una URL privada a la que un sistema externo envía una solicitud POST, de modo que la ejecución se inicia por su cuenta. Un activador pertenece a un flujo de trabajo guardado, así que guárdelo primero; la opción Webhook permanece desactivada en los borradores sin guardar.

Cambie la tarjeta a Webhook, establezca sobre qué se ejecuta el disparo (más abajo) y guarde. Transept genera una URL secreta para este Workflow concreto y la muestra una sola vez — cópiela en ese momento, ya que solo se guarda un hash y la URL completa no podrá volver a mostrarse. El secreto reside en la URL en lugar de en un encabezado, porque los emisores más sencillos no pueden configurar encabezados; así que trate la URL como una contraseña: cualquiera que la tenga podrá iniciar la ejecución.

Vuelva a abrir la tarjeta más tarde y verá un prefijo oculto (whk_live_…) en lugar de la URL completa, además de una acción de Rotar. Al rotar se genera una URL nueva y se invalida la antigua en cuanto confirme; así es como se retira un enlace que se haya filtrado. También puede desactivar el activador sin borrarlo, o eliminarlo por completo. La tarjeta muestra cuándo se disparó por última vez.

Dos ajustes determinan qué procesa el flujo de trabajo cuando se activa la URL:

• Destino: un documento fijo que usted indique (cada disparo se aplica a ese documento y a su grupo de idiomas) o la página de Notion especificada en el payload entrante (Transept la asocia con su documento e importa la página la primera vez que la detecta).
• Idiomas: todas las versiones de idioma (opción predeterminada; la ejecución se extiende a todos los idiomas del destino como una ejecución en grupo) o solo ese documento.
• Solo contenido actualizado: activado por defecto, ya que una ejecución automatizada solo debería volver a procesar lo que haya cambiado desde la última vez, en lugar de volver a traducir todo el documento con cada disparo. Consulte Ejecutar solo lo que ha cambiado.

Una automatización de base de datos de Notion puede llamar al activador con su acción Enviar webhook: apunte la acción a la URL del activador y, cada vez que se ejecute la automatización, Transept ejecutará el Workflow en la página que la activó. Hay dos cosas que conviene saber antes de confiar en este sistema.

En primer lugar, las automatizaciones de Notion se activan ante un cambio de propiedad (o una página nueva), no solo al editar el cuerpo —por lo que editar el texto de una página podría no disparar nada. El patrón más fiable consiste en una propiedad de Estado que la automatización vigile: cámbiela (por ejemplo, a Listo para traducir) y ese cambio será la señal.

En segundo lugar, un webhook de Notion solo identifica la página —nunca transmite su contenido—, por lo que Transept lee la página a través de su conexión de Notion, a la cual debe concederse acceso a la base de datos dentro de Notion. Ambos pasos (conectar Notion y luego compartir la base de datos con la integración) se detallan en la sección «Activadores de Notion: dar acceso a Transept» de Automatizar Transept con la API. Si omite cualquiera de los dos, cada disparo será rechazado con un error de acceso.

Cualquier sistema capaz de enviar un POST HTTP puede activar el disparador: un paso de Zapier o n8n, un trabajo de CI o un curl al final de una compilación. Para un destino de documento fijo, el cuerpo no importa, por lo que basta con un POST vacío; solo un destino de página de Notion lee el cuerpo para saber qué página ha cambiado. No se requiere el encabezado Authorization; el secreto es la propia URL.

Por defecto, un disparo ejecuta el Workflow en todas las versiones de idioma y —con la opción Solo contenido actualizado activada— solo vuelve a traducir los bloques cuyo origen haya cambiado desde la última ejecución; así, una pequeña edición cuesta un puñado de bloques, no el documento entero. Las ejecuciones iniciadas de esta forma facturan palabras exactamente igual que el editor de la aplicación y, si el saldo no cubre la ejecución, no se procesa ni se factura nada.

Un paso configurado para esperar a su revisión seguirá deteniéndose: el disparo traduce hasta ese punto de control y luego se pausa, y el idioma aparece en el panel «Listos para revisión» del editor para que usted lo apruebe; la automatización no se salta sus controles de revisión. Y cuando un destino de página de Notion no se puede leer (normalmente porque la base de datos no se compartió con la integración), la tarjeta del activador muestra el último fallo como una nota de «no se pudo leer la página de Notion», con su marca de tiempo, para que pueda ver por qué un disparo no hizo nada.