WhatsApp テンプレート メッセージを送信する

このドキュメントでは、Advanced Communication Messages SDK を使用して WhatsApp テンプレート メッセージを送信するためのガイダンスを提供します。

テンプレート メッセージを送信する必要がある理由

ユーザーが企業にメッセージを送信するまで、企業はテンプレート メッセージのみを送信できます。

ビジネスまたはユーザーは会話ウィンドウを開始できますが、送信できるメッセージの種類に制限があります。 ユーザーが企業にメッセージを送信してはじめて、企業はアクティブな会話中にテキストまたはメディア メッセージをユーザーに送信できます。 24 時間の会話の期限が切れたら、会話を再開する必要があります。 会話の詳細については、WhatsApp Business Platform で定義を参照してください。

テンプレートに関する WhatsApp の要件については、以下の WhatsApp Business Platform API リファレンスを参照してください:

• テンプレートの作成と管理
• テンプレートのコンポーネント
• テンプレートメッセージの送信
• 企業は、WhatsApp ユーザーにメッセージを送信する前に、オプトイン要件にも従う必要があります

テンプレートの選択

埋め込みサインアップ中に Azure portal を通じて WhatsApp ビジネス アカウントを作成すると、一連のサンプル テンプレートが利用できるようになります。

テンプレートの作成

独自のテンプレートを作成するには、Meta WhatsApp Manager を使用します。

「WhatsApp ビジネス アカウントのメッセージ テンプレートを作成する」の Meta Business Help Center の指示に従います。

テンプレートの一覧を表示します。

Azure portal でテンプレートを表示するには、[Azure Communication Service リソース] >[テンプレート] に移動します。

テンプレートを選択して詳細を表示します。

テンプレート詳細の content フィールドには、パラメーター バインドを含めることができます。 パラメータ バインドは、次のように表すことができます。

• format などの値を持つ IMAGE フィールド。
• 数値を囲む二重括弧 ({{1}} など)。 1 から始まるインデックスが付けられた番号は、メッセージ テンプレートを作成するためにバインド値を指定する必要がある順序を示します。
• 名を囲む二重角かっこ、例: {{movie_name}}。 名前付きパラメーターを使用すると、開発者は位置ではなく名前でパラメーターを参照できます。

  Von Bedeutung

  名前付きパラメーターを使用する場合は、メッセージの送信時に使用する名前が、Meta WhatsApp Manager で作成したテンプレートで定義されている名前 と正確に一致 していることを確認する必要があります。

または、[WhatsApp Manager] > [Account tools] > [Message templates] で、WhatsApp ビジネス アカウントのすべてのテンプレートを表示および編集することもできます。

プログラムを使用してテンプレートを一覧表示するには、自分のチャネル ID のすべてのテンプレートをフェッチします。

MessageTemplateClient messageTemplateClient = new MessageTemplateClient(connectionString);
Pageable<MessageTemplateItem> templates = messageTemplateClient.GetTemplates(channelRegistrationId);

クイック リファレンス

sample_template にパラメーターはありません。

ターゲット テンプレートの名前と言語を参照して、MessageTemplate をアセンブルします。

string templateName = "sample_template"; 
string templateLanguage = "en_us"; 

var sampleTemplate = new MessageTemplate(templateName, templateLanguage); 

Advanced Messages SDK による詳細な例とテンプレート対応シナリオについては、次をご覧ください。

• WhatsApp テンプレートのクイック スタート

次のステップ

• Advanced Communication Messages SDK の概要