SMS API ログ
SMS API Logsページでは、SMS APIを通じて送信されたSMSメッセージの検索とトラブルシューティングを行うことができます。このページを使用して、配信の問題を調査し、メッセージのステータスを検証し、さらに分析するためにログをダウンロードします。
注: SMSトラフィックを Messages APIを使用する。 メッセージ API ログ その代わりだ。
始める前に
- SMSログは、以下の場合に利用可能です。 30日間のみ
- 30日以上前のログについては Reports API
- ログが表示されるまで数分の遅れがある
- を設定する。 納品書ウェブフック リアルタイムのステータス更新
SMSログへのアクセス
- にログインする。 Vonage APIダッシュボード
- に移動する。 SMS API ログ

検索方法
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
- 時間範囲 - メッセージが拒否された場合
結果を出す

ログの詳細を見る
各ログエントリーには、メッセージに関する重要な情報が表示される:
- メッセージID - メッセージの一意識別子
- より - 送信者IDまたは電話番号
- へ - 相手先電話番号
- ステータス - 配信ステータス(送信済み、配信済み、失敗など)
- 時間 - メッセージの送信日またはステータスの更新日
- ネットワーク - 移動体通信事業者
- 価格 - メッセージの費用
ログエントリーをクリックすると、エラーコードやネットワーク情報などの詳細が表示されます。
ログのダウンロード
検索結果をCSVにエクスポートして、オフラインで分析したり、記録したりできます。
ログをダウンロードするには
- 任意の方法で検索を行う
- クリック CSVダウンロード
- CSVファイルには、検索結果のすべてのフィールドが含まれます。
注: CSVダウンロードは表示された結果に限定されます。一括エクスポートやプログラムによるアクセスには Reports API.
ログの遅延を理解する
- 通常のログ: 送信後2~5分で利用可能
- 納品書: ネットワーク事業者のタイミングによる(数秒から数時間)
- リアルタイム更新: 用途 納品書ウェブフック その代わり