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

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

最終更新日:Nov 26, 2025

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

前提条件

  • Alibaba Cloud アカウントを登録し、AccessKey ペアを作成済みであること。 詳細については、「AccessKey ペアの作成」をご参照ください。

  • メッセージ受信の概要と設定 をお読みになり、メッセージ受信のパターン、タイプ、設定フローを理解していること。

説明

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

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

名前

タイプ

必須

説明

MessageId

String

はい

メッセージ ID。

From

String

はい

送信者の番号。

To

String

はい

受信者の番号。

Timestamp

Long

はい

ミリ秒単位の UNIX タイムスタンプです。

Status

String

はい

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

  • Sent:メッセージは送信済みです。

  • Delivered:メッセージはユーザーのデバイスに配信済みです。

  • Read:メッセージはユーザーによって閲覧済みです。

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

  • Deleted:メッセージはユーザーによって削除済みです。

    説明

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

StatusDescription

String

はい

ステータスコードの説明。

ErrorCode

String

いいえ

エラーコード。

ErrorDescription

String

いいえ

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

ConversationType

String

いいえ

会話タイプ。 有効な値:

  • service:ユーザーによって開始された会話。

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

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

  • authenticationID 検証メッセージ。

ConversationId

String

いいえ

会話 ID。

ConversionExpirationTime (非推奨)

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 に設定されている場合にのみ値を持ちます。