WhatsApp エラー 131009:無効なパラメーター値
エラー 131009 は、1 つ以上のパラメーター値が無効な場合に発生します。フィールド自体は存在して認識されていますが、その内容をエンドポイントが受け付けません。多くはロケールコード、電話番号の形式、enum 値が原因です。
サポートされない値を持つパラメーターが存在するときの Meta のエラーコードです。
メッセージテンプレート名と言語の組み合わせが存在しないときに返されます。
サポートされない、または形式が不正なパラメーターを示す、より広いエラーコードです。
特に失敗しやすい値
大半の原因は 3 種類で、どれも見た目には正しく見えます。
- ロケールコード:テンプレートが en_US で作成されているのに en を指定する、または pt_BR なのに pt を指定する場合です。
- 句読点、先頭の 0、プラス記号を含む電話番号です。国際形式の数字のみが必要です。
- テンプレートカテゴリなど、enum 値の大文字と小文字が違う場合です。
- エンドポイントの仕様とは異なる形式の日付またはタイムスタンプです。
ロケールの問題を特に確認すべき理由
エンドポイントによって異なる 2 種類のエラーが発生するため、誤った原因を追いかけがちです。
その名前に存在しない言語でテンプレートを送ると 132001 が返り、テンプレートが存在しないように見えます。一方、ロケールを先に検証するエンドポイントに不正なロケールを渡すと、このエラーが返ります。根本原因は同じで、どちらの場合もテンプレート一覧を確認し、形式を推測せず正確な言語文字列をコピーすることが解決策です。
よくある間違い
- en と en_US は互換性があると思い込む。これらは別のテンプレートを識別します。
- プラス記号や句読点付きの電話番号を送る。国際形式で数字のみを指定します。
- 再試行する。値が決定的に誤っています。
EasyCoexistence ではテンプレートと正確な言語コードを一覧で確認できるため、見た目ではなく Meta が保存した値を送信できます。
よくある質問
どの値が間違っていますか?
通常はレスポンスにパラメーター名が示されます。示されない場合は、まずロケールと電話番号形式を確認してください。
電話番号はどのような形式にすべきですか?
国際形式で、プラス記号や句読点を使わず、数字のみで指定してください。
同じミスで 132001 が返ることがあるのはなぜですか?
テンプレート送信では名前と言語を組み合わせて解決するため、未知の組み合わせがテンプレート不在として扱われるからです。
これは自分の番号の問題ですか?
いいえ。このエラーの対象はリクエストのみです。
続きを読む
始める準備はできましたか?
WhatsApp Coexistence の設定は数分で完了し、数か月もかかりません。スマートフォン上のアプリも引き続き使えます。
無料トライアルを始める確認日