Automatyzacja Transeptu 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. Manual to opcja domyślna: wtedy sam klikasz przycisk Run. Webhook generuje dla przepływu pracy prywatny adres URL, na który system zewnętrzny wysyła żądanie POST, dzięki czemu proces uruchamia się automatycznie. Wyzwalacz jest przypisany do zapisanego przepływu pracy, więc najpierw go zapisz — w przypadku niezapisanej wersji roboczej opcja Webhook pozostaje nieaktywna.

Przełącz kartę na Webhook, określ zakres działania wyzwalacza (poniżej) i zapisz zmiany. Transept wygeneruje unikalny, tajny adres URL dla tego konkretnego przepływu pracy i wyświetli go tylko raz — skopiuj go od razu, ponieważ w systemie zapisywany jest jedynie hash i pełny adres nigdy nie zostanie wyświetlony ponownie. Klucz dostępu znajduje się bezpośrednio w adresie URL, a nie w nagłówku, ponieważ najprostsze systemy wysyłające żądania nie obsługują nagłówków. Traktuj ten adres jak hasło — każdy, kto go posiada, może wywołać przepływ pracy.

Gdy otworzysz kartę później, w miejscu pełnego adresu URL zobaczysz zamaskowany prefiks (whk_live_…) oraz opcję Rotate. Wybranie jej generuje nowy adres URL i unieważnia poprzedni natychmiast po potwierdzeniu — w ten sposób można wycofać link, który wyciekł. Wyzwalacz można również wyłączyć bez usuwania go lub całkowicie go skasować. Karta pokazuje, kiedy nastąpiło ostatnie wywołanie.

Dwa ustawienia określają, na co wpływa przepływ pracy w momencie wywołania adresu URL:

• Cel — wybrany przez Ciebie stały dokument (każde wywołanie dotyczy tego dokumentu i jego grupy językowej) lub strona Notion wskazana w przesłanych danych (Transept dopasowuje ją do Twojego dokumentu, importując stronę przy pierwszym wykryciu).
• Języki — wszystkie wersje językowe (opcja domyślna; uruchomienie obejmuje wszystkie języki docelowe w ramach uruchomienia grupowego) lub tylko ten jeden dokument.
• Tylko zaktualizowana treść — domyślnie włączone, ponieważ zautomatyzowane uruchomienie powinno przetwarzać ponownie tylko to, co zmieniło się od ostatniego razu, zamiast tłumaczyć cały dokument przy każdym wywołaniu. Zobacz: Uruchamiaj tylko dla zmian.

Automatyzacja bazy danych Notion może aktywować wyzwalacz za pomocą akcji Send webhook: wystarczy wskazać w niej adres URL wyzwalacza. Przy każdym uruchomieniu automatyzacji Transept wykona przepływ pracy na stronie, która wywołała akcję. Zanim zaczniesz korzystać z tego rozwiązania, warto wiedzieć o dwóch kwestiach.

Po pierwsze, automatyzacje Notion są uruchamiane przez zmianę właściwości (lub utworzenie nowej strony), a nie przez samą edycję treści – poprawienie tekstu na stronie może więc nie wywołać żadnej akcji. Sprawdzonym sposobem jest wykorzystanie właściwości Status, którą obserwuje automatyzacja: zmiana jej stanu (np. na Ready to translate) stanowi sygnał do uruchomienia procesu.

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

Wyzwalacz można aktywować za pomocą wszystkiego, co pozwala na wysłanie żądania HTTP POST — może to być krok w Zapier lub n8n, zadanie CI czy polecenie curl na końcu procesu budowania. W przypadku celu stały dokument treść żądania nie ma znaczenia, więc wystarczy pusty POST; jedynie cel strona Notion odczytuje treść, aby sprawdzić, która strona uległa zmianie. Nagłówek Authorization nie jest wymagany — funkcję klucza dostępu pełni cały adres URL.

Domyślnie wywołanie uruchamia przepływ pracy we wszystkich wersjach językowych, a — przy włączonej opcji „Tylko zaktualizowana treść” — tłumaczy ponownie tylko te bloki, których treść źródłowa zmieniła się od ostatniego razu. Dzięki temu drobna poprawka kosztuje zaledwie kilka bloków, a nie cały dokument. Uruchomienia rozpoczęte w ten sposób są rozliczane za słowa dokładnie tak samo jak w edytorze w aplikacji; jeśli saldo nie wystarczy na pokrycie kosztów, nic nie zostanie wysłane ani naliczone.

Krok ustawiony na oczekiwanie na Twoją recenzję nadal wstrzymuje bieg procesu: wywołanie realizuje tłumaczenie do tej bramki, a następnie zatrzymuje się, a dana wersja językowa pojawia się w panelu edytora „Gotowe do recenzji”, abyś mógł ją zatwierdzić — automatyzacja nie pomija Twoich bramek recenzji. Z kolei gdy cel typu strona Notion nie może zostać odczytany (zazwyczaj dlatego, że baza danych nie została udostępniona integracji), karta wyzwalacza wyświetla ostatnie niepowodzenie jako notatkę „nie można odczytać strony Notion” z sygnaturą czasową, co pozwala sprawdzić, dlaczego wywołanie nie przyniosło efektu.

Tak. Ustaw cel wyzwalacza na „treść żądania jest zawartością”, a wszystko, co prześlesz pod ten adres URL metodą POST, stanie się dokumentem: surowy Markdown, HTML lub zwykły tekst (wyślij odpowiedni nagłówek Content-Type) bądź obiekt JSON, taki jak {"content": "…", "content_type": "markdown"}. Dla każdego wyzwalacza wybierz, czy każde przesłanie danych tworzy nowy dokument, czy aktualizuje jeden stały dokument — aktualizacja ponownie dopasowuje treść, dzięki czemu tłumaczone są tylko zmienione bloki. W ten sposób platforma e-mailowa, krok Zapier/n8n czy dowolny skrypt przesyła szablon lub artykuł bezpośrednio do przepływu pracy tłumaczenia bez konieczności ręcznego wgrywania plików. Ponowione przesłania są deduplikowane przez 24 godziny; aby uzyskać pełną kontrolę, dołącz w JSON-ie parametr external_id (identyfikator Twojej wiadomości). Maksymalny rozmiar treści to 10 MB.