Automatyzacja Transept za pomocą wyzwalaczy webhook

Otwórz zapisany przepływ pracy w kreatorze i spójrz na kartę wyzwalacza u góry — tę z napisem Uruchamiasz go ręcznie. To przełącznik. Ręcznie to opcja domyślna: sam naciskasz przycisk Uruchom. Webhook nadaje przepływowi pracy prywatny adres URL, na który system zewnętrzny wysyła żądania POST, co sprawia, że proces uruchamia się automatycznie. Wyzwalacz jest przypisany do zapisanego przepływu pracy, więc najpierw go zapisz — opcja Webhook pozostaje nieaktywna w niezapisanych szkicach.

Przełącz kartę na Webhook, ustaw zakres działania wyzwalacza (poniżej) i zapisz. Transept wygeneruje tajny adres URL dla tego konkretnego przepływu pracy i wyświetli go tylko raz — skopiuj go wtedy, ponieważ przechowywany jest tylko skrót (hash) i pełny adres URL nigdy nie zostanie pokazany ponownie. Sekret znajduje się w adresie URL, a nie w nagłówku, ponieważ najprostsze systemy wysyłające nie obsługują nagłówków; traktuj więc ten adres jak hasło — każdy, kto go posiada, może uruchomić proces.

Po ponownym otwarciu karty zobaczysz zamaskowany prefiks (whk_live_…) zamiast pełnego adresu URL oraz akcję Rotuj. Rotacja generuje nowy adres URL i dezaktywuje stary w momencie potwierdzenia — w ten sposób można wycofać link, który wyciekł. Możesz także wyłączyć wyzwalacz bez jego usuwania lub całkowicie go skasować. Karta pokazuje czas ostatniego uruchomienia.

Dwa ustawienia decydują o tym, czego dotyczy Workflow po wywołaniu adresu URL:

• Cel – konkretny dokument wskazany przez Ciebie (każde wywołanie dotyczy tego dokumentu i jego grupy językowej) lub strona Notion wskazana w przychodzących danych (Transept dopasowuje ją do Twojego dokumentu, importując stronę przy pierwszym wykryciu).
• Języki – wszystkie wersje językowe (domyślnie; proces obejmuje wszystkie języki celu jako uruchomienie grupowe) lub tylko ten jeden dokument.
• Tylko zaktualizowana treść – domyślnie włączone, ponieważ automatyczne uruchomienie powinno przetwarzać tylko to, co zmieniło się od ostatniego razu, zamiast tłumaczyć cały dokument przy każdym wywołaniu. Zobacz Uruchamiaj tylko to, co zmienione.

Automatyzacja bazy danych Notion może wywołać wyzwalacz za pomocą akcji Wyślij webhook: skieruj akcję na adres URL wyzwalacza, a za każdym razem, gdy automatyzacja zostanie uruchomiona, Transept uruchomi przepływ pracy dla strony, która wywołała akcję. Zanim zaczniesz na tym polegać, warto wiedzieć o dwóch rzeczach.

Po pierwsze, automatyzacje Notion uruchamiają się przy zmianie właściwości (lub utworzeniu nowej strony), a nie przy samej edycji treści – zatem sama edycja tekstu na stronie może niczego nie wywołać. Niezawodnym sposobem jest monitorowanie przez automatyzację właściwości Status: jej zmiana (np. na Gotowe do tłumaczenia) stanowi sygnał do działania.

Po drugie, webhook Notion jedynie wskazuje stronę – nigdy nie przesyła jej treści – dlatego Transept odczytuje stronę poprzez Twoje połączenie z Notion, które musi mieć przyznany dostęp do bazy danych wewnątrz Notion. Oba kroki (połączenie z Notion, a następnie udostępnienie bazy danych integracji) zostały opisane w sekcji „Wyzwalacze Notion: przyznawanie dostępu Transept” w artykule Automatyzacja Transept przez API. Pominięcie któregokolwiek z nich sprawi, że każde wywołanie zostanie odrzucone z powodu błędu dostępu.

Wszystko, co potrafi wysłać żądanie HTTP POST, może uruchomić wyzwalacz – krok w Zapier lub n8n, zadanie CI czy polecenie curl na końcu procesu budowania. W przypadku celu typu konkretny dokument treść żądania nie ma znaczenia, więc wystarczy pusty POST; jedynie cel typu strona Notion odczytuje treść, aby dowiedzieć się, która strona uległa zmianie. Nagłówek Authorization nie jest wymagany – kluczem zabezpieczającym jest cały adres URL.

Domyślnie wywołanie uruchamia Workflow we wszystkich wersjach językowych i – przy włączonej opcji Tylko zaktualizowana treść – tłumaczy ponownie tylko te bloki, których źródło zmieniło się od ostatniego uruchomienia. Dzięki temu drobna edycja kosztuje zaledwie kilka bloków, a nie cały dokument. Uruchomienia w ten sposób rozliczają słowa dokładnie tak samo, jak edytor w aplikacji, a jeśli saldo nie pozwala na pokrycie kosztów, nic nie zostaje wysłane ani naliczone.

Krok ustawiony na oczekiwanie na Twoją recenzję nadal wstrzymuje proces: wywołanie tłumaczy treść do tego momentu, a następnie zatrzymuje się, a wersja językowa pojawia się w panelu „Gotowe do recenzji” w edytorze do zatwierdzenia – automatyzacja nie omija Twoich etapów recenzji. Z kolei gdy nie można odczytać celu typu strona Notion (zazwyczaj dlatego, że baza danych nie została udostępniona integracji), karta wyzwalacza wyświetla ostatni błąd jako notatkę „nie udało się odczytać strony Notion” z sygnaturą czasową, co pozwala sprawdzić, dlaczego wywołanie nic nie zrobiło.