このページはAIにより自動翻訳されており、不正確な内容が含まれている可能性があります。翻訳の誤りを報告するには、ページ右側の目次の下にあるフィードバックをご利用ください。

WhatsAppメッセージと画像のフォーマット

ここでは、WhatsAppメッセージとテンプレートを作成するためのメッセージ構造、コンポーネント、メディアアセットの要件について説明します。

BrazeのWhatsAppメッセージには、テンプレートメッセージと応答メッセージの2種類があります。

メッセージタイプ	使用タイミング	Metaの承認
テンプレートメッセージ	ビジネス主導のアウトリーチ。いつでも送信可能	必須。テンプレートはMetaに送信し、送信前に承認を受ける必要があります。
応答メッセージ	ユーザーが開始したメッセージへの返信。24時間の会話時間枠内のみ	不要

テンプレートメッセージはMetaに承認を申請する必要があり、最大24時間かかる場合があります。承認後はいつでも送信できます。応答メッセージ（Metaのドキュメントでは「セッションメッセージ」と呼ばれます）は、アクティブな会話時間枠が開いている間のみ送信できます。つまり、ユーザーからの最後の受信メッセージから24時間以内です。

テンプレートメッセージ

WhatsAppテンプレートメッセージは、ビジネス主導のアウトリーチに使用される事前承認済みのメッセージフォーマットです。Brazeでは、Metaに送信する前に定義するコンポーネントから構築されます。すべてのテンプレートメッセージはカテゴリベースで、マーケティング、ユーティリティ、または認証のいずれかです。

マーケティングテンプレート

マーケティングテンプレートは、Brazeで最も一般的に使用されるタイプです。最大4つのコンポーネントで構成されます。

コンポーネント	必須	備考
ヘッダー	いいえ	テキスト、画像、動画、文書、またはロケーションをサポートします。ファイルタイプ、サイズ、寸法の要件についてはメディア仕様を参照してください。
本文	はい	メインのメッセージコンテンツ
フッター	いいえ	本文の下に表示される補足テキスト
ボタン	いいえ	最大10個のボタンを含めることができます（すべてのボタンタイプがサポートされています）

文字数の長さ

コンポーネント	最大文字数
本文	1,024文字
フッター	60文字
ボタンラベル（URL、電話、クイック返信）	25文字
電話番号（電話ボタン内）	20文字
テンプレート名	512文字（小文字、英数字、アンダースコアのみ）

ボタンタイプ

ボタンタイプ	動作	備考
クイック返信	ボタンラベルのテキストを会話内の返信として送信します
URL	ユーザーのデフォルトブラウザでURLを開きます。URLの末尾に1つの変数を追加できます（最大2,000文字）
電話番号	指定された電話番号への通話を開始します
クーポンコードのコピー	クーポンコードをユーザーのクリップボードにコピーします	常にMetaの承認が必要です

パラメーターのフォーマット

テンプレート変数は、名前付きパラメーター（{{first_name}}など）または位置パラメーター（{{1}}など）のいずれかを使用できます。Brazeでは、変数をLiquidまたはプレーンテキストに置き換えることができます。Liquid変数には常にデフォルト値を含めてください。変数値が欠落しているメッセージは送信されません。

メディアカードカルーセルテンプレート

カルーセルテンプレートは、メッセージ本文の後に2〜10個の水平スクロール可能な製品カードを表示します。各カードには独自のメディアアセットとボタンがあります。マーケティングテンプレートメッセージでのみ利用可能です。

トップレベルメッセージ

コンポーネント	必須	最大プロパティ	備考
本文テキスト	はい	1,024文字	変数をサポートします
カード	はい	2〜10枚のカード	カード数はテンプレート作成時に固定されます。承認済みのカルーセルテンプレートは、作成時に定義された正確なカード数でのみ送信できます。

カードごとの仕様

コンポーネント	必須	備考
ヘッダー（画像または動画）	はい	すべてのカードは同じフォーマットを使用する必要があります（すべて画像またはすべて動画）。これには同じコンポーネント構造が含まれます。本文テキストやボタンの有無が異なるカードを混在させることはできません。カードヘッダーのアセットは、ユーザーのデバイスに基づいてワイド比率に自動的にトリミングされます。
本文テキスト	いいえ	いずれかのカードに本文テキストが含まれる場合、すべてのカードに本文テキストを含める必要があります
ボタン	いいえ	カードごとに最大2つのボタン

カードごとの文字数

コンポーネント	最大文字数	備考
カード本文テキスト	160文字
ボタンラベル	25文字
電話番号（電話ボタン内）	20文字
URL（URLボタン内）	2,000文字。末尾に1つの変数を追加可能	URLボタンはWhatsAppの外部で、ユーザーのデフォルトブラウザで開きます。その時点から注文やコンバージョンのWebhookはトリガーされません。

応答メッセージ

応答メッセージ（Metaでは「セッションメッセージ」とも呼ばれます）は、24時間の会話時間枠内でのみ送信できます。ユーザーがビジネスにメッセージを送信すると、時間枠が開かれリセットされます。

Brazeのキャンペーンまたはキャンバスエディターで直接作成された応答メッセージは、Metaの承認を必要としません。

Brazeは7つの応答メッセージレイアウトをサポートしています。

メッセージレイアウト	説明
テキスト	プレーンなメッセージ本文テキスト
メディア	画像、動画、オーディオ、または文書の添付ファイル付きメッセージ
クイック返信	最大3つのタップ可能な返信ボタン付きメッセージ
コールトゥアクション（CTA）ボタン	URLボタンまたは電話番号ボタン付きメッセージ
リストメッセージ	選択可能なオプションの構造化されたスクロール可能なリスト付きメッセージ
フローメッセージ	WhatsApp内でフォームまたはインタラクティブなタスクを完了するようユーザーに促すメッセージ。出力はBrazeに返されます
Meta製品メッセージ	接続されたMetaカタログから単一の製品、複数の製品、またはカタログ全体をハイライトするメッセージ

リストメッセージのコンポーネント

コンポーネント	最大プロパティ
本文テキスト	4,096文字
ボタンラベル（リストを開く）	20文字
セクション数	最大10
セクションごとの行数	最大10
セクションタイトル	24文字
行タイトル	24文字
行の説明	72文字

クイック返信のコンポーネント

コンポーネント	最大プロパティ
ボタン	最大3
ボタンラベル	ボタンごとに20文字

メディア仕様

以下の仕様は、WhatsAppテンプレートヘッダー、応答メッセージ、またはスタンドアロンメディアメッセージのすべてのメディアに適用されます。

注

Brazeメディアライブラリは画像と動画のみをサポートしています。オーディオファイルと文書は、ホストされたURLを通じて参照する必要があります。

画像

これらの仕様は、テンプレートヘッダー、レスポンスメディアメッセージ、および画像メッセージに適用されます。

プロパティ	仕様	備考
サポートされるフォーマット	JPEG、PNG	Metaは画像メッセージに対して JPEG と PNG のみを公式にサポートしています。WebP はスタンプ（標準の画像メッセージではない）でのみサポートされています。
最大ファイルサイズ	5 MB
カラーモード	8 ビット、RGB または RGBA
キャプション（画像メッセージのみ）	オプション、最大 1,024 文字
推奨サイズ	1,125 × 600 px	デバイス間で一貫したレンダリングとMetaの要件への準拠のため、1,125×600 px（1.91:1）の JPEG または PNG 画像の使用を推奨します。
推奨アスペクト比	1.91:1（ワイド）	正方形（1:1）およびワイド（16:9）フォーマットも使用できますが、ユーザーのデバイスによっては画像がクロッピングまたは拡大される場合があります。カルーセルカードの場合、ヘッダー画像はWhatsAppによって自動的にワイド比率にクロッピングされます。ただし、本文テキストがない場合は正方形でレンダリングされます。

動画

以下の仕様は、テンプレートヘッダー、レスポンスメディアメッセージ、動画メッセージ、およびカルーセルカードヘッダーに適用されます。

プロパティ	仕様
サポートされるフォーマット	MP4、3GPP
ファイルサイズ	最大 16 MB
動画コーデック	H.264 のみ
オーディオコーデック	AAC のみ
オーディオストリーム	単一オーディオストリームまたはオーディオストリームなし
キャプション（動画メッセージのみ）	オプション、最大 1,024 文字
推奨アスペクト比	1.91:1（ワイド）

重要

Metaには、特定のエンコーディングやコンテナ設定が原因で、一部のMP4動画がAndroidデバイスで再生できなくなる既知の問題があります。恒久的な修正が利用可能になるまで、MP4ファイルを再フォーマットすることで、ほとんどの送信者の問題が解決します。すべての動画をAndroidデバイスでテストして、正しく配信されることを確認してください。

MP4ファイルを再フォーマットするには、CloudConvertなどのWebツールを使用します。MP4ファイルをツールにアップロードし、再度MP4に変換してから、変換されたファイルをダウンロードしてください。

Androidの互換性

Bフレーム付きのH.264「High」プロファイルでエンコードされた動画は、AndroidのWhatsAppクライアントではサポートされていません。最も幅広い互換性を確保するには、BフレームなしのH.264「Main」プロファイルまたは「Baseline」プロファイルを使用してください。ffmpegで再エンコードする場合は、-movflags faststartフラグを使用してmoovボックスをmdatボックスの前に配置してください。

オーディオ

以下の仕様は、応答メディアメッセージとオーディオメッセージに適用され、オーディオタイプ（ボイスメッセージまたは基本オーディオメッセージ）に基づいています。

ボイスメッセージ

ボイスメッセージは、再生コントロールと文字起こしサポートを備えた録音されたボイスノートのように機能します。

プロパティ	仕様
必須フォーマット	OGGのみ
必須コーデック	OPUSのみ（モノラル入力）
ファイルサイズ	最大16 MB
再生アイコン	このアイコンはファイルが512 KB以下の場合にのみ表示されます。それより大きいファイルはダウンロードアイコンが表示されます
文字起こし	ユーザーがWhatsAppの音声文字起こしを有効にしている場合、自動的に表示されます

基本オーディオメッセージ

以下の仕様は、標準的なオーディオファイル共有（音楽クリップ、オーディオ広告、サウンドファイル）に適用されます。

フォーマット	拡張子	最大ファイルサイズ	備考
AAC	.aac	16 MB
AMR	.amr	16 MB
MP3	.mp3	16 MB
MP4 Audio	.m4a	16 MB
OGG（OPUSコーデック）	.ogg	16 MB	OGGファイルはOPUSコーデックを使用する必要があります。OPUSなしのベース`audio/ogg`はサポートされていません。基本オーディオメッセージとして送信されたOGG/OPUSファイルは、音楽アイコンではなくマイクアイコン（ボイスメッセージと同じ）が表示されます。

注意事項

注

オーディオメッセージではキャプションはサポートされていません。
よくあるエラーは、MIMEタイプの不一致です。送信前にファイルのMIMEタイプが拡張子と一致していることを確認してください。

文書

以下の仕様は、テンプレートヘッダー（文書フォーマット）、応答メディアメッセージ、および文書メッセージに適用されます。

文書タイプ	ファイルタイプ	最大ファイルサイズ
PDF	PDF	100 MB
Microsoft Word	DOC, DOCX	100 MB
Microsoft Excel	XLS, XLSX	100 MB
Microsoft PowerPoint	PPT, PPTX	100 MB
プレーンテキスト	TXT	100 MB

注意事項

注

キャプションはオプションで、最大1,024文字です。
ファイル名はオプションです。WhatsAppはファイル拡張子を使用して、会話内に表示する文書アイコンを決定します。
記載されたフォーマットのみが公式にサポートされています。その他のファイルタイプは送信できる場合がありますが、WhatsAppで正しくレンダリングされることは保証されません。

クイックリファレンス：WhatsAppメディア仕様

メディアタイプ	ファイルタイプ	最大ファイルサイズ	キャプションの可否
画像	JPEG, PNG	5 MB	あり（最大1,024文字）
動画	MP4, 3GPP	16 MB	あり（最大1,024文字）
オーディオ（ボイス）	OGG (OPUS)	16 MB	なし
オーディオ（基本）	AAC, AMR, MP3, M4A, OGG	16 MB	なし
文書	PDF, DOC, DOCX, XLS, XLSX, PPT, PPTX, TXT	100 MB	あり（最大1,024文字）

New Stuff!