WhatsApp エラー 132000: パラメーター数の不一致

メッセージテンプレートの変数はどのように数えますか？

テンプレート本文の番号付きプレースホルダーを使い、コンポーネントごとに順番どおり数えます。

「Hello {{1}}, your order {{2}} has shipped」という本文のメッセージテンプレートでは、2 つの変数が定義されています。そのため、送信時には body コンポーネントに正確に 2 つの値を指定する必要があります。1 つまたは 3 つを指定すると、このエラーが返されます。2 つ指定していても、誤ったコンポーネントに指定した場合は同様です。header、body、button のパラメーターは、1 つのリストにまとめず個別に数えるためです。

そのため、最初はエラーの内容が間違っているように見えることがあります。値の合計数が正しくても、コンポーネント間の配分が正しくない場合があるためです。

昨日まで動いていたメッセージテンプレートで、なぜ発生するのですか？

誰かがメッセージテンプレートを編集した後、送信コードを更新していないことが原因です。

承認後でもメッセージテンプレートは編集でき、プレースホルダーを追加または削除すると、送信側から見た仕様が通知なしに変わります。連携側には警告が表示されないため、次の送信で失敗します。WhatsApp Manager でマーケティング担当者がメッセージテンプレートを編集し、エンジニアリング担当者が送信コードを管理するチームでは、これが最もよくある発生原因です。

対策は、初回作成時に記録した値を信頼するのではなく、メッセージテンプレートを読み取り直すことです。メッセージテンプレートの一覧取得では現在の定義が返されます。送信時に重要なのは、この最新版だけです。

値はどのように正しく指定しますか？

メッセージテンプレート自体の構造に合わせて components 配列を組み立てます。

各コンポーネントには type が指定され、プレースホルダーの出現順に独自の parameters を持たせます。変数が 2 つある本文には、2 つのテキストパラメーターを持つ body コンポーネントが必要です。header にも変数があるメッセージテンプレートでは、header コンポーネントと独自のパラメーターも指定します。header の値を body のリストに追加してはいけません。

MCP コネクターを使う場合、この処理の多くは自動化できます。アシスタントがメッセージテンプレートを読み取り、各コンポーネントのプレースホルダー数を確認して、依頼内容から値を設定します。独自コードでは、変更される可能性のある構造をハードコードせず、起動時にメッセージテンプレートの定義を読み取ると安心です。

よくある間違い

• header と body の変数を 1 つのリストにまとめる。変数はコンポーネントごとに数えます
• 変数の数をハードコードする。メッセージテンプレートの編集で、送信側への通知なしに変わります
• 未使用のプレースホルダーに空文字列を送る。テンプレートには定義が残るため、数を一致させる必要があります

よくある質問

続きを読む