Автоматизуйте Transept за допомогою вебхук-тригерів

Відкрийте збережений воркфлоу в конструкторі та подивіться на картку тригера вгорі — ту, де вказано Ви запускаєте його вручну. Це перемикач. Вручну — варіант за замовчуванням: ви самі натискаєте «Запустити». Вебхук надає воркфлоу приватну URL-адресу, на яку зовнішня система надсилає POST-запити, тому запуск відбувається автоматично. Тригер належить до збереженого воркфлоу, тому спочатку збережіть воркфлоу — опція «Вебхук» залишається неактивною в незбереженій чернетці.

Перемкніть картку на Вебхук, налаштуйте об'єкти, на які поширюється запуск (див. нижче), і збережіть. Transept згенерує секретну URL-адресу для цього конкретного воркфлоу та покаже її лише один раз — скопіюйте її одразу, оскільки зберігається лише хеш, і повну адресу більше ніколи не можна буде побачити. Секрет міститься прямо в URL-адресі, а не в заголовку, бо найпростіші сервіси відправки не вміють налаштовувати заголовки; тож ставтеся до URL як до пароля — будь-хто, хто його має, може ініціювати запуск.

Відкрийте картку пізніше, і ви побачите маскований префікс (whk_live_…) замість повної URL-адреси, а також дію Оновити. Оновлення (Rotate) створює нову URL-адресу та анулює стару в момент підтвердження — саме так можна відкликати посилання, якщо стався витік. Ви також можете вимкнути тригер, не видаляючи його, або прибрати його зовсім. На картці вказано час останнього спрацювання.

Два налаштування визначають, із чим працюватиме воркфлоу при зверненні до URL-адреси:

• Ціль — конкретний документ, який ви вказуєте (кожен запуск стосується цього документа та його мовної групи), або сторінка Notion, зазначена у вхідних даних (Transept зіставляє її з вашим документом, імпортуючи сторінку, коли бачить її вперше).
• Мови — усі мовні версії (варіант за замовчуванням; запуск охоплює кожну мову цілі як груповий запуск) або лише один документ.
• Лише оновлений контент — увімкнено за замовчуванням, оскільки автоматизований запуск має опрацьовувати лише те, що змінилося з минулого разу, а не перекладати весь документ заново при кожному спрацюванні. Див. Запуск лише для зміненого контенту.

Автоматизація бази даних Notion може викликати тригер за допомогою дії Send webhook: спрямуйте дію на URL-адресу тригера, і щоразу, коли спрацьовуватиме автоматизація, Transept запускатиме воркфлоу для сторінки, яка активувала тригер. Перед тим як покладатися на цей метод, варто врахувати два нюанси.

По-перше, автоматизації Notion спрацьовують при зміні властивості (або створенні нової сторінки), а не просто при редагуванні вмісту — тому зміна тексту на сторінці може нічого не запустити. Надійна схема — властивість Status, за якою стежить автоматизація: змініть її (наприклад, на Ready to translate), і ця зміна стане сигналом.

По-друге, вебхук Notion лише вказує на сторінку — він не передає її вміст — тому Transept зчитує сторінку через ваше підключення до Notion, якому потрібно надати доступ до бази даних у самому Notion. Обидва кроки (підключення Notion та надання інтеграції доступу до бази даних) описані в розділі «Тригери Notion: надання доступу Transept» інструкції Автоматизація Transept за допомогою API. Якщо пропустити будь-який із них, кожен запуск буде відхилено через помилку доступу.

Будь-який сервіс, здатний надіслати HTTP POST, може активувати тригер — крок у Zapier чи n8n, завдання CI або команда curl наприкінці збірки. Для цілі конкретний документ тіло запиту не має значення, тому достатньо порожнього POST-запиту; лише ціль сторінка Notion зчитує тіло запиту, щоб дізнатися, яка сторінка змінилася. Заголовок Authorization не потрібен — секретом є сама URL-адреса.

За замовчуванням запуск активує воркфлоу для усіх мовних версій, і — якщо ввімкнено «Лише оновлений контент» — перекладає лише ті блоки, оригінал яких змінився з моменту останнього запуску. Таким чином, невелике редагування коштуватиме лише кілька блоків, а не весь документ. Запуски, ініційовані таким чином, тарифікуються за словами точно так само, як у редакторі додатка; якщо балансу недостатньо для виконання, запуск не здійснюється і слова не списуються.

Крок, налаштований на очікування вашої перевірки, усе одно призупиняє процес: переклад виконується до цієї межі, а потім зупиняється, і мовна версія з'являється на панелі редактора «Готово до перевірки» для вашого схвалення — автоматизація не оминає ваші етапи перевірки. А якщо ціль сторінка Notion не може бути зчитана (зазвичай через те, що до бази даних не надано доступ інтеграції), у картці тригера відображається остання помилка з приміткою «не вдалося зчитати сторінку Notion» та міткою часу, щоб ви могли бачити, чому запуск не дав результату.