Workspace StudioにおけるWebhookエラーの解決策

Google Workspace Studioでフローを作成し、ステップを追加しました。 ウェブフックを送信する そして、リクエストは宛先に到達しない。あるいは、処理の流れは正常に機能していたものの、エラーが発生したのかもしれない。安易にURLを変更する前に、原因を調査する価値がある。 実行はどの時点で停止するのか？ステップへのアクセス、保留中の承認、リクエストの設定、または外部サービスからの応答。

Workspace Studio はこのステップを使用して、 特定のアドレスへのHTTPリクエストこれは、内部ツールへの通知、別のアプリケーションへのレコード作成、または直接コネクタを持たないサービスへのデータ送信などに使用できます。解決策は、ブロックが Google Workspace 内で発生しているか、リクエストを受信するサーバーで発生しているかによって異なります。

管理者がウェブフックを有効にしているかどうかを確認してください。

Si ウェブフックを送信する 利用可能な手順の中に表示されません。組織の権限から始めてください。Googleによると、この機能は... デフォルトでは無効になっています また、管理者は該当する組織単位に対してこの機能を有効にする必要があります。設定方法は、管理コンソール > アプリ > Google Workspace > Workspace Studio > Webhook 設定です。

また、アカウントがこの機能にアクセスできることを確認してください。Google は引き続き Webhook の受け渡しを機能として認識しています。 限定プレビュー管理者でない場合は、不足している手順の名前、ご自身のアカウント、および所属する組織単位をワークスペース管理者に伝えてください。これにより、管理者は他のチームの権限に影響を与えることなく、該当する設定を確認できます。

許可されたURLと承認リストを確認してください。

一部のエディションでは、管理者は外部宛先を制限できます。 許可されているドメインとURLのリスト手順が存在するにもかかわらず特定のエンドポイントに接続できない場合は、ドメインまたはURLがそのリストに含まれていることを確認してください。この設定は、ドライブとドキュメントのURLインポートおよび取得オプションから管理されます。

この制限 すべてのエディションで同じように動作するわけではありません。ウェブフックの許可リストは、Business Plus、Enterprise StandardおよびPlus、Education StandardおよびPlusなどのエディションで利用可能です。この制御機能を提供していないエディションでは、ウェブフックを有効にすると、この許可リストを適用せずに有効なURLへの接続が可能になります。そのため、まずはご利用のエディションと組織のポリシーをご確認いただくことをお勧めします。

流れはまた、 ユーザー承認Googleは、外部エンドポイントへのデータ送信を機密性の高い操作とみなし、デフォルトでレビューと確認を要求します。自動化処理が停止しているように見える場合は、サーバーの障害と判断する前に、Studioを開いて保留中の承認リクエストを確認してください。

URL、メソッド、送信データを正しく設定してください。

フローを開く studio.workspace.google.com そして、「Webhook を送信する」ステップを確認します。アドレスは次のようになります。 完全かつ静的このフィールドは、以下の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のWebhookと、Google Chatの受信Webhookを混同しないでください。

ステップ ウェブフックを送信する Workspace Studioは外部URLにリクエストを送信します。 Google Chatの受信Webhookそれに対し、チャットURLは、別のシステムがメッセージを投稿するためのスペース内に作成されるURLです。チャットURLをStudioフローの送信先として使用することもできますが、これらは別々の要素です。

Google Chatに広告を掲載することが目的であれば、まず手順1で十分かどうかを確認してください。 スペースに掲載する Studio から。受信ウェブフックを使用する必要がある場合は、 アプリと連携機能 スペースのURLを非公開にし、キーとトークンを含めます。これらのWebhookはスペースにメッセージを送信するために使用されますが、ユーザーとの会話はできません。

Google Chatは、受信するWebhookに対して共有クォータを適用します。 1秒あたり1リクエスト、スペースあたり1リクエストこの制限はチャットに適用されるものであり、Workspace Studioの「Webhookを送信」ステップの一般的な制限ではありません。同じスペースに多数のアナウンスを連続して投稿した際にエラーが発生する場合は、このクォータとリクエストのレスポンスを確認してください。

エラーが断続的に発生する場合は、フロー割り当てを確認してください。

Workspace Studioでは、最大で ユーザーあたり25フロー、conunmáximode フローごとに20ステップさらに、24時間ごとの実行回数に合計制限が設けられています。この制限に達すると、カウンターがリセットされるまで、それ以降の実行は失敗します。

ウェブフックが何度も実行された後にのみ失敗する場合は、 活動 Studioの制限と対象サービスの制限の両方を確認してください。トリガーを絞り込む（例えば、特定の送信者やイベントに限定する）ことで、不要なリクエストを防ぐことができます。エラーが初回実行時に発生した場合は、まず権限、保留中の承認、エンドポイントの応答を確認してください。