SMS API ログ

SMS API Logsページでは、SMS APIを通じて送信されたSMSメッセージの検索とトラブルシューティングを行うことができます。このページを使用して、配信の問題を調査し、メッセージのステータスを検証し、さらに分析するためにログをダウンロードします。

注: SMSトラフィックを Messages APIを使用する。 メッセージ API ログ その代わりだ。

始める前に

  • SMSログは、以下の場合に利用可能です。 30日間のみ
  • 30日以上前のログについては Reports API
  • ログが表示されるまで数分の遅れがある
  • を設定する。 納品書ウェブフック リアルタイムのステータス更新

SMSログへのアクセス

  1. にログインする。 Vonage APIダッシュボード
  2. に移動する。 SMS API ログ
SMS Logs

検索方法

SMS API Logsページには、5つの検索方法があります:

時間範囲

特定の期間内のメッセージを検索して、パフォーマンスを調査したり、トラフィックを監視する。

使用可能なフィルター:

  • 時間範囲 - 直近1時間、直近24時間、直近7日間、直近30日間、またはカスタム範囲
  • ディレクション - 送信または受信メッセージ

電話番号

特定の電話番号に送信された、または特定の電話番号から送信されたメッセージを検索し、顧客の問題を調査したり、特定の受信者への配信を検証したりできます。

使用可能なフィルター:

  • To'ナンバー - 宛先の電話番号
  • より - 送信者IDまたは電話番号
  • 時間範囲 - メッセージ送信時
  • ディレクション - アウトバウンドまたはインバウンド

ヒント 電話番号には国際形式(国番号+番号)を使用してください。

メッセージID

一意なメッセージIDを使用して、1つまたは複数の特定のメッセージを検索します。この方法は、API レスポンスや Webhook からメッセージ ID を取得している場合に最適です。

使用可能なフィルター:

  • メッセージID - 1つ以上のカンマ区切りのメッセージID
  • ディレクション - アウトバウンドまたはインバウンド

ウェブフック

デリバリーレシート(DLR)コールバックとインバウンドメッセージWebhookのトラブルシューティングを行い、アプリケーションがステータスアップデートを正しく受信していることを確認します。

使用可能なフィルター:

  • ディレクション - アウトバウンド・コールバック(DLR ステータス)またはインバウンド・コールバック
  • 時間範囲 - ウェブフックが送信されたとき
  • 受取人番号 - ウェブフック配信用の電話番号(例:447777889900)

重要だ: Webhook のログは、Vonage がコールバックをサーバーに正常に配信したかどうかを示すものであり、サーバーが正しく処理したかどうかを示すものではありません。

未送信

配信前にVonageのプラットフォームによって拒否されたメッセージを検索します。これらのメッセージは、配信のためにスケジュールされておらず、DLRステータスがなく、課金されていません。

使用可能なフィルター:

  • To'ナンバー - 目的地の番号
  • より - 送信者IDまたはNumbers
  • 時間範囲 - メッセージが拒否された場合

結果を出す

SMS Logs

ログの詳細を見る

各ログエントリーには、メッセージに関する重要な情報が表示される:

  • メッセージID - メッセージの一意識別子
  • より - 送信者IDまたは電話番号
  • - 相手先電話番号
  • ステータス - 配信ステータス(送信済み、配信済み、失敗など)
  • 時間 - メッセージの送信日またはステータスの更新日
  • ネットワーク - 移動体通信事業者
  • 価格 - メッセージの費用

ログエントリーをクリックすると、エラーコードやネットワーク情報などの詳細が表示されます。

ログのダウンロード

検索結果をCSVにエクスポートして、オフラインで分析したり、記録したりできます。

ログをダウンロードするには

  1. 任意の方法で検索を行う
  2. クリック CSVダウンロード
  3. CSVファイルには、検索結果のすべてのフィールドが含まれます。

注: CSVダウンロードは表示された結果に限定されます。一括エクスポートやプログラムによるアクセスには Reports API.

ログの遅延を理解する

  • 通常のログ: 送信後2~5分で利用可能
  • 納品書: ネットワーク事業者のタイミングによる(数秒から数時間)
  • リアルタイム更新: 用途 納品書ウェブフック その代わり

さらに読む