Решение проблем с веб-перехватчиками в Workspace Studio

Вы создали рабочий процесс в Google Workspace Studio и добавили шаг. Отправить веб-хук И запрос так и не доходит до адресата. Или, возможно, процесс работал, а теперь возникает ошибка. Прежде чем слепо менять URL-адрес, стоит разобраться в ситуации. В какой момент выполнение останавливается?: доступ к этапу, ожидающему подтверждения, конфигурации запроса или ответу от внешнего сервиса.

В Workspace Studio этот шаг используется для отправки HTTP-запрос к конкретному адресуЭто можно использовать для уведомления внутреннего инструмента, создания записи в другом приложении или отправки данных в сервис, не имеющий прямого коннектора. Решение зависит от того, происходит ли блокировка внутри Google Workspace или на сервере, получающем запрос.

Проверьте, включены ли веб-перехватчики администратором.

Si Отправить веб-хук Эта функция не отображается среди доступных шагов; начните с настроек прав доступа организации. Google указывает, что эта функция... отключено по умолчанию и что администратор должен включить эту функцию для соответствующего организационного подразделения. Путь: Консоль администратора > Приложения > Google Workspace > Workspace Studio > Настройки веб-перехватчика.

Также убедитесь, что ваша учетная запись имеет доступ к этой функции: Google продолжает рассматривать передачу веб-хуков как функцию в ограниченный предварительный просмотрЕсли вы не являетесь администратором, сообщите администратору рабочей области название отсутствующего шага, вашу учетную запись и организационное подразделение, к которому вы принадлежите. Это позволит ему проверить применимые настройки, не затрагивая права доступа в других командах.

Ознакомьтесь со списком разрешенных URL-адресов и подтверждений.

В некоторых версиях администратор может ограничить внешние адреса назначения с помощью список разрешенных доменов и URL-адресовЕсли шаг существует, но вы не можете подключиться к определенной конечной точке, убедитесь, что ваш домен или URL-адрес есть в этом списке. Этот параметр управляется в параметрах импорта и получения URL-адресов в Google Диск и Документах.

Это ограничение В разных изданиях это работает по-разному.Список разрешенных веб-хуков доступен в таких версиях, как 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. Если вам необходимо использовать входящий веб-перехватчик, его нужно создать из Studio. Приложения и интеграции Веб-хуки используются для отправки сообщений в пространство и сохраняют его URL-адрес в тайне, включая ключ и токен.

Google Chat применяет общую квоту к входящим веб-хукам. один запрос в секунду на каждое пространствоЭто ограничение относится к чату; оно не является общим ограничением для шага «Отправить веб-перехватчик» в Workspace Studio. Если ошибка возникает при отправке множества объявлений подряд в одно и то же пространство, проверьте это ограничение вместе с ответом на запрос.

Если ошибки возникают периодически, проверьте квоты потока.

Workspace Studio позволяет создавать до 25 потоков на пользователя, с максимумом 20 шагов на потокКроме того, устанавливается суммарный лимит на количество выполнений в течение каждых 24 часов. Если этот лимит будет достигнут, дальнейшие выполнения будут завершаться с ошибкой до тех пор, пока счетчик не будет сброшен.

Если веб-хук перестает работать только после множества активаций, проверьте следующее. Активность Проверьте как ограничения Studio, так и ограничения целевой службы. Уточнение триггера — например, ограничение его для определенных отправителей или событий — может предотвратить ненужные запросы. Если ошибка возникает при первом запуске, начните с проверки разрешений, ожидающих подтверждений и ответа конечной точки.