Рішення для збоїв Webhook у Workspace Studio

Ви створили потік у Google Workspace Studio та додали крок Надіслати вебхук І запит так і не досягає місця призначення. Або, можливо, потік працював, а тепер сталася помилка. Перш ніж сліпо змінювати URL-адресу, варто провести дослідження. У який момент виконання зупиняється?: доступ до кроку, очікування схвалення, конфігурація запиту або відповідь від зовнішньої служби.

Workspace Studio використовує цей крок для надсилання HTTP-запит на певну адресуЦе можна використовувати для сповіщення внутрішнього інструменту, створення запису в іншій програмі або надсилання даних до служби, яка не має прямого конектора. Рішення залежить від того, чи виникає блокування в Google Workspace, чи на сервері, що отримує запит.

Перевірте, чи адміністратор увімкнув вебхуки

Si Надіслати вебхук Його немає серед доступних кроків; почніть із дозволів організації. Google вказує, що ця функція... вимкнено за замовчуванням і що адміністратор має ввімкнути його для відповідного організаційного підрозділу. Шлях: Консоль адміністратора > Програми > Google Workspace > Workspace Studio > Налаштування вебхука.

Також перевірте, чи має ваш обліковий запис доступ до цієї функції: Google продовжує ідентифікувати передачу вебхуків як функцію в обмежений попередній переглядЯкщо ви не адміністратор, надайте адміністратору робочого простору назву відсутнього кроку, свій обліковий запис та організаційний підрозділ, до якого ви належите. Це дозволить йому перевірити відповідні налаштування, не впливаючи на дозволи інших команд.

Перегляньте список дозволених URL-адрес та схвалень

У деяких виданнях адміністратор може обмежити зовнішні пункти призначення за допомогою список дозволених доменів та URL-адресЯкщо крок існує, але ви не можете підключитися до певної кінцевої точки, підтвердьте, що ваш домен або URL-адреса є в цьому списку. Цей параметр керується за допомогою параметрів імпорту та отримання URL-адрес Диска та Документів.

Це обмеження Це не працює однаково у всіх виданняхСписок дозволених вебхуків доступний у таких виданнях, як Business Plus, Enterprise Standard та Plus, а також Education Standard та Plus. У виданнях, які не пропонують цього контролю, увімкнення вебхуків дозволяє підключення до дійсних URL-адрес без застосування цього списку дозволених вебхуків. Тому рекомендується спочатку перевірити політику вашого видання та вашої організації.

Потік також може чекати на схвалення користувачаGoogle розглядає надсилання даних до зовнішньої кінцевої точки як конфіденційну дію та за замовчуванням вимагає перевірки й підтвердження. Якщо автоматизація, здається, зависла, відкрийте Studio та перевірте наявність запитів на схвалення, перш ніж робити висновок про збій сервера.

Правильно налаштуйте URL-адресу, метод та надіслані дані.

Відкрийте потік studio.workspace.google.com і перевірте крок «Надіслати вебхук». Адреса має бути повний та статичнийПоле приймає URL-адресу, яка починається з http:// o https://але це не дозволяє вставляти змінні в саму URL-адресу. HTTPS – рекомендований варіант щоб уникнути надсилання незашифрованої інформації; це не є вимогою до поля.

• Метод HTTP: Виберіть той, який очікує цільовий API. Studio пропонує GET, POST, PUT, PATCH та DELETE; POST є функцією за замовчуванням.
• Текст запиту: Це необов'язково та надсилається як текст. Для багатьох API рекомендується використовувати JSON, дотримуючись лапок, фігурних дужок та назв полів, необхідних сервісом.
• Змінні: Ви можете включити дані з попередніх кроків до тіла. Перевірте результат, якщо змінна містить лапки, розриви рядків або інші символи, які можуть порушити формат JSON.
• GET-запити: Studio ігнорує тіло запиту за допомогою цього методу. Якщо сервісу потрібні дані в тілі запиту, перевірте, який метод підтримується його документацією.

Зробіть виконання тесту І пам’ятайте, що він надішле фактичний запит до пункту призначення. Якщо крок спрацює, його відповідь стане доступною як текстова змінна для подальшого використання в тому ж потоці.

Використайте вкладку «Активність», щоб знайти проблему

Після кожного виконання відкрийте Активність у Workspace Studio. Якщо запит було успішним, ви можете переглянути надіслані дані та отриману відповідь. Якщо не вдалося, Studio відображає код помилки та відповідь цільової URL-адресиЦя інформація дозволяє нам розрізнити проблему конфігурації в потоці та відхилення, спричинене зовнішньою службою.

Un 400 Зазвичай це означає, що одержувач не приймає запит у його написаному вигляді; він переглядає метод і текст. У разі 401 або 403Перевірте вимоги до доступу до сервісу та обмеження вашої організації. 404 Вам буде запропоновано перевірити маршрут кінцевої точки. Якщо 429Перевірте ліміти запитів; помилки 5xx Зазвичай вони вказують на проблему з одержувачем. Конкретна відповідь кінцевої точки корисніша, ніж інтерпретація числа окремо.

Адміністратори також можуть ознайомитися з Журнали подій Workspace Studio для розслідування запитів вебхуків. Доступ до певних даних, таких як запитувана URL-адреса, обмежено, оскільки вони можуть містити конфіденційну інформацію.

Не плутайте вебхук Studio з вебхуком вхідного повідомлення Google Chat.

Крок Надіслати вебхук Workspace Studio надсилає запит до зовнішньої URL-адреси. вхідний вебхук Google ChatНа відміну від цього, це URL-адреса, створена в просторі для іншої системи для публікації там повідомлень. Це окремі елементи, навіть якщо ви можете використовувати URL-адресу чату як місце призначення для потоку Studio.

Якщо ваша мета — опублікувати оголошення в Google Chat, спочатку перевірте, чи достатньо кроку 1. Опублікувати в просторі зі Studio. Якщо вам потрібно використовувати вхідний вебхук, ви повинні створити його з Програми та інтеграції простору та зберігати його URL-адресу приватною, яка містить ключ і токен. Ці вебхуки використовуються для надсилання повідомлень до простору, але не дозволяють спілкуватися з користувачами.

Google Chat застосовує спільну квоту до своїх вхідних вебхуків. один запит на секунду та на пробілЦе обмеження застосовується до чату; воно не є загальним обмеженням для кроку «Надіслати вебхук» у Workspace Studio. Якщо помилка виникає під час публікації багатьох оголошень поспіль в одному просторі, перевірте цю квоту разом із відповіддю на запит.

Перевірте квоти потоку, якщо помилки виникають періодично.

Workspace Studio дозволяє створювати до 25 потоків на користувача, з максимумом 20 кроків на потікКрім того, застосовується комбінований ліміт на кількість виконань протягом кожного 24-годинного періоду. Якщо ви досягнете цього ліміту, подальші виконання будуть невдалими, доки лічильник не буде скинуто.

Коли вебхук завершує роботу лише після багатьох активацій, перевірте Активність Перевірте обмеження як Studio, так і цільового сервісу. Уточнення тригера, наприклад, обмеження його певними відправниками або подіями, може запобігти непотрібним запитам. Якщо помилка виникає під час першого запуску, почніть з перевірки дозволів, очікуваних схвалень та відповіді кінцевої точки.