Automatiza Transept con activadores de webhook

Abre un flujo de trabajo guardado en el editor y fíjate en la tarjeta del activador de la parte superior, la que dice Lo ejecutas manualmente. Es un selector. Manual es la opción predeterminada: tú mismo pulsas Ejecutar. Webhook le proporciona 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 sí sola. Un activador pertenece a un flujo de trabajo guardado, así que primero guarda el flujo de trabajo — la opción de Webhook permanecerá desactivada en los borradores sin guardar.

Cambia la tarjeta a Webhook, define sobre qué actúa la ejecución (más abajo) y guarda los cambios. Transept genera una URL secreta para este flujo de trabajo específico y la muestra una sola vez; cópiala en ese momento, ya que solo se almacena un hash y la URL completa no podrá volver a mostrarse. El secreto reside en la propia URL y no en un encabezado, ya que los emisores más sencillos no permiten configurar encabezados; por tanto, trata la URL como una contraseña: cualquiera que la tenga podrá iniciar la ejecución.

Si vuelves a abrir la tarjeta más adelante, verás un prefijo enmascarado (whk_live_…) en lugar de la URL completa, además de la acción Rotar. Al rotarla, se genera una URL nueva y la anterior queda invalidada en cuanto confirmas la acción; así es como se anula un enlace que se haya filtrado. También puedes desactivar el activador sin borrarlo, o eliminarlo por completo. La tarjeta muestra cuándo se activó por última vez.

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

• Destino — un documento fijo que especifiques (cada activación se aplica a ese documento y a su grupo de idiomas), o la página de Notion indicada en la carga útil recibida (Transept la asocia con tu documento e importa la página la primera vez que la detecta).
• Idiomas — todas las versiones de idioma (la opción predeterminada; la ejecución se propaga por todos los idiomas del destino como una ejecución de grupo) o solo un documento.
• Solo contenido actualizado — activado por defecto, ya que una ejecución automatizada solo debe procesar lo que haya cambiado desde la última vez, en lugar de volver a traducir todo el documento con cada activación. Consulta Ejecutar solo lo que ha cambiado.

Una automatización de base de datos de Notion puede llamar al activador mediante su acción Enviar webhook: apunta la acción a la URL del activador y, cada vez que se ejecute la automatización, Transept ejecutará el flujo de trabajo en la página que la activó. Hay dos cosas que conviene saber antes de empezar a usarlo.

En primer lugar, las automatizaciones de Notion se activan con un cambio de propiedad (o al crear una página nueva), no solo con la edición del contenido — por lo que es posible que editar el texto de una página no active nada. El método más fiable es usar una propiedad de Estado que la automatización vigile: cámbiala (por ejemplo, a Listo para traducir) y ese cambio servirá de señal.

En segundo lugar, un webhook de Notion solo identifica la página —nunca incluye su contenido—, por lo que Transept lee la página a través de tu conexión de Notion, a la cual se le debe conceder acceso a la base de datos dentro de Notion. Ambos pasos (conectar Notion y, después, 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 omites cualquiera de ellos, cada activación será rechazada con un error de acceso.

Cualquier herramienta capaz de enviar una solicitud HTTP POST puede accionar el activador: un paso de Zapier o n8n, una tarea 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 es necesario incluir un encabezado Authorization: el secreto es la URL completa.

Por defecto, una activación ejecuta el flujo de trabajo 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 solo consume unos pocos bloques en lugar de todo el documento. Las ejecuciones iniciadas de esta forma facturan las palabras exactamente igual que el editor de la aplicación y, si el saldo no es suficiente para cubrir la ejecución, no se envía ni se factura nada.

Si un paso está configurado para esperar a tu revisión, el proceso se detiene igualmente: la activación traduce hasta ese punto y se queda a la espera, y el idioma aparece en el panel de Listos para revisión del editor para que lo apruebes; la automatización no se salta tus puntos de control de revisión. Además, cuando no se puede leer un destino de página de Notion (normalmente porque la base de datos no se compartió con la integración), la tarjeta del activador muestra el último fallo con la nota «no se pudo leer la página de Notion» y su marca de tiempo, para que puedas ver por qué una activación no hizo nada.

Sí. Configura el destino del activador como «el cuerpo de la solicitud es el contenido» y cualquier cosa que envíes mediante un POST a la URL se convertirá en el documento: Markdown puro, HTML o texto sin formato (envía el Content-Type correspondiente), o un JSON como {"content": "…", "content_type": "markdown"}. Elige para cada activador si cada envío crea un nuevo documento o actualiza un documento fijo —una actualización reajusta el contenido para que solo se vuelvan a traducir los bloques modificados. Así es como una plataforma de correo electrónico, un paso de Zapier/n8n o cualquier script envían una plantilla o un artículo directamente a un flujo de trabajo de traducción sin necesidad de cargarlos manualmente. Los envíos reintentados se deduplican durante 24 horas; incluye un external_id en el JSON (el ID de tu mensaje) para un control preciso. Cuerpos de hasta 10 MB.