メインコンテンツへスキップ
本記事では、メッセージテンプレートの作成、削除、有効化、無効化、複製、テスト、および設定の方法について説明します。

​
メッセージテンプレートの作成と設定

  1. 開発者コンソールにログインします。
  2. アプリ開発をクリックし、サードパーティ社内アプリを選択して、ミニプログラムまたは H5 マイクロアプリを作成します。
  3. アプリ詳細ページでメッセージプッシュをクリックします。メッセージテンプレート管理エリアで、追加をクリックします。
  4. テンプレートタイプを選択し、作成をクリックします。
  5. メッセージテンプレートを設定し、保存をクリックします。 重要 テンプレートにテンプレートパラメータが設定されている場合、それらは自動的に下部に読み込まれ、各動的パラメータの説明を設定できます。 メッセージコンテンツ内の一部の値は、注文番号、電話番号、商品名など、動的に変化します。これらの値はテンプレート設定時には確定できないため、テンプレートパラメータを使用して置換できます。
  6. テストをクリックし、次にテストメッセージを送信をクリックして、メッセージテンプレートが正しく設定されていることを確認します。

​
Markdown テンプレートの設定

Markdown テンプレートは、Markdown 構文を使用してメッセージを設定・送信します。操作を必要としない純粋な通知メッセージに適しています。 Markdown テンプレートを使用すると、テキスト、画像、リンクなどの表示形式を簡単にサポートできます。 Markdown メッセージテンプレートの設定 Markdown 構文：

​
ActionCard テンプレート

ActionCard テンプレートは、ActionCard メッセージタイプのメッセージを送信します。メッセージコンテンツとアクションポイントを組み合わせたメッセージをサポートし、メッセージ内の 1 つまたは複数のアクションポイントを使用して迅速に処理する必要があるシナリオに適しています。 Markdown テンプレートをベースに、ActionCard テンプレートは全体リダイレクトと個別リダイレクトの両方のスタイルをサポートします。 ActionCard テンプレートの設定

​
フォームテンプレート

フォームテンプレートは、OA メッセージタイプに基づいてメッセージを送信します。注文などのメッセージ表示に適しており、メッセージ詳細を表示するためのリダイレクトをサポートします。 フォームメッセージテンプレートの設定

​
テンプレートパラメータの設定

メッセージコンテンツ内の一部の値は、注文番号、電話番号、商品名など、動的に変化します。これらの値はテンプレート設定時には確定できないため、テンプレートパラメータを使用して置換できます。 業務通知を送信するときに、実際の値を渡してテンプレートパラメータを置換します。テンプレートパラメータは任意で、必要に応じて設定できます。 テンプレートパラメータの形式 テンプレートパラメータは ${parameter name} の形式を使用します。パラメータは以下の仕様に準拠する必要があります。
  • 文字またはアンダースコアで始まる必要があります。
  • 残りの部分は、文字、アンダースコア、数字で構成できます。
  • 1 つのメッセージに動的パラメータを設定しすぎないでください。5 つ以内を推奨します。
例えば、メッセージコンテンツが以下のとおりだとします：
ここで、${product} はパラメータ名が product のテンプレートパラメータです。メッセージ送信時に、このパラメータの値を渡すだけです。例えば、メッセージ送信時に product の値として「使い捨てマスク」を渡します。すると「使い捨てマスク」が ${product} テンプレートパラメータを置き換え、ユーザーが最終的に受け取るメッセージコンテンツは以下のようになります：
メッセージテンプレートには、複数のテンプレートパラメータを設定することも、まったく設定しないこともできます。実際のニーズに基づいて設定してください。 ID 変換 動的パラメータを渡すときに、ID 変換がサポートされます。現在、部門 ID を部門名に変換すること、および userId をユーザー名に変換することをサポートしています。 ID 変換の構文は以下のとおりです：
ここで：
  • DEPARTMENT_ID は数値の部門 ID です。
  • USERID はユーザーのユーザー ID です。
例：
  • departmentName=100departmentName=100 を、部門 ID「100」に対応する部門名（例：「DingTalk Open Platform」）に置き換えます。
  • userName=zhangsan01userName=zhangsan01 を、ユーザー ID「zhangsan01」に対応するユーザー名（例：「山田太郎」）に置き換えます。

​
審査に提出

メッセージテンプレートを作成した後、送信をクリックしてテンプレートを審査に提出します。

​
テンプレートの有効化

テンプレートが審査に通過すると、自動的に有効化されます。メッセージテンプレートが有効化されると、API を呼び出してテンプレートメッセージを送信できます。詳細については、テンプレートを使用した業務通知メッセージの送信を参照してください。

​
テンプレートの無効化

テンプレートが不要になった場合は、有効化トグルをオフにしてテンプレートの使用を停止します。

​
テンプレートの削除

削除をクリックしてテンプレートを削除します。

​
テンプレートの複製

複製をクリックすると、同じ設定のテンプレートをコピーできます。

​
テンプレートのテスト

編集をクリックすると、テンプレート編集画面に入ります。テンプレート編集ページのテストボタンをクリックすると、テストを実行できます。テストでは、業務通知を自分自身に送信します。