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

# 概要

> 複数のボットタイプと対応シーンを確認しメッセージ送受信などのAPIを活用してチームコラボレーションを加速します

DingTalk では、さまざまなシーンに応じて利用できる複数のボットを提供しています。本記事では、各タイプのボットの利用シーンについて説明します。

## ボットとは

ボットは独立したアプリ機能として、DingTalk において重要な役割を担っています。簡単な設定を行うだけで、個別チャットやグループチャットのシーンでメッセージ通知を送信したり、ユーザーとのインタラクティブなサービスを提供したりできます。ボットを活用することで、業務情報やタスクを DingTalk のチャット環境に効果的に組み込み、ワークフローやチームコラボレーションを加速できます。

### ボットのタイプ

| **タイプ**            | **グループチャット対応**      | **個別チャット対応** | **作成方法**                                                              |
| ------------------ | ------------------- | ------------ | --------------------------------------------------------------------- |
| 社内ボット              | ✅（内部グループ）           | ✅            | [社内ボットの設定](/ja/open/dingstart/configure-the-robot-application)        |
| サードパーティ社内アプリ - ボット | ✅（内部グループ）           | ✅            | サードパーティ社内ボット                                                          |
| カスタムボット            | ✅（外部グループ ＆＆ 内部グループ） | ❌            | [カスタムボットの作成](/ja/open/dingstart/custom-bot-creation-and-installation) |
| グループテンプレートボット      | ✅（内部グループ）           | ❌            | グループテンプレートボットの作成                                                      |

詳細は [ボットアプリ開発 - 概要](/ja/open/dingstart/robot-application-overview) をご参照ください。

### ボット ID

| **ボットのタイプ**         | **一意識別フィールド** | **確認パス**  |
| ------------------- | ------------- | --------- |
| 社内 / サードパーティアプリのボット | robotCode     | image.png |
| グループテンプレートボット       | ID            | image.png |
| カスタムボット             | なし            | なし        |

## オープン機能の概要

ボットは豊富な API インターフェースを提供しています。開発者は API を通じて、ボットによるメッセージの送受信を実現できます。

### オープン API リスト

#### DING メッセージ

| **API**              | **API 説明**                                                       | **対応タイプ** | **API バージョン** |
| -------------------- | ---------------------------------------------------------------- | --------- | ------------- |
| DING メッセージの送信        | 社内ボットを使用して DING メッセージを送信します。アプリ内 DING、SMS DING、電話 DING の送信が可能です。 | 社内アプリのボット | 新バージョン        |
| 送信済み DING メッセージの送信取消 |                                                                  | 社内アプリのボット | 新バージョン        |

#### 通常メッセージ

| **API**                                                                                                                   | API 説明                                        | **対応タイプ**        | **API バージョン** |
| ------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------- | ---------------- | ------------- |
| [人とボットのチャットにおけるボットメッセージの一括送信](/ja/open/development/chatbots-send-one-on-one-chat-messages-in-batches)                     | 人とボットのチャット（人とボットの個別チャット）におけるボットメッセージを一括送信します。 | サードパーティ社内アプリのボット | 新バージョン        |
| [人と人のチャットにおけるボットによる通常メッセージの送信](/ja/open/development/the-robot-sends-ordinary-messages-in-a-person-to-person-conversation) | 人と人のチャットにおいて、ボットが通常メッセージを送信します。               | サードパーティ社内アプリのボット | 新バージョン        |
| [ボットによるグループチャットメッセージの送信](/ja/open/development/the-robot-sends-a-group-message)                                            | アプリのボットがグループチャットメッセージを送信します。                  | 社内アプリのボット        | 新バージョン        |
| [カスタムボットによるグループメッセージの送信](/ja/open/development/custom-robots-send-group-messages)                                          | カスタムボットを使用してグループメッセージを送信します。                  | カスタムボット          | 新バージョン        |

#### メッセージ受信

| **API**                                                                                                         | API 説明                             | **対応タイプ**        | **API バージョン** |
| --------------------------------------------------------------------------------------------------------------- | ---------------------------------- | ---------------- | ------------- |
| [ボットが受信したメッセージのファイルコンテンツのダウンロード](/ja/open/development/download-the-file-content-of-the-robot-receiving-message) | ボットが受信したメッセージのファイルコンテンツをダウンロードします。 | サードパーティ社内アプリのボット | 新バージョン        |

#### メッセージ照会

| **API**                                                                                                                       | API 説明                                  | **対応タイプ**        | **API バージョン** |
| ----------------------------------------------------------------------------------------------------------------------------- | --------------------------------------- | ---------------- | ------------- |
| [人とボットのチャットにおけるボットメッセージの既読状態の一括照会](/ja/open/development/chatbot-batch-query-the-read-status-of-messages)                      | 人とボットのチャットにおいて、ボットメッセージが既読かどうかを一括照会します。 | サードパーティ社内アプリのボット | 新バージョン        |
| [人と人のチャットにおけるボットメッセージの既読リストの照会](/ja/open/development/query-the-read-list-of-robot-messages-in-person-to-person-conversations) | 人と人のチャットにおけるボットメッセージの既読リストを照会します。       | サードパーティ社内アプリのボット | 新バージョン        |
| [社内ボットのグループチャットメッセージにおけるユーザー既読状態の照会](/ja/open/development/chatbot-queries-the-read-status-of-a-message)                       | 社内ボットのグループチャットメッセージにおけるユーザーの既読状態を照会します。 | サードパーティ社内アプリのボット | 新バージョン        |

#### メッセージ送信取消

| **API**                                                                                                                              | API 説明                             | **対応タイプ**        | **API バージョン** |
| ------------------------------------------------------------------------------------------------------------------------------------ | ---------------------------------- | ---------------- | ------------- |
| [人とボットのチャットにおけるボットメッセージの一括送信取消](/ja/open/development/batch-message-recall-chat)                                                      | 人とボットのチャットにおけるボットメッセージを一括で送信取消します。 | サードパーティ社内アプリのボット | 新バージョン        |
| [人と人のチャットにおけるボットメッセージの一括送信取消](/ja/open/development/batch-withdrawal-of-single-chat-robot-messages-in-person-to-person-conversations) | 人と人のチャットにおけるボットメッセージを一括で送信取消します。   | サードパーティ社内アプリのボット | 新バージョン        |
| [社内ボットによる内部グループメッセージの送信取消](/ja/open/development/enterprise-chatbot-withdraws-internal-group-messages)                                | 社内ボットが内部グループメッセージを送信取消します。         | 社内アプリのボット        | 新バージョン        |

#### ボット管理

| **API**                                                                        | API 説明              | **対応タイプ** | **API バージョン** |
| ------------------------------------------------------------------------------ | ------------------- | --------- | ------------- |
| [グループ内のボットリストの取得](/ja/open/development/obtain-the-list-of-robots-in-the-group) | グループ内のボットリストを取得します。 | 社内アプリのボット | 新バージョン        |

#### クイックエントリ管理

| **API**                                                                                     | API 説明                       | **対応タイプ** | **API バージョン** |
| ------------------------------------------------------------------------------------------- | ---------------------------- | --------- | ------------- |
| [シングルチャットボットのクイックエントリの設定](/ja/open/development/set-robot-quick-entrance)                    | シングルチャットボットのクイックエントリを設定します。  | 社内アプリのボット | 新バージョン        |
| [シングルチャットボットのクイックエントリの照会](/ja/open/development/quick-entrance-of-inquiry-single-chat-robot) | シングルチャットボットのクイックエントリを照会します。  | 社内アプリのボット | 新バージョン        |
| [シングルチャットボットのクイックエントリのクリア](/ja/open/development/clear-single-chat-robot-quick-entry)        | シングルチャットボットのクイックエントリをクリアします。 | 社内アプリのボット | 新バージョン        |

### コールバックイベントリスト

ボットは、メッセージ送信取消およびメッセージ既読のコールバックイベントに対応しています。

* ボットメッセージ送信取消イベント
* ボットメッセージ既読イベント

## 利用ガイド

### 社内ボット

* 社内ボットを作成する場合は、[社内ボットの設定](/ja/open/dingstart/configure-the-robot-application) をご参照ください。
* DingTalk では、当該ボットによる個別チャットおよびグループチャットメッセージの送信に関するチュートリアルとサンプルコードを提供しています。下記リンクから関連情報をご確認ください。

  * グループチャットメッセージの送信: [社内ボットによるグループチャットメッセージの送信](/ja/open/development/the-application-robot-in-the-enterprise-sends-group-chat-messages)
  * 個別チャットメッセージの送信: [社内ボットによる個別チャットメッセージの送信](/ja/open/development/the-application-robot-in-the-enterprise-sends-a-single-chat)

### サードパーティ社内ボット

サードパーティ社内ボットを作成する場合は、サードパーティ社内ボットの紹介をご参照ください。

### カスタムボット

* カスタムボットを作成する場合は、[カスタムボットの作成](/ja/open/dingstart/custom-bot-creation-and-installation) をご参照ください。
* DingTalk では、当該ボットによるグループチャットメッセージの送信に関するチュートリアルとサンプルコードを提供しています。[カスタムボットによるグループチャットメッセージの送信](/ja/open/development/custom-bot-to-send-group-chat-messages) ドキュメントをご参照ください。

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

グループチャットを作成すると同時にボットをグループに追加する必要がある場合は、グループテンプレートボットの作成に関する紹介をご参照ください。

<Warning>
  DingTalk では、当該ボットによるグループチャットメッセージの送信に関するチュートリアルとサンプルコードを提供しています。[グループテンプレートボットによるグループチャットメッセージの送信](/ja/open/development/group-template-robot-sends-group-chat-message) ドキュメントをご参照ください。
</Warning>

### サードパーティツールボット

メッセージ送信機能のみが必要で、GitLab、GitHub、JIRA、Alibaba Cloud Codeup、Travis から DingTalk グループへのメッセージプッシュに限定される場合は、Webhook ボットの紹介をご参照ください。
