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

Chat App Message Service:ChatAppInbound (モバイル発信 (MO) メッセージ)

最終更新日:Apr 21, 2026

Simple Message Queue (旧 Message Service (MNS)) を使用して、Chat App Message Service からモバイル発信 (MO) メッセージを受信します。

前提条件

説明

ご利用のエンドポイントで MO メッセージを受信するための設定手順については、「ステータスレポート/MO メッセージの設定」をご参照ください。

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

パラメーター

タイプ

必須

説明

MessageId

String

はい

メッセージの一意の識別子。

CustSpaceId

String

はい

チャネル ID。

WabaId

String

はい

WhatsApp Business Account (WABA) ID。

From

String

はい

送信者の電話番号。

To

String

はい

受信者の電話番号。

FromUserId

String

いいえ

送信者の Business Service User ID (BSUID)。

FromParentUserId

String

いいえ

送信者の親 BSUID (存在する場合)。

FromUserName

String

いいえ

送信者のユーザー名 (存在する場合)。

Timestamp

Long

はい

メッセージが送信されたときの UNIX タイムスタンプ (ミリ秒単位)。

DisplayName

String

はい

送信者の表示名。

Type

String

はい

メッセージのメディアタイプ。 有効な値:

  • TEXT

  • LOCATION

  • DOCUMENT

  • VIDEO

  • AUDIO

  • REPLY

  • IMAGE

  • CONTACTS

  • SYSTEM

Message

Object

はい

メッセージ内容を表す JSON オブジェクト。 オブジェクトの構造はメッセージタイプによって異なります。

Name

String

はい

ユーザー名。

Location オブジェクト

パラメーター

タイプ

必須

説明

address

String

はい

住所情報。

latitude

String

はい

緯度。

longitude

String

はい

経度。

name

String

はい

場所の説明。

Video オブジェクト

パラメーター

タイプ

必須

説明

name

String

はい

動画ファイルの説明。

id

String

はい

動画ファイルの ID。

mimeType

String

はい

動画の MIME タイプ。 値は常に ogg です。

説明

codecs=opus の場合は、このパラメーターを無視できます。

url

String

はい

動画ファイルの URL。

説明

URL の有効期間は 7 日間です。

Image オブジェクト

パラメーター

タイプ

必須

説明

caption

String

いいえ

イメージのキャプション。

id

String

はい

イメージの ID。

mimeType

String

はい

イメージの MIME タイプ。

url

String

はい

イメージの URL。

説明

URL の有効期間は 7 日間です。

Audio オブジェクト

パラメーター

タイプ

必須

説明

name

String

はい

音声ファイルの説明。

id

String

はい

音声ファイルの ID。

mimeType

String

はい

音声の MIME タイプ。 値は常に audio です。

説明

codecs=opus の場合は、このパラメーターを無視できます。

url

String

はい

音声ファイルの URL。

説明

URL の有効期間は 7 日間です。

Document オブジェクト

パラメーター

タイプ

必須

説明

name

String

はい

ドキュメントの説明。

id

String

はい

ドキュメントの ID。

filename

String

はい

ドキュメントのファイル名。

mimeType

String

はい

ドキュメントの MIME タイプ。 値は常に application/pdf です。

url

String

はい

ドキュメントの URL。

説明

URL の有効期間は 7 日間です。

Reply オブジェクト

パラメーター

タイプ

必須

説明

text

String

はい

ユーザーがクリックしたボタンのテキストラベル。

payload

String

はい

ユーザーがボタンをクリックしたときに返されるペイロード。 この値は、送信されたメッセージで定義したペイロードと一致します。

System オブジェクト

パラメーター

タイプ

必須

説明

body

String

はい

ユーザーの ID または電話番号の変更に関する説明。

wa_id

String

はい

電話番号が更新された後のユーザーの新しい WhatsApp ID。

type

String

はい

システム更新のタイプ。 有効な値:

  • customer_changed_number:ユーザーが電話番号を変更しました。

  • customer_identity_changed:ユーザーがプロファイルを変更しました。