> ## Documentation Index
> Fetch the complete documentation index at: https://help.dingtalk.io/llms.txt
> Use this file to discover all available pages before exploring further.

# フォームメッセージ通知

> DingTalk YiDAのフォームメッセージ通知機能をエディション別に解説。定時通知、DingTalkタスク、サードパーティサービス連携など、Freeプラン・ベーシック版・プロフェッショナル版・専用版で利用可能な機能と設定手順を紹介します。

| **機能**                  | **Freeプラン** | **ベーシック版** | **プロフェッショナル版** | **専用版** |
| ----------------------- | ----------- | ---------- | -------------- | ------- |
| 定時メッセージ通知               | 非対応         | 対応         | 対応             | 対応      |
| DingTalkタスクメッセージ        | 非対応         | 対応         | 対応             | 対応      |
| サードパーティサービス経由のメッセージ通知送信 | 非対応         | 対応         | 対応             | 対応      |

## 1. はじめに

### 1.1 機能概要

<Note>
  適用範囲：**通常フォーム**および**ワークフローフォーム**の**ページレベルのメッセージ通知**に適用されます（簡易化された新しいワークフローデザイナーに対応、旧版の高度なワークフローデザイナーには非対応）。**プラットフォームレベルのメッセージ通知**および**統合と自動化 / ワークフローデザイナー**内のメッセージ通知ノードは、以下の機能にまだ対応していません。
</Note>

機能アップグレードの比較詳細については、**リリースノート**をご参照ください。

**通知とテンプレートの作成**

7種類のクイックメッセージ通知テンプレートが利用可能です。**このテンプレートを使用**をクリックすると、ワンクリックで有効化できます。

**カードテンプレート概要：**

**注意：メッセージ内の画像は2 MBを超えてはならず、サイズの制限はありません。**

<table>
  <tr>
    <td>業務通知</td>
    <td>**プレーンテキストメッセージ**<br />操作が不要な通知のみを目的としたプレーンメッセージに適しています。</td>
    <td>DingTalkタスクを送信するには、詳細設定をオンにしてください。<br />通常フォーム<br />ワークフローフォーム</td>
  </tr>

  <tr>
    <td rowSpan={4}>グループチャット / 個別チャット</td>
    <td>**画像テキスト詳細カード**<br />フォームフィールドの画像テキストカード表示に適しており、メッセージ詳細を表示するリンクが付きます。</td>
    <td rowSpan={3}>**グループチャットに送信する場合、グループは全員グループまたは内部グループである必要があります。**</td>
  </tr>

  <tr>
    <td>**画像テキストカード**<br />操作が不要な画像テキストカードメッセージに適しています。</td>
  </tr>

  <tr>
    <td>**プレーンテキスト詳細カード**<br />フォームフィールドのテキストカード表示に適しており、メッセージ詳細を表示するリンクが付きます。</td>
  </tr>

  <tr>
    <td>**画像テキストコメントカード**<br />フォームのプレーンテキストカード表示に適しており、フォーム詳細へのコメントに対応します。</td>
    <td>**コメント**をクリックすると、現在のフォーム詳細ページのコメントエリアに直接遷移します。送信されたコメントはデータベースに保存されます。</td>
  </tr>

  <tr>
    <td rowSpan={2}>グループピン留め</td>
    <td>**画像テキストピン留めカード**<br />操作が不要な画像テキストピン留めカードメッセージに適しています。</td>
    <td rowSpan={2}>グループ内でピン留めされた場合、**ピン留めは1日間有効です**。</td>
  </tr>

  <tr>
    <td>**プレーンテキストピン留め詳細カード**<br />フォームのプレーンテキストピン留めカードメッセージに適しており、メッセージ詳細を表示するリンクが付きます。</td>
  </tr>
</table>

**受信者タイプ**

ユーザー、ロール、フィールドの3つのオプションを1つのエントリポイントに統合しました。「参加者による通知」はシステムフィールドに変更されました。

### 1.2 使用シーン

**メッセージ通知**は、フォームの送信または編集時、作業フローの開始または終了時、あるいは他のフローノードでアクションが実行された後に、指定されたユーザーやグループチャットに送信される通知です。

**注意**：

* フォームメッセージ通知はプレーンメッセージ（つまりDingTalk業務通知）のみ送信できます。DingTalkタスクは送信できません。

## 2. 操作ガイド

以下の例では、フォーム送信後にグループ通知を送信する方法を示し、新しい**メッセージ通知**機能を体験できます。

### 2.1 ステップ1：メッセージ通知を作成

**パス**：ターゲットフォーム / ワークフローフォームをクリック >> **設定** >> **ページ設定** >> **メッセージ通知**をクリックし、メッセージ通知設定ページを開きます。

メッセージ通知を作成します。

### 2.2 ステップ2：メッセージテンプレートを選択

**手順：**

1. **画像テキスト詳細カード**テンプレートを選択 >> **このテンプレートを使用**（図2.2-1を参照）

図2.2-1 メッセージテンプレートの選択

2. メッセージ通知テンプレートを設定します。（図2.2-2を参照）

図2.2-2 メッセージ通知テンプレートの設定

### 2.3 設定ガイド

新しいメッセージ通知機能を実際に体験したところで、各オプションを詳しく見ていきましょう。

#### 2.3.1 トリガー条件

5つのトリガー条件が利用可能です：

* 作成時：フォームまたはワークフローフォームのエントリが正常に送信されたときにメッセージ通知を送信します。
* 編集時：送信済みフォームエントリが正常に編集されたときにメッセージ通知を送信します。
* 削除時：送信済みフォームエントリが正常に削除されたときにメッセージ通知を送信します。
* コメント時：送信済みフォームエントリに正常にコメントされたときにメッセージ通知を送信します。
* フォームの日付フィルターによる送信：フォーム内の日付コンポーネントの値に基づいてメッセージ通知を送信します。

トリガー条件。

#### 2.3.2 受信者

受信者タイプは以下のとおりです：

ユーザー / ロール / フィールド：組織内のユーザーまたはロール、あるいはフォームのメンバーコンポーネントで選択されたユーザーを指定します（ロールはYiDAロールのみ対応）。

サードパーティサービス経由：プラットフォーム管理 > サービスレジストリで設定したサードパーティサービスを選択します。

現在のグループ：現在のアプリが有効化されているグループチャット。

**注意**：

* 受信者は上記で設定したすべてのユーザーの和集合です。同一人物が複数の条件に該当する場合でも、通知は1回のみ受信します。
* 1つのメッセージは最大100名の受信者に送信できます。

受信者タイプ。

#### 2.3.3 コンテンツ設定

コンテンツ設定とは、通知のメッセージタイトルとメッセージ本文を指します。2つのオプションがあります：

**カスタム**：メッセージタイトルと本文の固定値を手動で入力するか、フォームからフィールドを選択できます。

カスタム通知コンテンツ。

**通知テンプレートを使用**：テンプレート管理ページで事前に作成した通知テンプレートを選択します。テンプレートがない場合は、**テンプレート管理**をクリックして作成してください。詳細は[メッセージ通知](/ja/yida/platform-admin/fkfhud)をご参照ください。

通知テンプレートの使用。

#### 2.3.4 定時メッセージ

定時メッセージは主にカスタムの繰り返し定時リマインダーに使用されます。間隔は最短1日から最長1年まで設定できます。

**一般的な使用シーン：社員の勤続記念日リマインダー、会議予約リマインダー、社員食堂の食事リマインダー。**

フォームの日付フィルターに基づいて設定します。

**注意**：送信ルールの設定が必要なのは、トリガー条件が**フォームの日付フィルターによる送信**の場合のみです。その他のトリガー条件では不要です。

日付リマインダールールを設定します。

定時リマインダールールをカスタマイズでき、繰り返しリマインダーまたは1回限りのリマインダーとして設定できます。

<Note>
  現在、メインフォーム内の日付コンポーネントフィールドのみメッセージ通知のトリガー条件として対応しています。サブフォームおよび関連フォーム内の日付コンポーネントフィールドはまだ対応していません。
</Note>

**例：**

① 現在時刻が午前10:00で、リマインダー開始時刻が同日の午前9:00の場合、リマインダーを1回のみ発火するように設定すると、現在時刻がすでにリマインダー時刻を過ぎているため、リマインダーはトリガーされません。

② 現在時刻が2021年4月20日午前10:00で、リマインダー時刻が同日午前9:00の場合、リマインダーを毎日発火するように設定すると、現在時刻がすでにリマインダー時刻を過ぎているため、次回のリマインダーは2021年4月21日午前9:00にトリガーされます。（リマインダー時刻が終了時刻より前の場合に限ります。）リマインダー終了時刻が2021年4月20日の場合、2021年4月21日午前9:00にリマインダーはトリガーされません。

**繰り返しタイプ**

| **繰り返しタイプ**                       | **リマインダー開始時刻**  | **リマインダー終了時刻**   | **説明**                                                                                     |
| --------------------------------- | --------------- | ---------------- | ------------------------------------------------------------------------------------------ |
| 1回限りのリマインダー                       | 2021/4/20 15:00 | ——               | 2021年4月20日15:00に1回リマインダーをプッシュします。                                                          |
| 毎日リマインダー                          | 2021/4/20 15:00 | 2021/4/21 23:59  | 2021年4月20日15:00にリマインダーをプッシュし、その後は毎日プッシュします（次回は2021年4月21日15:00、以降同様）、2021-4-21 23:59:59まで。  |
| 毎週リマインダー                          | 2021/4/20 15:00 | 2021/4/30 23:59  | 2021年4月20日15:00にリマインダーをプッシュし、その後は毎週プッシュします（次回は2021年4月27日15:00、以降同様）、2021-4-30 23:59:59まで。  |
| 2週ごとリマインダー                        | 2021/4/20 15:00 | 2021/5/5 23:59   | 2021年4月20日15:00にリマインダーをプッシュし、その後は2週ごとにプッシュします（次回は2021年5月4日15:00、以降同様）、2021-5-5 23:59:59まで。 |
| 毎月リマインダー                          | 2021/4/20 15:00 | 2021/6/20 23:59  | 2021年4月20日15:00にリマインダーをプッシュし、その後は毎月プッシュします（次回は2021年5月20日15:00、以降同様）、2021-6-20 23:59:59まで。  |
| 毎年リマインダー                          | 2021/4/20 15:00 | 2022/4/20 23:59  | 2021年4月20日15:00にリマインダーをプッシュし、その後は毎年プッシュします（次回は2022年4月20日15:00、以降同様）、2022-4-20 23:59:59まで。  |
| カスタム繰り返し -<br />週単位（N週ごとに指定した曜日）  | 2021/4/20 15:00 | 2021/12/31 23:59 | カスタム繰り返しリマインダーの設定時に、1つまたは複数の曜日を指定できます。例：月曜日から金曜日の平日のみリマインダーを設定し、週末は送信しません。                 |
| カスタム繰り返し -<br />月単位（Nか月ごとに指定した日付） | <br />          | 2021/12/31 23:59 | 月内の1つまたは複数の特定日付を選択してリマインダーをトリガーします。（例：毎月31日にリマインダーを設定した場合、31日がない月にはリマインダーは送信されません。）        |

#### 2.3.5 通知の有効性

（1）ルールは設定後直ちに有効になり、過去のフォームデータにも適用されます（直近50,000件のレコードに限定）。

（2）メッセージ通知で使用している日付コンポーネントがフォームまたはワークフローフォームから削除された場合でも、事前に設定されたメッセージ通知タスクは有効なままです。メッセージのプッシュを停止するには、対応するメッセージ通知設定を削除してください。

### 2.4 結果デモ

図2.3-1 メッセージ通知結果デモ。

### 2.5 注意事項

DingTalkはメッセージ通知に対して、以下のような追加の制限を設けています：

1. DingTalkは同一のコンテンツとタイトルを持つメッセージをフィルタリングします。各ユーザーは1日に1回のみ重複したメッセージ通知を受信します。

**解決策**：メッセージ通知テンプレートに、通知ごとに変化するフォームフィールドコンテンツを含めてください。参照構文は`$!{form field unique identifier}`です。

1. DingTalkは各ユーザーが1日に受信できる業務通知の数を制限しています。YiDAでは、上限は1ユーザーあたり1日2,000メッセージです。詳細は**DingTalkメッセージ制限**をご参照ください。
2. 定時リマインダーが設定されていても、フォーム送信時に終了日が入力されていない場合、メッセージ通知はトリガーされません。
3. カードメッセージをグループチャットまたはグループピン留めにプッシュする場合、以下の3点にご注意ください：

* YiDAアシスタントボットは、1つのグループにつき1分間に最大20メッセージを送信できます。
* グループ内でピン留めされた場合、ピン留めは1日間有効です。
* ワークフローフォームのカードメッセージをグループ（グループチャットまたはグループピン留め）に送信する際、同時にDingTalkタスクを送信することはできません。

## 3. FAQ

<AccordionGroup>
  <Accordion id="q1" title="3.1 現在のグループにメッセージをプッシュするにはどうすればよいですか？">
    （1）YiDAが有効化されている全員グループ、部門グループ、または内部グループを開きます >> **その他** >> **YiDA**。

    （2）通知を送信したいアプリを選択し、有効化します。
  </Accordion>

  <Accordion id="q2" title="3.2 グループピン留め通知を設定したのに、ピン留めされて表示されないのはなぜですか？">
    グループ内のピン留めカードは1日間のみ表示されます。1日を過ぎるとピン留めは解除されます。
  </Accordion>

  <Accordion id="q3" title="3.3 クイックメッセージをアップグレードすると既存のメッセージ通知に影響しますか？">
    影響ありません。業務通知は自動的に業務通知に変換され、タスクは自動的にDingTalkタスクに変換されます。
  </Accordion>

  <Accordion id="q4" title="3.4 メッセージ長は50文字を超えてはいけないという警告が表示されるのはなぜですか？">
    メッセージタイトルは最大50文字まで対応しています。
  </Accordion>

  <Accordion id="q5" title="3.5 詳細設定が有効化されていて無効にできないと表示されるのはなぜですか？">
    一度**詳細設定**を有効化して**確認**をクリックして保存すると、無効にすることはできません。
  </Accordion>

  <Accordion id="q6" title="3.6 テンプレートカードを使用する際、通知をDingTalkタスクに設定するにはどうすればよいですか？">
    ワークフローフォームでDingTalkタスクに通知を送信する必要がある場合、テンプレートカードを使用する際に**詳細設定**を有効化し、**DingTalkタスク**を選択してください。

    **注意事項：**

    * 最初の業務通知テンプレートのみDingTalkタスクを送信するよう設定できます。
    * 一度**詳細設定**を有効化して**確認**をクリックして保存すると、無効にすることはできません。
  </Accordion>

  <Accordion id="q7" title="3.7 指定グループを選択する際、他組織のグループチャットを選択できないのはなぜですか？">
    グループメッセージは、同じ組織内の全員グループと内部グループにのみ送信できます。その他のグループタイプは非対応です。

    以下のスクリーンショットに示す位置でグループタイプを確認できます。
  </Accordion>

  <Accordion id="q8" title="3.8 グループアプリを削除するにはどうすればよいですか？">
    グループチャットをクリック >> **その他** >> グループメンバーが追加したプラグイン >> アプリ名の横のマイナスアイコン。

    注意：現在のグループにメッセージ通知を設定した場合、グループアプリを削除することでもメッセージのプッシュを停止できます。
  </Accordion>

  <Accordion id="q9" title="3.9 一括インポートしたデータでメッセージ通知をトリガーできますか？">
    可能です。インポート時に、検証ルール、関連ビジネスルール、およびサードパーティサービスコールバックを同時にトリガーするオプションを選択してください。

    **注意：これは有料機能です。**
  </Accordion>

  <Accordion id="q10" title="3.10 ワークフローフォームで設定したメッセージ通知およびタスクルールが有効にならないのはなぜですか？">
    ルールを設定した後、作業フローの新しいバージョンを公開しているかご確認ください。
  </Accordion>
</AccordionGroup>

### 3.11 フォームの日付に基づく定時メッセージルールがトリガー時刻に達したのに通知が送信されない

定時メッセージルールは、保存後は新規に送信または新規に編集されたデータにのみ適用されます。再編集されていない履歴データではルールはトリガーされません。