> ## 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.

# グループチャット

> YiDAでフォームとコネクタをDingTalkのグループチャット作成・更新機能と連携させる方法を解説。フォーム設計から統合と自動化によるコネクタ設定まで、グループチャット自動化の実装手順を詳しく紹介します。

YiDAでフォームを送信してDingTalkグループチャットを作成し、作成したチャットのグループ名とメンバーを更新します。

## 効果

グループチャットを作成する効果は以下のとおりです。

グループチャットを更新する効果は以下のとおりです。

## ステップ1：「グループチャット作成」フォームの構築と設定

グループチャットの作成に必要なグループ名、グループ作成者、グループメンバーを取得するフォームを作成します。

**手順：**

1. 通常フォームを作成し、「グループチャット作成」と名付けます。
2. 一行テキストコンポーネントを追加し、「グループチャット名」と名付け、必須項目として設定します。（図2.1-1を参照）

図2.1-1 一行テキストコンポーネントの追加と設定

3. メンバーコンポーネントを追加し、「グループ作成者を選択」と名付け、必須項目として設定します。（図2.1-2を参照）

図2.1-2 メンバーコンポーネントの追加と設定

4. もう一つメンバーコンポーネントを追加し、「グループメンバーを選択」と名付け、必須項目として設定し、複数選択モードを有効にします。（図2.1-3を参照）

図2.1-3 メンバーコンポーネントの追加と設定

5. ページ右上の保存をクリックします。

## ステップ2：「グループチャットデータ集計」フォームの構築と設定

「グループチャット作成」フォームで作成されたグループチャットの情報（グループ名とグループチャットID）を記録するフォームを作成します。グループチャットIDは、グループチャット作成コネクタから返されるデータから取得します。

**手順：**

1. 通常フォームを作成し、「グループチャットデータ集計」と名付けます。
2. 一行テキストコンポーネントを2つ追加し、それぞれ「グループチャット名」と「グループチャットID」と名付けます。（図2.1-4を参照）

図2.1-4 一行テキストコンポーネントの追加と設定

3. 右上の保存をクリックします。

## ステップ3：「グループチャット更新」フォームの構築と設定

コネクタで作成されたグループチャットを更新するために必要なデータを取得するフォームを作成します。

**手順：**

1. 通常フォームを作成し、「グループチャット更新」と名付けます。
2. ドロップダウン選択コンポーネントを追加し、「グループチャットを選択」と名付け、必須項目として設定します。選択肢は「グループチャットデータ集計」フォーム内の「グループチャット名」コンポーネントと関連付けるよう設定します。（図2.1-5を参照）

図2.1-5 ドロップダウン選択コンポーネントの追加と設定

3. 一行テキストコンポーネントを追加し、「グループチャットID」と名付けます。「グループチャットデータ集計」フォームとのデータ連動を設定し、「グループチャットを選択」コンポーネントの値が「グループチャット名」コンポーネントの値と等しい場合に、「グループチャットID」の値が「グループチャットID」コンポーネントの値と等しくなるようにします。（図2.1-6を参照）

図2.1-6 一行テキストコンポーネントの追加とデータ連動の設定

4. メンバーコンポーネントを2つ追加し、それぞれ「グループメンバーを追加」と「グループメンバーを削除」と名付け、複数選択モードを有効にします。（図2.1-7を参照）

図2.1-7 メンバーコンポーネントの追加と設定

5. 一行テキストコンポーネントを追加し、「更新後のグループチャット名」と名付けます。（図2.1-8を参照）

図2.1-8 一行テキストコンポーネントの追加と設定

6. ページ右上の保存をクリックします。

## ステップ4：「グループチャット作成」フォームへのコネクタの追加と設定

<Note>
  YiDAコネクタの概要については、[統合と自動化 - コネクタ](/ja/yida/integration/gqmveiswrxkgxu9s)を参照してください。
</Note>

コネクタを呼び出すために必要な基本フォームの準備が整いました。次に、「グループチャット作成」フォームと「グループチャット更新」フォームにコネクタを追加・設定し、ロジック層を準備します。

このコネクタは、「グループチャット作成」フォームが送信された際に、DingTalkグループチャットを自動的に作成します。

**手順：**

1. 管理ページ > 「グループチャット作成」 > 「統合と自動化」 > 「統合と自動化を作成」に移動します。（図2.2-1を参照）

図2.2-1 コネクタ設定エントリ

2. コネクタ名に「グループチャット作成」を入力し、トリガー種類を「フォームイベントトリガー」に設定し、確認をクリックします。（図2.2-2を参照）

図2.2-2 コネクタの作成

3. フォームトリガーイベントを設定します。トリガーイベントを「作成成功」に、データフィルターを「すべてのデータ」に設定し、保存をクリックします。（図2.2-3を参照）

図2.2-3 コネクタのフォームトリガーイベントの設定

4. コネクタアプリを選択します。アプリを「グループチャット」に設定し、次へをクリックします。（図2.2-4を参照）

図2.2-4 コネクタアプリの選択

5. アクションを選択します。アクションを「グループチャットを作成」に設定し、次へをクリックします。（図2.2-5を参照）

図2.2-5 コネクタアクションの選択

6. アクションを設定し、保存をクリックします。（図2.2-6を参照）

図2.2-6 コネクタアクションの設定

7. ページ右上の保存をクリックし、続いて公開をクリックします。
8. 「コネクタ」ノードの下に「データ作成」ノードを追加し、設定します。このノードは、グループチャットIDを「グループチャットデータ集計」フォームに返します。（図2.2-7を参照）

図2.2-7(1) データ作成ノードの追加

図2.2-7(2) データ作成ノードの設定

## ステップ5：「グループチャット更新」フォームへのコネクタの追加と設定

このコネクタは、「グループチャット更新」フォームが送信された際に、コネクタで作成されたDingTalkグループチャットを自動的に更新します。

**手順：**

1. 管理ページ > 「グループチャット作成」 > 「設定」 > 「ページ設定」 > 「統合と自動化」 > 「統合と自動化を作成」に移動します。（図2.2-8を参照）

図2.2-8 コネクタ設定エントリ

2. コネクタ名に「グループチャット作成」を入力し、トリガー種類を「フォームイベントトリガー」に設定し、確認をクリックします。（図2.2-9を参照）

図2.2-9 コネクタの作成

3. フォームトリガーイベントを設定します。トリガーイベントを「作成成功」に、データフィルターを「すべてのデータ」に設定し、保存をクリックします。（図2.2-10を参照）

図2.2-10 コネクタのフォームトリガーイベントの設定

4. コネクタアプリを選択します。アプリを「グループチャット」に設定し、次へをクリックします。（図2.2-11を参照）

図2.2-11 コネクタアプリの選択

5. アクションを選択します。アクションを「グループチャットを作成」に設定し、次へをクリックします。（図2.2-12を参照）

図2.2-12 コネクタアクションの選択

6. アクションを設定し、保存をクリックします。（図2.2-13を参照）

図2.2-13 コネクタアクションの設定

7. ページ右上の保存をクリックし、続いて公開をクリックします。

## ステップ6：「グループチャット作成」フォームを送信してグループチャット作成コネクタをトリガー

図2.3-1 グループチャット作成フォームの送信

## ステップ7：「グループチャット更新」フォームを送信してグループチャット更新コネクタをトリガー

図2.3-2 グループチャット更新フォームの送信

## FAQ

Q：コネクタで作成したグループチャットのグループIDを取得するには、どうすればよいですか？

A：グループチャット作成コネクタの後にデータ作成ノードを追加し、コネクタから返されたグループチャットIDを別のフォームに保持します。（下図を参照）
