WhatsApp 返信メッセージ

WhatsApp アウトバウンドリプライでは、会話内の既存メッセージを引用/返信することができます。これはエンドユーザーのメッセージでも、自社のメッセージでも構いません。メッセージの内容だけでは伝わりにくい部分を明確にするため、企業はメッセージを送信する際に追加の文脈を提供することができます。

企業は引用/返信することができる:

  • エンドユーザーのメッセージ。これは、ビジネスによって送信された最新のメッセージが、エンドユーザーのメッセージに関連するものであることを明確にするために使用される。 具体的 例えば、"ご質問の件ですが、答えは... "のように。
  • 企業から送られたメッセージ。例えば、"This is the option I was referring"(これが私の言っていたオプションです)など。

WhatsAppのUIでは、受信者は新しいメッセージと、前のメッセージの内容を表示するコンテクストバブルを受け取ります。

Screenshot of an outbound reply message in the WhatsApp UI

APIリクエスト・ペイロード

送信メッセージと送信されるWhatsAppメッセージタイプの標準フィールドを送信するには、APIリクエストのJSONペイロードにトップレベル context プロパティを持ちます。このプロパティの値は、次の1つのプロパティを持つオブジェクトです。 message_uuidこの値は引用/返信されるメッセージのUUIDである。

JSONペイロードの例は次のようになる:

{
	"to": "447700900000",
	"from": "447700900001",
	"channel": "whatsapp",
	"message_type": "text",
	"text": "This looks like your order number. Can you confirm?",
	"context": {
		"message_uuid": "a1b2c3d4a1b2c3d4"
	}
}

制限事項

  • この機能は クラウドAPI ホストWABAのみ(以下を参照 WhatsApp番号ホスティング)
  • 返信は、引用/返信された元のメッセージが受信/送信されてから30日以内に行う必要があります。

潜在的なエラー

保存されていないメッセージに返信しようとすると、そのメッセージは存在しないか、30日の期限が過ぎているため、以下のエラーコードとともに拒否されます:

1451 - Invalid context - the reference to the original message could not be found because it is invalid or no longer available