Rozwiązanie problemów z webhookami w Workspace Studio

Utworzyłeś przepływ w Google Workspace Studio, dodałeś krok Wyślij webhook A żądanie nigdy nie dociera do celu. Albo może przepływ działał, a teraz pojawia się błąd. Zanim bezmyślnie zmienisz adres URL, warto to zbadać. W którym momencie egzekucja się kończy?: dostęp do kroku, oczekujące zatwierdzenie, konfiguracja żądania lub odpowiedź z usługi zewnętrznej.

Workspace Studio używa tego kroku do wysyłania Żądanie HTTP do określonego adresuMożna go użyć do powiadomienia narzędzia wewnętrznego, utworzenia rekordu w innej aplikacji lub wysłania danych do usługi, która nie ma bezpośredniego łącznika. Rozwiązanie zależy od tego, czy blokada występuje w Google Workspace, czy na serwerze odbierającym żądanie.

Sprawdź, czy administrator włączył webhooki

Si Wyślij webhook Nie pojawia się wśród dostępnych kroków; zacznij od uprawnień organizacji. Google wskazuje, że ta funkcja jest... domyślnie wyłączone i że administrator musi włączyć tę funkcję dla odpowiedniej jednostki organizacyjnej. Ścieżka: Konsola administracyjna > Aplikacje > Google Workspace > Workspace Studio > Ustawienia webhooka.

Sprawdź również, czy Twoje konto ma dostęp do tej funkcji: Google nadal identyfikuje przekazywanie webhooków jako funkcję w ograniczony podglądJeśli nie jesteś administratorem, podaj administratorowi Workspace nazwę brakującego kroku, swoje konto oraz jednostkę organizacyjną, do której należysz. Umożliwi mu to weryfikację odpowiednich ustawień bez wpływu na uprawnienia w innych zespołach.

Przejrzyj listę dozwolonych adresów URL i zatwierdzeń

W niektórych edycjach administrator może ograniczyć miejsca docelowe zewnętrzne za pomocą lista dozwolonych domen i adresów URLJeśli krok istnieje, ale nie możesz połączyć się z konkretnym punktem końcowym, sprawdź, czy Twoja domena lub adres URL znajduje się na tej liście. To ustawienie jest zarządzane z poziomu opcji importowania i pobierania adresów URL w Dysku i Dokumentach.

To ograniczenie Nie działa to tak samo we wszystkich edycjachLista dozwolonych webhooków jest dostępna w edycjach takich jak Business Plus, Enterprise Standard i Plus oraz Education Standard i Plus. W edycjach, które nie oferują tej kontroli, włączenie webhooków umożliwia połączenia z prawidłowymi adresami URL bez stosowania tej listy dozwolonych. Dlatego zaleca się najpierw sprawdzenie swojej edycji i polityki obowiązującej w organizacji.

Przepływ może również czekać na zatwierdzenie użytkownikaGoogle traktuje wysyłanie danych do zewnętrznego punktu końcowego jako działanie wrażliwe i domyślnie wymaga weryfikacji i potwierdzenia. Jeśli automatyzacja wydaje się zablokowana, otwórz Studio i sprawdź, czy są jakieś oczekujące żądania zatwierdzenia, zanim stwierdzisz, że serwer uległ awarii.

Skonfiguruj poprawnie adres URL, metodę i wysyłane dane.

Otwórz przepływ w studio.workspace.google.com i sprawdź krok „Wyślij webhook”. Adres powinien być kompletne i statycznePole akceptuje adres URL rozpoczynający się od http:// o https://ale nie pozwala na wstawianie zmiennych do samego adresu URL. Zalecaną opcją jest HTTPS aby uniknąć przesyłania niezaszyfrowanych informacji; nie jest to wymóg tej dziedziny.

• Metoda HTTP: Wybierz opcję oczekiwaną przez docelowe API. Studio oferuje metody GET, POST, PUT, PATCH i DELETE; domyślna jest metoda POST.
• Treść prośby: Jest opcjonalny i wysyłany jako tekst. W przypadku wielu interfejsów API zaleca się używanie formatu JSON, z zachowaniem cudzysłowów, nawiasów klamrowych i nazw pól wymaganych przez usługę.
• Zmienne: Możesz uwzględnić dane z poprzednich kroków w treści. Sprawdź wynik, gdy zmienna zawiera cudzysłowy, podziały wiersza lub inne znaki, które mogą zakłócać format JSON.
• Żądania GET: Studio ignoruje treść żądania za pomocą tej metody. Jeśli usługa wymaga danych w treści, sprawdź, którą metodę obsługuje jej dokumentacja.

Zrób wykonanie testu Pamiętaj, że wyśle ​​faktyczne żądanie do miejsca docelowego. Jeśli krok się powiedzie, jego odpowiedź stanie się dostępna jako zmienna tekstowa do późniejszego wykorzystania w tym samym przepływie.

Aby zlokalizować problem, skorzystaj z zakładki Aktywność

Po każdym wykonaniu otwórz Działalność w Workspace Studio. Jeśli żądanie zakończyło się powodzeniem, możesz przejrzeć wysłane dane i otrzymaną odpowiedź. Jeśli nie, Studio wyświetli kod błędu i odpowiedź adresu URL docelowegoInformacje te pozwalają nam odróżnić problem z konfiguracją przepływu od odrzucenia spowodowanego przez usługę zewnętrzną.

Un 400 Zwykle oznacza to, że odbiorca nie akceptuje żądania w takiej formie, w jakiej zostało napisane; w takim przypadku dokonuje on przeglądu metody i treści. W przypadku 401 lub 403Sprawdź wymagania dostępu do usługi i ograniczenia obowiązujące w Twojej organizacji. 404 Monituje o sprawdzenie trasy punktu końcowego. Jeśli 429Sprawdź limity żądań; błędy 5xx Zazwyczaj wskazują one na problem z usługą odbiorczą. Konkretna odpowiedź z punktu końcowego jest bardziej przydatna niż interpretacja numeru w oderwaniu od kontekstu.

Administratorzy mogą również zapoznać się z Dzienniki zdarzeń Workspace Studio w celu zbadania żądań webhook. Dostęp do niektórych danych, takich jak żądany adres URL, jest ograniczony, ponieważ mogą one zawierać poufne informacje.

Nie należy mylić webhooku Studio z przychodzącym webhookiem Google Chat.

Krok Wyślij webhook Workspace Studio wysyła żądanie do zewnętrznego adresu URL. przychodzący webhook Google ChatW przeciwieństwie do tego, jest to adres URL utworzony w przestrzeni, z którego inny system może publikować tam wiadomości. Są to oddzielne elementy, chociaż adres URL czatu można wykorzystać jako miejsce docelowe dla przepływu Studio.

Jeśli Twoim celem jest zamieszczenie reklamy w Google Chat, najpierw sprawdź, czy krok 1 jest wystarczający. Publikuj w przestrzeni ze Studio. Jeśli potrzebujesz użyć przychodzącego webhooka, musisz go utworzyć Aplikacje i integracje przestrzeni i zachować jej adres URL, który zawiera klucz i token, w prywatności. Te webhooki służą do wysyłania wiadomości do przestrzeni, ale nie umożliwiają konwersacji z użytkownikami.

Usługa Google Chat stosuje współdzielony limit do przychodzących webhooków. jedno żądanie na sekundę i na przestrzeńTen limit dotyczy czatu; nie jest to ogólny limit dla kroku „Wyślij webhook” w Workspace Studio. Jeśli błąd występuje podczas publikowania wielu ogłoszeń z rzędu w tej samej przestrzeni, sprawdź ten limit wraz z odpowiedzią na żądanie.

Jeśli błędy występują sporadycznie, sprawdź limity przepływu.

W Workspace Studio możesz utworzyć do 25 przepływów na użytkownika, z maksymalnie 20 kroków na przepływDodatkowo, obowiązuje łączny limit liczby wykonań w ciągu każdego 24-godzinnego okresu. Po osiągnięciu tego limitu, dalsze wykonania zakończą się niepowodzeniem, aż do zresetowania licznika.

Jeśli webhook zawodzi dopiero po wielu aktywacjach, sprawdź Działalność Sprawdź limity zarówno Studio, jak i usługi docelowej. Udoskonalenie wyzwalacza – na przykład ograniczenie go do określonych nadawców lub zdarzeń – może zapobiec niepotrzebnym żądaniom. Jeśli błąd wystąpi przy pierwszym uruchomieniu, zacznij od sprawdzenia uprawnień, oczekujących zatwierdzeń i odpowiedzi punktu końcowego.