メッセージログ

メッセージログは、すべての通信チャネルとプラットフォームサービスにわたって送受信された個々のメッセージを可視化します。これらを使用して、配信状態の追跡、エラーの調査、および特定のメッセージの監査を行います。カバレッジは詳細レポートに一致します。どちらのツールも同じデータソースから取得します。

アクセスと可用性

メッセージログには、Analyze Manager ロールが必要です。ロール管理については、ロールの管理を参照してください。このロールを使用すると、アカウントと関連するサブアカウントのデータを表示できます。サブアカウントでログインすると、自分のアカウントデータのみが表示されます。保持期間と完全なデータ可用性の詳細については、「レポートの概要」を参照してください。

メモ

メッセージログでアクセスまたはデータの問題が発生した場合は、次の点を確認してください。

メッセージログにアクセスできない: Analyze Managerロールがあることを確認します。ロールが正しいにもかかわらずアクセスできない場合は、アカウントマネージャーにお問い合わせください。
結果が返されません: フィルターが狭すぎる可能性があります。日付範囲を広げるか、フィルターを一度に 1 つずつ削除してみてください。
エクスポートに予期されるフィールドがありません: ログのエクスポートには、使用可能なフィールドのサブセットが含まれます。フルセットの場合は、詳細レポートを使用します。

アクセス方法

メッセージ・ログは、異なる機能を持つ 2 つのアクセス方式で使用できます。

	ログ	API エンドポイント
アクセス	Analyze > ログ	チャネル固有の`GET`エンドポイント
リテンション	3ヶ月	過去 48 時間
レコード制限	表示されているすべてのエントリをエクスポートする	要求ごとに 1,000
チャンネル	すべてのチャンネルを1つのビューに	チャネルごとのエンドポイント。一部のチャンネルではご利用いただけません
フィルター	フルフィルターセット	エンドポイントパラメータに限定
特徴	検索、エクスポート	カーソルベースのページネーション

もっと詳しく知る

ログと別のツールのどちらを使用するかわかりませんか?どのツールが必要ですかを参照してください。

ログ

Web インターフェイスのすべてのチャネルにわたる個々のメッセージのステータスを追跡します。各行には、配信ステータス、タイムスタンプ、送信者/受信者、エラーコード、メタデータを含む 1 つのメッセージが表示されます。

開始するには：

Web インターフェイスで、[ログ>Analyze** に移動します。
検索バーを使用して、メッセージ ID、電子メールの件名、送信者名、宛先、またはデータペイロードでメッセージを検索します。使用可能なフィルターを使用して、結果をさらに絞り込みます。
行を選択すると、メッセージの詳細全体が展開されます。
エクスポート を選択して、表示されているエントリをダウンロードします。エクスポートには、使用可能なフィールドのサブセットが含まれます。フィールドの完全なセットについては、詳細レポートを使用します。

メモ電子メールメッセージの場合、送信した電子メールの完全な内容をログエントリから.emlファイルとしてダウンロードすることもできます。これには、デフォルトでは有効になっていない有料アドオンであるアクティブな電子メールストレージが必要です。電子メールの取得手順を参照してください。

もっと詳しく知る

配信ステータスの定義とエラーコードの詳細については、「応答ステータスとエラーコードを参照してください。

使用可能なフィルター [#filters-logs]

フィルターパネルを使用して、結果を絞り込みます。フィルターを組み合わせることができます。

フィルター	説明
完全に一致するメッセージのみを検索する	有効にすると、検索バーのテキストと完全に一致するメッセージのみが返されます
Date (日付)	カスタムの日付範囲の選択
ステータス	配信済み、保留中、拒否済み、配信不能、期限切れ
アカウント	アカウント階層内の特定のアカウント
ユーザー	メッセージを送信したユーザー
チャンネル	インバウンドまたはアウトバウンド、特定のチャネル
To	受信者の住所または番号
From (発信元)	送信者 ID または番号
コミュニケーション	キャンペーン名または通信名
国	送信先の国
ネットワーク	送信先モバイルネットワーク事業者
SIP トランク	特定の SIP トランク(Voice and Video のみ)
Message ID (メッセージID)	ID による特定のメッセージ検索
アプリケーション ID	マルチテナントアプリケーション識別子
エンティティ ID	マルチテナントエンティティ識別子

データペイロード [#data-payload]

カスタムメタデータをメッセージに添付して、特定の送信を識別、追跡、または分析します。

Webインターフェイス: 顧客プロファイル > 構成 > 個人カスタム属性 で属性を定義し、メッセージの送信時に データペイロード フィールドで属性を選択します。
API: callbackData パラメーターを文字列値に設定します。最大長はチャネルによって異なります。ほとんどのメッセージングチャネルでは 4,000 文字を使用できます。Voice の高度なテキスト読み上げでは 700 文字、Voice IVR （自動音声応答）では 200 文字で許可されるものもあります。正確な制限については、チャネルの API リファレンスでメッセージ送信エンドポイントを確認してください。

値が JSON オブジェクトの場合、各キーはエクスポートに個別の列として表示されます。データペイロードは、メッセージログ、詳細レポート、Webhook 配信レポートで使用でき、callbackData として返されます。集計ツール(メトリクス API、ダッシュボード、配信、トラフィックパフォーマンスレポート)では使用できません。