手作業での受け渡しを、ひとつ減らす。
完了したタスク結果を独自の HTTPS エンドポイントへ送信します。
- 公開エンドポイントを準備しましょう。
ポート443の HTTPS で JSON の POST リクエストを受け付けてください。プライベートアドレス、URL に埋め込んだ認証情報、リダイレクトには対応していません。
- 接続を追加しましょう。
WebAct の「連携」画面で Webhook を選び、エンドポイントを入力し、必要に応じて署名用シークレットを設定してください。エンドポイントの認証情報は非公開に保ちましょう。
- 検証し、重複を排除しましょう。
署名が設定されている場合は検証してください。配送 ID を保存し、明示的な再試行で後続処理の副作用が繰り返されないようにします。
- 明確な結果を返しましょう。
2xx 応答は、エンドポイントが送信を受け付けたことを WebAct に伝えます。その後のすべての操作が成功したことを示すものではありません。送信結果が不明な場合は、再試行前に送信先を確認してください。
送信される内容
タスクの指示、最終要約、元ページの URL、検証の説明が含まれます。ページのスナップショットと添付ファイルは含みません。送信前に内容と送信先を確認してください。
エンドポイントについて
操作を行う前に、Idempotency-Key の値で重複を排除してください。X-WebAct-Event ヘッダーはイベントを識別します。
署名用シークレットを設定すると、X-WebAct-Signature にタイムスタンプと、タイムスタンプ・ピリオド・未加工のリクエスト本文を連結した値の HMAC-SHA256 署名が含まれます。送信を受理する前に元のバイト列を検証し、適切な有効時間内であることを確認してください。
WebAct で送信先を削除すると待機中の送信はキャンセルされますが、サービスがすでに受理したリクエストは取り消せません。
送信結果が不明な場合
再試行を求める前に、受信側ツールを確認してください。送信先がリクエストを受理した後にネットワークが切断されることもあります。明示的に再試行しても配送 ID は変わらないため、受信側で処理の重複を防げます。
Business の自動送信は、接続を作成した後に完了する結果に適用されます。「連携」で送信先を削除できますが、すでに別のサービスに届いたデータを取り戻すことはできません。
接続の問題を解決するか、すべての連携に戻ってください。
作業しているその場所で、ちょっとした手助けを。
無料のブラウザーチャットと、毎月25回の自動化タスクから始めましょう。