WhatsApp エラー 132012：テンプレートパラメーター形式の不一致
エラー 132012 は、送信したパラメーター値がテンプレートで定義された形式と一致しないことを示します。変数が 3 つあるテンプレートには、正しい型の値を順序どおりに 3 つ指定する必要があります。少しでも異なると、このエラーが発生し、部分送信にはなりません。
テンプレート形式と一致しないパラメーターに対する Meta のコードです。
期待されたパラメーター数と指定された数が一致しない場合の関連コードです。
テンプレート名と使用言語を解決できない場合のコードです。
何を一致させる必要がありますか
すべてです。部分一致はなく、すべての不一致は通知なしに失敗します。
- 個数：本文にプレースホルダーが 3 つある場合、本文パラメーターも過不足なく 3 つ必要です。
- 順序：パラメーターは位置で対応付けられます。2 つを入れ替えると、値が誤った場所に入ったメッセージが送信されるか、型が異なる場合はこのエラーになります。
- 型：通貨や日付のパラメーターには定義済みのオブジェクト形式があり、プレーンテキストとして送信できません。
- コンポーネント：ヘッダー、本文、ボタンのパラメーターは別々のリストであり、1 つにまとめることはできません。
本番環境を止める編集
テンプレートを編集する人と API を呼び出す人は、同じとは限りません。メッセージをわかりやすくするために誰かが変数を追加し、テンプレートが再承認されると、変更していない連携からの送信がすべて失敗し始めます。
これは、発生してから気付くのではなく、事前に防ぐべき問題です。テンプレート状態の Webhook を購読すると、編集をイベントとして受け取れます。また、テンプレートの変数数を連携の仕様の一部として扱い、変更時に確認すれば、文言の改善が障害に変わるのを防げます。
よくある間違い
- 念のため余分なパラメーターを送る。多すぎても少なすぎても誤りです。
- 位置パラメーターを名前付きとして扱う。位置だけで対応付けられます。
- 送信処理のコードを確認せずにテンプレートを編集する。
EasyCoexistence はテンプレート状態のイベントをエンドポイントに配信するため、Business Manager で編集されたテンプレートを次の送信が失敗する前に把握できます。
よくある質問
パラメーターはいくつ送信しますか？
テンプレートで定義されている数と同じ数を、順序どおりに送信します。
余分なパラメーターを送信できますか？
いいえ。多すぎる場合も少なすぎる場合と同じように失敗します。
なぜ突然この問題が起きたのですか？
通常は、テンプレートが編集されて変数の数が変わったことが原因です。
パラメーターには名前がありますか？
いいえ。位置で対応付けられるため、順序が重要です。
続きを読む
始める準備はできましたか？
WhatsApp Coexistence の設定は数分で完了し、数か月もかかりません。スマートフォン上のアプリも引き続き使えます。
無料トライアルを始める確認日