「レポート」タブを開きます。
最終更新日 :
2026年5月11日
SMS と WhatsApp の使用状況を追跡し、割り当て量をモニターし、グループ別の消費量を分析するために、スケジュールされた CSV レポートを生成します。
トランザクション使用量書き出しでは、購入量、消費量合計、グループレベルの使用量など、アカウント全体の SMS と WhatsApp アクティビティの可視性が提供されます。この書き出しには、次が含まれます。
- SMS 認証
- SMS 配信
- 「WhatsApp」認証
- WhatsApp 配信トランザクション。
書き出しは、リアルタイムクエリではなく、スケジュールされたスナップショットとして生成されます。継続的な監視にはスケジュールを使用し、更新されたデータが即座に必要な場合は手動で書き出しを準備して再生成します。
データ書き出しの仕組み
トランザクションデータは、定義された日付範囲内で指定されたフィルターを使用して CSV ファイルとして書き出されます。
- 書き出しは非同期で生成され、リアルタイムではありません。
- 書き出しは設定されたスケジュールで更新されます。
- 「準備」を選択すると、使用可能な最新データで書き出しが再生成されます。
CSV の各行は単一の契約書を表し、SMS と WhatsApp トランザクション使用量データが含まれます。
トランザクション使用状況レポートの作成
「レポート」タブから CSV レポートを作成します。
-
-
「新規書き出し」を選択します。
-
「トランザクション消費]を選択します。
-
書き出しを定義します：
- 日付範囲を選択します。
- 必要に応じて 1 つ以上のグループを含むフィルターを適用します。
-
「列を選択」を選択し、含めるデータを選択します。
SMS と WhatsApp トランザクション使用量については、利用可能な列セクションでアドオンを展開し、以下を含めます：
- メッセージ送信アドオンの購入数量 — 購入されたトランザクションの合計数。
- メッセージ配信アドオンの開始日 — トランザクション割り当て量が適用された年次有効日。
- SMS OTP 消費量カウント — SMS ベースの認証に使用されたトランザクション。
- SMS 契約書配信消費量カウント — SMS 経由で契約書リンクを配信するために使用されたトランザクション。
- WhatsApp OTP 消費量カウント — WhatsApp ベースの認証に使用されたトランザクション。
- WhatsApp 契約書配信消費量カウント — WhatsApp 経由で契約書リンクを配信するために使用されたトランザクション。
グループレベルのレポーティングを有効にするには、送信者グループ列も含めます。
-
「保存」を選択し、書き出しの名前を入力します。
書き出しが非同期で生成され、完了すると、「最近のレポート」リストに表示されます。
正確なグループレベルデータを設定
グループレベルの使用量には、フィルタリングと列選択の両方が必要です。
- 書き出しを定義するときは、1 つ以上のグループフィルターを適用します。
- 書き出しに送信者グループ列を含めます。
いずれかの要件が満たされていない場合、グループレベルの使用量は書き出しデータで正確に表示されません。
正確な契約使用量データの確保
正しい契約期間に対してレポートするには：
- 電話割り当て量発効（開始）日をレポート開始日として使用します。
- この値はアカウント設定／送信設定で確認できます
正しい開始日を使用することで、現在の契約下のすべてのトランザクションが含まれ、使用量合計とグループレベルの要約が正確になります。
レポートのスケジュール
更新されたトランザクションデータを自動的に生成するレポートをスケジュールします。
-
新しい書き出しを作成するか、既存のものを編集してください。
-
スケジュールする書き出しの省略記号を選択し、ドロップダウンメニューからスケジュールを選択します。
-
以下を定義してスケジュールを設定してください：
- スケジュール頻度（日次、週次、月次）
- レポートの送信先メールアドレス
- オプションのメッセージ
-
スケジュールを保存します。
スケジュールされたレポートは自動的に生成され、「最近のレポート」リストからダウンロードするか、電子メールで配信できます。
最新データで書き出しを更新
書き出しを更新するには：
- 準備を選択して、書き出しをすぐに再生成します。
- または、次回のスケジュール実行を待ちます。
- 必要に応じて、同じパラメーターで新しい書き出しを作成することもできます。
API を使用して書き出しをダウンロード
API を使用して最新の生成された書き出しを取得します。
- エンドポイント：POST /api/rest/v6/reportDownload
- 必須パラメーター：scheduleId
このエンドポイントは：
- レポート UI で作成された書き出しスケジュールが必要です。
- 最新の CSV ファイルのみのダウンロード URL を返します。
- オンデマンドで新しい書き出しを生成しません。
書き出しが更新されていない場合、以前に生成された CSV ファイルが返されます。
大きな CSV ファイルをダウンロードすると、すべてのレコードを準備する必要があるので、処理は遅れる場合があります。正常なダウンロードを確保するには、クライアントタイムアウトを 5 分以上に設定します。
書き出しの可用性と保持
- 書き出された CSV ファイルは、7 日間保存されます。
- 7 日を過ぎると、ファイルは期限切れとなり、ダウンロードできなくなります。
- 更新されたデータにアクセスするには、準備を使用して書き出しを再生成するか、次回のスケジュール実行を待ちます。
知っておくべきこと
- 書き出しは、API を通じてアクセスするには、作成またはスケジュールする必要があります。
- スケジュールの最新の CSV ファイルのみが API を通じて使用可能です。
- グループレベルのレポーティングには以下の両方が必要です：
- グループフィルター
- 送信者グループ列
- 正確な契約レベルのレポーティングには、正しい電話割り当て量発効（開始）日の使用が必要です。
- 書き出しファイルは 7 日を過ぎると、期限切れとなり、必要に応じて再生成する必要があります。
