変数を含むテンプレートの送信

パラメータの照合方法

名前ではなく位置で照合します。本文リストの最初のパラメータが最初のプレースホルダーに入り、2 番目が 2 番目に入り、その後も同様です。変数に名前を付ける方法はありません。2 つのパラメータを入れ替えると、値が間違った場所に入ったまま、メッセージは正常に送信されます。

このケースが危険なのは、何も失敗しないためです。顧客には、金額が入るべき場所に日付が入った注文確認が届きますが、どこにもエラーは記録されません。

コンポーネントは別々のリスト

ヘッダー変数と本文変数は同じリストを共有しません。各コンポーネントが独自のパラメータを持つため、それらを結合すると件数不一致になります。

• ヘッダーのパラメータはヘッダーコンポーネントに入れます。最大 1 つです。
• 本文のパラメータは本文コンポーネントに順番どおり入れます。
• ボタン URL のパラメータはボタンごとにインデックス付けし、ボタンコンポーネントに入れます。
• すべてを 1 つのフラットなリストで送ると、エラー 132000 が返ります。

言語を正しく指定する

テンプレートは名前と言語の組み合わせで識別されるため、同じ名前でも言語が違えば別のテンプレートです。テンプレート作成時の言語が en_US なのに en を送ってもフォールバックせず、エラー 132001 でテンプレートが存在しないように扱われます。

番号のテンプレート一覧を取得し、形式を推測せず、正確な言語文字列をコピーしてください。これは最もよくあるテンプレートエラーで、最も説明が不十分なエラーでもあります。

型付きパラメータ

ほとんどのパラメータはプレーンテキストです。ただし例外があり、それらをテキストとして送るとエラー 132012 になります。

• 通貨パラメータには、金額、通貨コード、フォールバック文字列を指定します。
• 日付と時刻のパラメータには、フォールバックを含む構造化オブジェクトを指定します。
• メディアヘッダーのパラメータには、ファイル名ではなくメディア ID またはリンクを指定します。
• フォールバック文字列は、受信者のアプリで値を表示形式に変換できない場合に表示されます。

それぞれのエラーの意味

3 つの失敗は区別できます。テンプレートエラーとしてまとめず、個別にログへ記録すれば、原因を推測する手間を大きく減らせます。

エラー 132001 は名前と言語の組み合わせを解決できなかったことを示すため、まず言語を確認します。エラー 132000 は件数が間違っていることを示すため、テンプレート自身の定義と比較します。エラー 132012 は値の形式が間違っていることを示し、通常は型付きパラメータをプレーンな文字列として送っています。

よくある間違い

• en が en_US にフォールバックすると考える。実際にはフォールバックせず、テンプレートがないというエラーになります。
• ヘッダーと本文のパラメータを 1 つのリストに結合する。これらは別々のコンポーネントです。
• 通貨や日付をプレーンテキストで送る。型付きパラメータには決められた形式があります。

よくある質問

続きを読む