sent-templates

送信済みテンプレート

templates.list、templates.get、templates.get_by_name、templates.delete を使って、既存のテンプレートレコードを操作します。

接続とスコープの確認

クライアント管理の OAuth 2.1/PKCE を使用し、認証情報を要求したり公開したりしないでください。削除前に、アクティブな組織と Sender Profile を表示してください。接続コンテキストから両方を確認できない場合は、sent-account-readiness を使用してください。

テンプレート本文やサンプルデータを不必要に繰り返さないでください。概要では、テンプレートの識別子、名前、言語、チャネル、カテゴリ、ステータスを優先してください。

組織の認可では、ツールスキーマのオプションの profileId を指定して、所有する Sender Profile を選択できます。指定しない場合は、認証済みアカウントが操作対象になります。sender_profiles.list または sender_profiles.get で所有権を検証し、事前確認の読み取り、変更、変更後の読み取りで同じセレクターを使用してください。プロフィールの認可では、このセレクターを使用できません。別の組織、または認可範囲外のプロフィールを操作するには、再認可してください。スコープフィールドを捏造したり、認証情報を要求したりしないでください。

テンプレートの検索と確認

• 絞り込み検索とページネーションには templates.list を使用します。
• 正確なテンプレート識別子で検索するには templates.get を使用します。
• ユーザーから名前が指定された場合は templates.get_by_name を使用します。名前が複数の言語、チャネル、またはスコープに一致する可能性がある場合は、候補を提示し、続行する前に対象のレコードを1つに特定してください。

これらのツールは既存のレコードを確認するためのものです。テンプレートの作成や分類には waba-template-author に引き継ぎ、テナント向けの作成エクスペリエンスには template-builder-ui に引き継いでください。

テンプレートの削除

1. リクエストの対象を1つのテンプレートに特定します。
2. templates.get または templates.get_by_name で、まず対象を取得します。推測した識別子、広範なフィルター、古いリスト結果から削除してはいけません。
3. 選択した組織、Sender Profile、正確なテンプレート識別子、名前、言語、チャネル、カテゴリ、ステータスを含む削除プレビューを表示します。削除は取り消せない操作であることを伝え、本文は繰り返さないでください。
4. この正確な対象を削除する明示的な確認を求めます。それ以前の承認や一般的な承認では不十分です。
5. 確認後、ただちに templates.delete を呼び出します。対象、スコープ、またはレコードが変更された場合、確認は無効になります。

対象を取得し、呼び出しの直前に明示的な確認を得ることなく、templates.delete を呼び出してはいけません。再試行も新たな変更操作として扱い、対象を再取得して、新しいプレビューを表示し、新たな明示的な確認を得てください。

結果が曖昧な場合は、可能であれば対象を再取得してください。不確実であることを報告し、自動的に再試行しないでください。