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

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

最終更新日:Nov 26, 2025

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

前提条件

説明

モバイル発信メッセージの設定方法の詳細については、「ステータスレポート/モバイル発信メッセージの設定」をご参照ください。

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

名前

タイプ

必須

説明

MessageId

String

はい

メッセージの ID。

CustSpaceId

String

はい

チャネル ID。

WabaId

String

はい

WhatsApp ビジネスアカウントの ID。

From

String

はい

メッセージ送信者の電話番号。

To

String

はい

メッセージ受信者の電話番号。

Timestamp

Long

はい

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

DisplayName

String

はい

電話番号の表示名。

Type

String

はい

メディアリソースのタイプ。 有効な値:

  • TEXT

  • LOCATION

  • DOCUMENT

  • VIDEO

  • AUDIO

  • REPLY

  • IMAGE

  • CONTACTS

  • SYSTEM

Message

String

はい

メッセージのコンテンツ。

  • TypeTEXT に設定されている場合、Message はメッセージコンテンツです。

  • TypeLOCATION に設定されている場合、Message には位置情報データが含まれます。 詳細については、「LOCATION フィールド」をご参照ください。

  • TypeVIDEO に設定されている場合、Message には動画データが含まれます。 詳細については、「VIDEO フィールド」をご参照ください。

  • TypeAUDIO に設定されている場合、Message には音声データが含まれます。 詳細については、「AUDIO フィールド」をご参照ください。

  • TypeDOCUMENT に設定されている場合、Message にはドキュメントデータが含まれます。 詳細については、「DOCUMENT フィールド」をご参照ください。

  • TypeREPLY に設定されている場合、Message には返信データが含まれます。 詳細については、「REPLY フィールド」をご参照ください。

  • TypeIMAGE に設定されている場合、Message には画像データが含まれます。 詳細については、「IMAGE フィールド」をご参照ください。

  • TypeSYSTEM に設定されている場合、Message にはシステムデータが含まれます。 詳細については、「SYSTEM フィールド」をご参照ください。

Name

String

はい

エンドユーザーの名前。

LOCATION フィールド

名前

種類

必須

説明

address

String

はい

住所情報。

latitude

String

はい

位置の緯度。

longitude

String

はい

位置の経度。

name

String

はい

位置の説明。

VIDEO フィールド

名前

種類

必須

説明

name

String

はい

ビデオファイルの説明。

id

String

はい

ビデオファイルの ID。

mimeType

String

はい

値を ogg に設定します。

説明

codecs パラメーターが opus に設定されている場合、このパラメーターは無視できます。

url

String

はい

動画の URL。

説明

URL は 7 日間有効です。

IMAGE フィールド

名前

種類

必須

説明

caption

String

いいえ

画像の説明。

id

String

はい

画像の ID。

mimeType

String

はい

画像の種類。

url

String

はい

イメージの URL です。

説明

URL は 7 日間有効です。

AUDIO フィールド

名前

種類

オプション

説明

name

String

はい

AUDIO ファイルの説明。

id

String

はい

AUDIO ファイルの ID。

mimeType

String

はい

静的フィールド: audio

説明

このパラメーターは、codecs=opus の場合は不要です。

url

String

はい

AUDIO ファイルの URL。

説明

URL は 7 日間有効です。

DOCUMENT フィールド

名前

種類

オプション

説明

name

String

はい

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

id

String

はい

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

filename

String

はい

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

mimeType

String

はい

値を application/pdf に設定します。

url

String

はい

ドキュメントの URL です。

説明

URL は 7 日間有効です。

REPLY フィールド

名前

種類

オプション

説明

text

String

はい

顧客がクリックしたボタンの名前。

payload

String

はい

ボタンがクリックされたときに返されるペイロード値。 この値は、メッセージ送信時に指定されたものです。

SYSTEM フィールド

名前

種類

オプション

説明

本文

文字列

はい

お客様の ID または電話番号の変更について説明します。

wa_id

文字列

はい

電話番号が更新された後のお客様の新しい WhatsApp ID。

タイプ

文字列

はい

システム更新の種類。有効な値:

  • customer_changed_number: お客様が電話番号を変更しました。

  • customer_identity_changed: お客様がプロファイルを変更しました。