すべてのプロダクト
Search
ドキュメントセンター

Chat App Message Service:ChatAppStatus (モバイル着信メッセージのステータスレポート)

最終更新日:Apr 21, 2026

Message Notification Service (MNS) を使用して、ChatApp メッセージのステータスレポート (ChatAppStatus) を受信できます。

前提条件

説明

モバイル着信メッセージのステータスレポートを構成する方法については、「ステータスレポートとモバイル発信メッセージの構成」をご参照ください。

メッセージ本文のフォーマット

名前

タイプ

必須

説明

MessageId

String

はい

メッセージ ID。

From

String

はい

送信者番号。

To

String

はい

受信者番号。

UserId

String

いいえ

BSUID

ParentUserId

String

いいえ

親 BSUID (存在する場合)。

UserName

String

いいえ

ユーザーアカウント (存在する場合)。

Timestamp

Long

はい

UNIX タイムスタンプ (ミリ秒単位)。

Status

String

はい

メッセージの送信ステータス。 有効値:

  • Sent:メッセージは送信されました。

  • Delivered:メッセージはユーザーのデバイスに配信されました。

  • Read:メッセージはユーザーによって読み取られました。

  • Failed:メッセージの送信に失敗しました。

  • Deleted:メッセージはユーザーによって削除されました。

    説明

    Deleted ステータスは利用できません。 WhatsApp はこのステータスを ChatApp メッセージサービスにプッシュしません。

  • unsubscribe:ユーザーがビジネスアカウントをブロックします。

  • subscribe:ユーザーがビジネスアカウントのブロックを解除します。

    説明

    unsubscribe および subscribe ステータスは、Viber チャンネルにのみ適用されます。

StatusDescription

String

はい

状態コードの説明。

ErrorCode

String

いいえ

エラーコード。

ErrorDescription

String

いいえ

エラーコードの説明。 詳細については、「API エラーコード」をご参照ください。

ConversationType

String

いいえ

会話タイプ。 有効値:

  • service:ユーザー起点の会話。

  • utilityトランザクションメッセージ。

  • marketingマーケティングメッセージ。

  • authentication認証メッセージ。

ConversationId

String

いいえ

会話の ID。

ConversionExpirationTime (Deprecated)

Long

いいえ

会話の有効期限が切れる時間。

説明

このパラメーターは、新しいメッセージごとの課金ルールでは無効です。

MsgFrameType

String

はい

メッセージタイプ。 有効値:

  • message:フリーフォームメッセージ。 このタイプのメッセージは、ユーザーから最後のメッセージを受信してから 24 時間以内にのみ送信できます。

  • template:コンソールで承認されたメッセージテンプレート。 このタイプのメッセージはいつでも送信できます。

Type

String

いいえ

メッセージ本文のメディアリソースタイプ。 有効値:

  • image:イメージ

  • video:ビデオ

  • document:ドキュメント

  • audio:オーディオ

  • none:プレーンテキスト

TaskId

String

いいえ

顧客タスクの ID。 デフォルト値は MessageId です。

説明

TaskId が指定されていない場合、デフォルトで MessageId の値が使用されます。

OriginPhoneNumber

String

いいえ

送信者の実際の電話番号。

TemplateCode

String

いいえ

メッセージテンプレートのコード。

説明

このパラメーターは、MsgFrameType が template に設定されている場合にのみ使用できます。