WhatsAppフリーフォームメッセージを使用する

---

自由形式メッセージは、テキスト、メディア、場所、インタラクティブ メッセージなど、有効なセッション内でユーザーに送信できる非テンプレート メッセージです。これらのメッセージはMetaの承認を必要としませんが、厳格な配信ルールに従う必要があります。

---

自由形式のメッセージはいつ送信できますか?

自由形式のメッセージは、ユーザーの最後のメッセージから 24 時間以内にのみ送信できます。これは、メッセージング ウィンドウ と呼ばれます。

• 24 時間のセッションは、ユーザーからの受信メッセージごとにリセットされます。
• 期間が切れた場合は、代わりに事前承認済みのテンプレートを使用する必要があります。

---

サポートされているメッセージの種類と制限

WhatsAppは、さまざまな自由形式のメッセージタイプをサポートしています。各タイプには、特定のファイル形式とサイズ制限があります。

メッセージの種類

メッセージの種類	サポートされている形式	最大サイズ/制限
テキスト	プレーンテキスト、絵文字、Markdown(制限付き)	• 4,096 文字
画像	.jpeg、.jpg、.png	• 5メガバイト •8ビット、RGBまたはRGBA • 最大 3,000 文字の画像キャプション
ビデオ	「.mp4」、.3gp(H.264 + AAC のみ)	• 16 MB、シングル オーディオ ストリームのみ •最大3,000文字のビデオキャプション
オーディオ	.aac、.m4a、.amr、.mp3、.ogg	• 16メガバイト
文書	.pdf、.xls(x)、.doc(x)、.ppt(x)、.txt	• 100メガバイト • ドキュメント名 240 文字以内
ステッカー	.webp (静的/アニメーション)	100 KB(静的) • 500 KB(アニメーション)
場所	緯度、経度、オプションの名前/住所	-
連絡先	vCardオブジェクト(名前、電話番号、メールアドレスなど)	-

テキストの書式設定ルール

WhatsAppは、フォーマットのためにMarkdownの限られたサブセットをサポートしています。

フォーマッティング	記号	例	プレビュー
ボールド	アスタリスク (*)	これは太字です。	これは 大胆です。
イタリック 体	アンダースコア (_)	これは_斜体_です。	これは イタリック体です。
取り消し線	チルダ (~)	これは取り消し線です。	これは 取り消し線です。
コード	3 つのバッククォート ( ```)	これは '''コード''' です。	これは codeです。

テキスト メッセージには、URL を含めて最大 4,096 文字を含めることができます。URL プレビューを有効または無効にすることもできます。

---

利用可能なインタラクティブ形式

自由形式メッセージには、24 時間のセッション・ウィンドウ内にいる場合、いくつかの対話式要素を含めることができます。

表示形式	形容
メッセージの一覧表示	最大 10 項目のスクロール可能なリスト
ボタンメッセージ	最大 3 つのタップして返信ボタン (テキストのみ)
製品メッセージ	メタカタログの1つの製品カード
複数製品のメッセージ	10 のセクションに最大 30 個の製品
URL ボタン メッセージ	指定した URL にユーザーを誘導する
位置情報リクエストメッセージ	現在地または近くの位置情報を共有するようユーザーに求めます
お支払いメッセージ(インドとブラジルのみ)	WhatsApp Paymentsを介した2段階の注文+確認フロー。

リスト・メッセージ

リスト メッセージを使用して、ユーザーが 最大 10 個の項目のスクロール可能な一覧 から 1 つのオプションを選択できるようにします。この形式は、場所、サービス カテゴリ、予定枠の選択などのワークフローに役立ちます。

必要条件：

• 1 つのメッセージで選択できる項目は 1 つだけです
• ユーザーが開始した 24 時間のセッション中にのみ送信できます
• 各セクションには、少なくとも 1 つの行を含める必要があります

構造：

• ヘッダー (オプション): テキスト、最大 60 文字
• 本文 (必須): メッセージの内容、最大 1,024 文字
• フッター (オプション): テキスト、最大 60 文字
• リスト ボタン: リストを開く表示ボタン、最大 20 文字
• セクション タイトル: 行の表示グループ見出し、最大 24 文字
• リスト項目:
  • タイトル(必須):最大24文字
  • 説明 (オプション): 最大 72 文字
  • ポストバック: 選択時に返されるペイロード値、最大 200 文字

ボタンメッセージ

最大 3 つのクイックリプライ ボタンを含むメッセージを送信し、ユーザーは事前定義されたオプションの 1 つを選択して即座に応答できます。これは、テンプレートのクイック返信と同様に機能しますが、自由形式のメッセージでも使用できます。

構造：

• ヘッダー(省略可): テキスト(最大 60 文字)またはメディア(画像、動画、ドキュメント)
• 本文 (必須): メッセージの内容、最大 1,024 文字
• フッター (オプション): テキスト、最大 20 文字
• ボタン:1〜3個のテキスト専用ボタン、それぞれ最大20文字

製品メッセージ

商品メッセージには、メタカタログから1枚の商品カードが表示されます。ユーザーは、質問をしたり、製品の詳細を表示したり、製品をカードに追加したり、すべてWhatsApp内でチェックアウトに進むことができます。

必要条件：

• メタカタログは、WhatsApp Business アカウントに 接続 である必要があります。

構造：

• 本文(必須):最大1,024文字
• フッター (オプション): 最大 60 文字
• カタログID:WABAに接続されているFacebookアカウントのカタログID
• 製品 ID: カタログと一致する必要があります

水平方向にスクロール可能なビューで最大 10 個の製品メッセージを送信できます。省略可能なフィールド (フッターなど) が含まれている場合は、各カードで同じコンポーネントを使用する必要があります。

複数製品のメッセージ

複数商品メッセージを使用すると、10のセクションに最大30個の商品を紹介でき、ユーザーはチャット内で商品を参照してカートに追加できます。

必要条件：

• メタカタログは、WhatsApp Business アカウントに 接続 である必要があります。

構造：

• ヘッダー (必須): 最大 60 文字
• 本文(必須):最大1,024文字
• フッター (オプション): 最大 60 文字
• カタログID:WABAに接続されているFacebookアカウントのカタログID
• セクション タイトル: 表示されるグループ見出し、最大 24 文字
• 製品 ID: カタログと一致する必要があります

URL ボタンのメッセージ

URL ボタンメッセージを使用してメッセージにクリック可能なリンクを埋め込むと、受信者は 1 回のタップで Web サイト、ランディングページ、またはドキュメントを開くことができます。

構造：

• 本文 (必須):
• ヘッダー (オプション)
• フッター (オプション)
• ボタン
  • ラベル:最大20文字
  • URL: 最大 2,048 文字。静的にすることも、動的なプレースホルダーを含めることもできます

また、短縮とトラッキングボタンの URL などの高度なオプションを有効にして、メッセージを調整し、貴重なエンゲージメント指標を収集することもできます。

位置情報要求メッセージ

位置情報リクエスト メッセージでは、ユーザーに位置情報をすばやく共有するように求められます。これは、予約、配送先住所、または店舗検索フローに役立ちます。

制限：

• ユーザーは現在地を共有できず、自分または近くの場所のみを共有します。
• 24時間のオープンセッション内でのみ送信できます

支払メッセージ

WhatsApp Paymentsを使用すると、企業はチャットで直接支払いを回収できます。次の 2 つのメッセージ構造を使用します。

1. order_details: お支払いをリクエストするためにビジネスから送信されます。
2. order_status: お支払いが成功したことを確認するためにビジネスから送信されます。

構造 (メッセージごと):

• ヘッダ
• 体
• フッター
• アクション: 支払いを完了するために必要なすべての情報を含めます。

WhatsAppペイメントは、一部の地域(インド、ブラジル)でのみご利用いただけます

詳細については、WhatsApp Paymentsセクションを参照してください。

---

API 経由で自由形式のメッセージを送信する

次の自由形式のメッセージを API 経由で送信できます。

API	形容
テキストメッセージを送る (opens in a new tab)	1 人または複数の受信者にプレーン テキスト メッセージを送信します。
画像を送信 (opens in a new tab)	オプションのキャプションを付けた画像メッセージを送信します。
動画を送信 (opens in a new tab)	ビデオメッセージを送信し、必要に応じてキャプションとサムネイル付きで送信します。
音声を送信する (opens in a new tab)	音声録音やミュージッククリップなどのオーディオファイルを送信します。
書類送付 (opens in a new tab)	オプションのファイル名でファイルメッセージを送信します。
ステッカーを送る (opens in a new tab)	静的またはアニメーションのWebPステッカーを送信します。
送信場所 (opens in a new tab)	GPS 座標とオプションの住所を使用して、静的な位置ピンを共有します。
連絡先の送信 (opens in a new tab)	保存した連絡先を vCard として送信します。
インタラクティブボタンの送信 (opens in a new tab)	1 つのメッセージで最大 3 つのクイックリプライ ボタンを送信できます。
インタラクティブリストの送信 (opens in a new tab)	1 つ以上のセクションにグループ化された項目のスクロール可能なリストを送信します。
製品メッセージの送信 (opens in a new tab)	接続されたメタカタログから1つの製品を送信します。
複数商品メッセージの送信 (opens in a new tab)	最大 30 個の製品のコレクションをスクロール可能な形式で送信します。

---