送受信したfaxのステータスを確認するためにウェブフックを使用するにはどうすればよいですか？

ウェブフックを使用すると、Fax.Plus から直接、送受信したfaxに関するリアルタイムの更新情報を受け取ることができます。ウェブフックを設定することで、fax送信の監視を自動化し、ステータス更新を既存のシステムに統合できます。

ウェブフックの設定

1. ウェブフックペインを開く：
   • Fax.Plusアカウントにログインします。
   • 設定内のインテグレーションセクションに移動します。
   • Webhooksを見つけて管理をクリックします。
2. エンドポイントを追加する：
   • エンドポイントを追加をクリックし、イベントを受信するサーバー上の絶対URLを入力します。
   • 受信するイベントを選択します。すべてのイベントを購読するか、
     イベントカタログから必要なものだけを選択できます。
   • 任意：fax番号でフィルタリングします。特定のfax番号を1つ以上関連付けることで、
     それらの番号に関するイベントのみを受信できます。

3. ステータス更新を受信する

   • 設定が完了すると、fax のステータスが変更されるたびに、Fax.Plusが指定したURLに
     ウェブフックを送信します。
   • ウェブフックのペイロードには、fax ID、ステータス、タイムスタンプ、受信者情報などの
     重要な詳細が含まれます。

   注：hook.idがdata.idと等しくない場合、そのfaxは再試行されています。hook.idがdata.idと等しい場合、そのfaxは初めて送信されていることを示します

4. 署名を検証する
   • 作成した各エンドポイントに対して署名シークレットが自動的に作成され、これを使ってすべての受信リクエストを検証できます。詳しくはウェブフック署名の検証をご覧ください。
5. （任意）発信元IPアドレスを確認する：
   • 受信したウェブフックが、以下の承認済みIPリストから送信されていることを確認できます：
     • 52.215.16.239
     • 54.216.8.72
     • 63.33.109.123
     • 2a05:d028:17:8000::/56

トラブルシューティングとモニタリング

• ログと可観測性：ウェブフックパネルで、すべてのイベントとその配信が成功したかどうかを確認できます。
• 再試行：配信に失敗した場合、ウェブフックは自動的に再試行されます。
• リプレイ：パネルから手動で再試行をトリガーしたり、選択した期間内の過去のイベントをリプレイしたりすることもできます。