テンプレート管理

テンプレートの作成

[テンプレート管理] でテンプレートを作成するには、次の情報を順に入力してください。

• テンプレート名
• テンプレート ID: 送信 API を呼び出す際の入力パラメータとして使用します
• 署名: テンプレート内容中の {{brand_name}} の値を入力するために使用します
• 送信戦略: 詳細は下記の説明を参照してください
• コードの長さ／種別: OTP の長さと種別（数字、大文字、数字 + 大文字）を定義します
• コードの有効期間: OTP の有効期間を分単位で定義し、テンプレート内容中の {{ttl}} の値を入力するために使用します。より長い有効期間が必要な場合は、営業担当にご連絡いただくか、support@aurora-mobile.com までメールでお問い合わせください

送信戦略

EngageLab OTP は、電話番号または Email チャネルに基づく送信に対応しており、電話番号チャネルではカスタムのフォールバック戦略をサポートしています。詳細は次のとおりです。

電話番号チャネル

電話番号チャネルでは、EngageLab OTP は現在、SMS、WhatsApp、または Voice を通じた OTP メッセージの配信に対応しています。

少なくとも 1 つのメイン送信チャネルを設定する必要があり、任意で最大 2 つのフォールバックチャネルを設定できます。

メイン送信チャネルのみを設定した場合、このテンプレートはメイン送信チャネルを通じてのみ OTP メッセージを配信します。フォールバックチャネルを設定した場合、メイン送信チャネルでの送信に失敗すると、システムは成功するか、またはフォールバックチャネルがなくなるまで、自動的にフォールバックチャネルを使用します。

メインチャネルとフォールバックチャネルの順序と数は自由に組み合わせられますが、各チャネルは 1 回しか追加できません。例:

• SMS → WhatsApp → Voice
• SMS → Voice
• WhatsApp → SMS → Voice
• ...

SMS

SMS チャネルを設定する際は、まずテンプレートを選択する必要があります。デフォルトテンプレートを提供しています。次の項目を追加することも選択できます。

• セキュリティ注意: システムが OTP メッセージの末尾にセキュリティ注意を追加します。例: 「このコードは誰にも共有しないでください。」
• OTP 有効期限の注意: システムが OTP メッセージの末尾に OTP メッセージの有効期間を追加します。例: 「6 分後に失効します。」

テキストボックスに入力して、テンプレート内容をカスタマイズすることもできます。

{{variable_name}} の形式でテンプレート変数をカスタマイズできます。

カスタムテンプレートの場合、送信対象として最大 5 つの国／地域を選択する必要があります。

WhatsApp

WhatsApp チャネルを設定する際は、テンプレートを選択し、その後任意でセキュリティ注意と OTP 有効期限の注意を追加できます。

Voice

Voice チャネルを設定する際は、テンプレートを選択し、その後任意でセキュリティ注意と OTP 有効期限の注意を追加できます。

Email チャネル

Email チャネルとは、システムが Email アドレスを通じて OTP メッセージを配信することを意味します。

ここでは次の操作が必要です。

• テンプレートを選択する
• 送信者の Email アドレスと名前を入力する

テンプレート変数

テンプレートでは変数をカスタマイズできるほか、システムも直接利用できるプリセット変数をいくつか提供しています。カスタム変数はこれらのシステム変数と同じ名前にできない点にご注意ください。

Email テンプレート変数

送信戦略で Email チャネルを有効にすると、メールの件名と本文を高度にカスタマイズできます。変数プレースホルダー {{variable_name}} を使うことで、検証コードやブランド情報などを自動的に差し込み、柔軟でパーソナライズされたメール体験を実現できます。

Email テンプレート変数の詳細な高度な使い方（送信者やメール件名の動的な上書きなど）については、API ドキュメントの Email テンプレート変数の高度な使い方 を参照してください。

テンプレートの審査

テンプレートを作成して送信すると、審査待ちのステータスになります。テンプレートは EngageLab の専門の運用担当者によって審査され、承認後にのみ正式に利用できます。