Webhookのベストプラクティス
お知らせ：当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。
技術担当のユーザーは、Webhook を使用してアプリケーションを設定または連携し、イベントや操作が発生した際にリアルタイムで更新を受け取ることができます。Zoho Sign アカウントの管理者は Webhook を設定し、それをトリガーする処理を選択できます。
コールバックは、URL 設定の誤りやクライアント側のサーバー負荷など、さまざまな理由で失敗する場合があります。これにより、当社サーバーに大きな負荷がかかります。
コールバックの失敗を繰り返さないようにするため、管理者の方には次のベストプラクティスに従うことを推奨します。
- 管理者が Zoho Sign で発生する処理のリアルタイム更新を取得するために Webhook を設定した場合、当社サーバーは、コールバックが成功したと見なすために 5 秒以内に HTTP 200 応答を受信する必要があります。
- Webhook コールバックを返す前に、利用可能な Webhook データを使って重い処理を行わないことを推奨します。
- 設定した Webhook URL が常に有効でアクセス可能であることを確認してください。
コールバックの失敗が繰り返し発生した場合、管理者には次のシステム生成メールが送信されます。
警告しきい値メール: 10～15 回連続してコールバックが失敗すると、警告メールがシステムから自動的に送信されます。
Webhook 無効化メール:コールバックの失敗が 20 回連続というしきい値に達すると、同じ URL へのコールバックをこれ以上行わないよう、システムは Webhook を自動的に無効化します。
管理者は失敗の原因を特定し、Zoho Sign の Web インターフェイスから無効化された Webhook を再有効化する必要があります。
さらにご不明な点やサポートが必要な場合は、非 EU 居住者の方は support@zohosign.com、EU 居住者の方は support@zohosign.eu までお問い合わせください。