> ## 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 がビジネスニーズに応じて多様なオープン方式を通じてグループおよびグループメンバーを作成、設定、管理する機能です。また、具体的なビジネスシーンに基づくグループ内サービスをユーザーに提供し、コミュニケーションとコラボレーションを融合させます。組織メンバーがグループチャット内で豊富なグループ機能を活用し、効率的・構造化・明確なコラボレーションとコミュニケーションを実現することで、コラボレーション業務の効率向上を支援します。

## バージョン説明

| **機能説明**                                               | **グループ管理** | **シーングループ** |
| ------------------------------------------------------ | ---------- | ----------- |
| グループチャットとメンバーの基本管理                                     | ✅          | ✅           |
| グループチャット内のプレミアム機能の事前設定（グループピン留め、グループショートカット、グループボットなど） | ❌          | ✅           |
| グループテンプレートに基づく API によるグループチャットの一括管理                    | ❌          | ✅           |
| グループテンプレートによる組織内のグループタイプとその機能のカスタマイズ                   | ❌          | ✅           |

## オープン概要

### オープンインターフェース一覧

チャット管理は豊富なインターフェースのオープン機能を提供しており、開発者は API インターフェースを通じてグループと企業のビジネスシステムを連携できます。

#### グループ管理

| **API**                                                                                  | **API 説明**                                             | **API バージョン** |
| ---------------------------------------------------------------------------------------- | ------------------------------------------------------ | ------------- |
| [グループチャットを作成](/ja/open/development/create-common-group-new-version-v2)                   | 内部グループおよび一般グループのチャットを作成します。                            | 新バージョン        |
| [グループチャットを更新](/ja/open/development/api-updategroup)                                      | グループ chatid を通じて指定したグループチャットの基本情報およびメンバーを更新します。        | 新バージョン        |
| [グループ情報を照会](/ja/open/development/obtain-a-group-session)                                 | グループ設定およびメンバー情報を取得します。                                 | 旧バージョン        |
| [グループメンバーのグループ内名前を更新](/ja/open/development/set-a-group-nickname)                         | グループメンバーのグループ内での名前を更新します。                              | 旧バージョン        |
| [企業グループ管理者を一括設定](/ja/open/development/batch-setup-group-administrator)                   | 企業グループ内のユーザーを管理者として一括設定、または企業グループ内のユーザーの管理者権限を一括解除します。 | 新バージョン        |
| [メンバー間の個別チャットを禁止を設定](/ja/open/development/set-private-chat)                              | グループメンバー間で連絡先を追加および個別チャットができるかを設定します。                  | 旧バージョン        |
| [グループ参加 QR コードリンクを取得](/ja/open/development/obtain-a-qr-code-link)                        | グループ参加 QR コード招待リンクを取得します。                              | 旧バージョン        |
| [グループチャットの OpenConversationId を取得](/ja/open/development/obtain-group-openconversationid) | chatId を通じて OpenConversationId を照会します。                 | 新バージョン        |

##### グループ管理

| **API**                | **API 説明**                                                            | **API バージョン** |
| ---------------------- | --------------------------------------------------------------------- | ------------- |
| シーングループを作成             | グループテンプレート ID に基づいてグループを作成します。                                        | 新バージョン        |
| シーングループを更新             | グループ ID に基づいてグループ情報を更新します。                                            | 新バージョン        |
| グループメンバーを追加            | グループ内に新規メンバーを追加します（グループメンバー数の上限は 1000 名）。                             | 新バージョン        |
| グループメンバーを削除            | グループ ID とグループメンバー ID に基づいてグループメンバーを削除します。                             | 新バージョン        |
| グループ情報を照会              | グループ ID に基づいてグループ名、グループアイコン、グループ作成者 id、グループ参加リンク、グループ設定項目などの情報を取得します。 | 旧バージョン        |
| グループメンバーの発言禁止状態を設定     | シーングループ内のグループメンバーの発言禁止状態を設定します。                                       | 新バージョン        |
| グループ発言禁止状態を照会          | グループおよびグループ内メンバーの発言禁止状態を照会します。                                        | 新バージョン        |
| グループメンバーのグループ内名前を更新    | グループ ID とグループメンバー ID に基づいて、グループメンバーのグループ内名前を更新します。                    | 新バージョン        |
| グループ管理者を更新             | グループのグループ管理者を更新します。                                                   | 新バージョン        |
| グループ簡易情報を照会            | グループ ID に基づいてグループ名、グループアイコン、グループ作成者 id などの基本情報を照会します。                 | 新バージョン        |
| グループメンバーを照会            | グループメンバー情報を照会します。                                                     | 新バージョン        |
| グループチャットを解散            | グループ ID に基づいて指定したグループを解散します。                                          | 新バージョン        |
| グループ内のグループテンプレートボットを照会 | グループ内のグループテンプレートボットの情報を照会します。                                         | 新バージョン        |

##### グループテンプレート

| **API**          | **API 説明**                              | **API バージョン** |
| ---------------- | --------------------------------------- | ------------- |
| グループテンプレートを有効化完了 | グループテンプレート ID に基づいてグループテンプレートを有効化完了します。 | 旧バージョン        |
| グループテンプレートを停止    | グループテンプレート ID に基づいてグループテンプレートを停止します。    | 旧バージョン        |

##### グループピン留め

| **API**                  | **API 説明**                          | **API バージョン** |
| ------------------------ | ----------------------------------- | ------------- |
| インタラクションカードのピン留めを作成およびオン | チャット内のインタラクションカードのピン留めを作成およびオンにします。 | 新バージョン        |
| インタラクションカードのピン留めを閉じる     | チャット内のインタラクションカードのピン留めを閉じます。        | 新バージョン        |

##### グループアシスタント

| **API**            | **API 説明**                              | **API バージョン** |
| ------------------ | --------------------------------------- | ------------- |
| グループアシスタントメッセージを送信 | グループテンプレートで定義したボットを通じてグループ内にチャットを送信します。 | 旧バージョン        |

### コールバックイベント一覧

チャット管理では、グループ解散、グループへのメンバー追加、メンバー削除、グループ作成者の変更などのコールバックイベントをサポートしています。その他のイベントについてはイベントサブスクリプション総覧をご参照ください。

## 利用ガイド

DingTalk はチャット管理インターフェースの統合フローのサンプルを提供しています。

* グループチャットを作成（シーングループ）
* [ショートカットを作成（グループプラグイン）](/ja/open/development/create-a-group-plug-in)
* [グループアシスタントでチャットを送信](/ja/open/development/group-assistant-sends-a-message)
* [グループチャットの作成、照会、変更および管理](/ja/open/development/group-session-operation-process)
* [ピン留めカードの純プルモードを実現](/ja/open/development/pure-pull-mode-process-guide)

## 用語解説

### チャット

DingTalk がオープンするチャットタイプは、主に**人と人の個別チャット**、**グループチャット**の 2 種類があります。

### グループメンバー

グループチャットにおけるすべての構成メンバーを指します。

### グループ管理者ロール

グループチャット内で異なるグループ管理権限を持つロールのタイプを指し、**グループ作成者、グループ管理者、グループ一般メンバー**を含みます。これらの持つグループ管理権限スコープは、グループ作成者 > グループ管理者 > グループ一般メンバーの順となります。

### グループロール

グループメンバーがグループ内でグループ作成者またはグループ管理者によって付与されるロールを指します。例えば「プロダクトマネージャー」「HR」などです。

### グループテンプレート

グループテンプレートを事前設定し、それを使用してグループチャットを作成、または一般の内部グループをグループテンプレートを適用したグループに変換することで、グループ設定項目、グループ内ボット、グループ内ショートカットなどの多様な機能を一度にグループ内へインストールできます。また、グループテンプレートを通じてグループチャットの一括管理も実現できます。同時に、グループテンプレートは可視範囲の設定をサポートし、「+」ボタンからのグループ作成入口に表示されるため、組織内のユーザーは DingTalk アプリ内でカスタムタイプのグループチャットをワンクリックで直接作成できます。

### ピン留め

グループチャットでは API を通じて指定した内容を指定グループのピン留め欄に表示でき、通知やお知らせなどの情報を表示することで情報のリーチ率を向上させます。

### ショートカット

旧称：グループプラグイン。グループ内のショートカットバーから常用アプリを素早く開くことができ、ワークベンチやアプリ広場へリダイレクト先する必要がなく、グループ内でビジネスを効率的に進められます。

グループチャットではグループテンプレートおよびクールアプリを通じて、指定グループのショートカット（具体的な入口リンク、順序など）をカスタマイズできます。シングルチャットボットのチャット内のショートカットも、API を通じて組織単位で設定できます。

ショートカットの作成方法については、[ショートカットを作成（グループプラグイン）](/ja/open/development/create-a-group-plug-in)をご参照ください。

### chatId

chatId は**グループチャット**を一意に識別するために使用され、グループ作成インターフェースの戻り値から取得します。

<Warning>
  今後のバージョンでは **chatid** は使用されなくなります。**openConversationId** をグループチャットの一意の識別子としてご使用ください。
</Warning>

### openConversationId

openConversationId は**グループチャット**を一意に識別するために使用され、グループ作成インターフェースの戻り値から取得します。
