Webhook 出力

Webhook 出力（Webhook Output）ノードは、ワークフローの結果を、JSON ボディ付きの HTTP POST リクエストで URL に送信します。完成した動画、画像、オーディオファイル、テキストを、自分のバックエンド、コンテンツ管理システム、自動化サービスに届けるときに使います。送信する値の名前は、自分で決められます。また、保存済みのキーをリクエストのたびに送信でき、そのキーがワークフロー内に表示されることはありません。

使いどころ

• 生成した動画が完成したら、その URL をコンテンツ管理システムに送ります。
• ワークフローが終わったら、別のサービスで自動化を開始します。
• 結果を自分の API に届けて、さらに処理します。
• スケジュールやトリガーによる実行が完了したことを、別のシステムに知らせます。

クイックスタート

入力

入力は、定義したパラメーターによって変わります。

• パラメーターなし：ノードの入力は 1 つです。そこに接続したものはすべて、1 つのペイロードとして送信されます。
• パラメーターが 1 つ以上：パラメーターごとに、その名前の入力が 1 つずつあります。各値は、パラメーターの名前で送信されます。

設定

リクエストの内容

ノードは、JSON ボディ付きの POST リクエストを送信します。video_url と caption という 2 つのパラメーターがある場合、ボディは次のようになります。

{
  "video_url": "https://cdn.example.com/results/clip.mp4",
  "caption": "Our new product, in 15 seconds."
}

メディアの値はファイルの URL で、受け取ったサービスはそこからファイルをダウンロードできます。

認証情報を付けて送信する

多くのサービスは、Authorization: Bearer ... のように、ヘッダーにキーが含まれた送信しか受け付けません。キーを認証情報として一度だけ保存し、ノードでその認証情報を選びます。

ノードが保存するのは、認証情報への参照だけです。シークレットは、リクエストの送信時にサーバー上で復号され、二度と表示されません。ワークフロー、エクスポート、テンプレート、プリセットに入ることもありません。キーを新しいものに替えるには、古い値に新しい値を上書き保存します。

「すべてのアドレス」と「1 つのアドレスのみ」の違い

ロックされていない認証情報は、公開したアプリ、共有したワークフロー、共同編集者の実行、API トークンで開始した実行、Webhook トリガー、API で作成したスケジュールでは拒否されます。その場合、ノードはキーなしで送信するのではなく、わかりやすいメッセージを出して失敗します。

ロックされた認証情報は、1 つの https:// アドレスにひも付けられます。デフォルトでは、そのアドレスと完全に一致する場合だけが対象です。同じサービスの複数のアドレスで 1 つのキーを使うには、このアドレス配下のパスも許可をオンにします。完全一致のアドレスにロックされた認証情報を選ぶと、Webhook URL はそのアドレスに合わせて設定され、編集できなくなります。

ロックは取り消せません。ロックしたアドレスは後から変更できますが、削除はできません。

公開と共有には、ロックされた認証情報が必要

ワークフローをアプリとして公開したり、ほかの人が実行できるように共有したりする前に、送信に使うすべての認証情報を、ノードの送信先のアドレスにロックする必要があります。サブワークフロー内の認証情報も対象です。公開と共有のダイアログでは、ワンクリックで認証情報をノードの現在の URL にロックできます。

ロックによる制限

すべてのリクエストとすべてのリダイレクトで、次のルールが適用されます。

• URL は、ロックしたアドレスと一致する必要があります。一致しない場合、リクエストは送信される前に拒否されます。
• ほかのアドレスへのリダイレクトには従いません。キーなしで続行するのではなく、リクエストが失敗します。
• ロックされていない認証情報は、別のサイトへのリダイレクトから取り除かれます。
• 認証情報が、暗号化されていない http:// で送信されることはありません。

キーを付けると応答は表示されない

認証情報を付けている場合、応答の本文は返されず、保存も表示もされません。扱われるのは、ステータスコードだけです。一部のサービスはリクエストヘッダーを応答で繰り返すため、キーがワークフローに戻ってこないようにしています。

削除された認証情報や、別のアカウントの認証情報を使うと、ノードは失敗します。ノードが、キーなしでリクエストを送信することはありません。

エクスポートしたワークフロー

ワークフローのエクスポートやテンプレートに、認証情報が含まれることはありません。ワークフローをインポートすると、Webhook 出力ノードは認証情報なしで届くので、インポートした人が自分の認証情報を選びます。認証情報は、Nodaro のアプリでのみ管理します。

ヒント

• 先にアドレスをテストする：構築中は、リクエストの内容を確認できるサービスにノードの送信先を向け、実際のエンドポイントにつなぐ前にボディを確認します。
• 受信側の名前に合わせる：パラメーターには、受け取るサービスが想定しているとおりの名前を付けます。
• 外部から実行を開始する：「Webhook 出力」を Webhook トリガー（Webhook Trigger）やスケジュールトリガー（Schedule Trigger）と組み合わせると、エディターに誰もいなくても実行されるワークフローになります。
• コピーを残す：同じ結果を、ストレージに保存（Save to Storage）にも接続します。

トラブルシューティング

リクエストの後でノードが失敗した：受信先のアドレスがエラーを返しました。ステータスコードは前回の実行に、エラーは実行履歴に表示されます。

リクエストが送信前に拒否される：アドレスを確認してください。プライベートネットワークやローカルネットワークのアドレスを指す URL は、拒否されます。認証情報を付けている場合は、URL が認証情報のロックされたアドレスとも一致する必要があります。

URL がロックされたアドレスではないという警告がパネルに表示される：インポートの後などで、認証情報が別のアドレスにロックされています。ロックされたアドレスを使用をクリックするか、別の認証情報を選んでください。

自分で実行すると動くが、公開したアプリやトリガーによる実行では失敗する：認証情報が、アドレスにロックされていません。連携で認証情報をノードのアドレスにロックしてから、もう一度実行してください。