> ## 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連携をわかりやすく紹介します。

DingTalkは、さまざまなシーンで利用できる複数種類のボットを提供しています。本記事では、各ボットタイプのユースケースを紹介します。

## ボットとは

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

## **ボットタイプ**

* #### **社内アプリボット**

社内アプリボットは、開発者が組織内で利用するボットを構築できる機能です。社内アプリボットの設定を行い、関連するAPIを呼び出すことで、DingTalkユーザーやDingTalkグループ内にボットメッセージを送信できます。詳しくは、社内アプリボットを作成するを参照してください。

* ### **カスタムボット**

Webhookを通じてカスタムサービスに接続し、カスタムボットを利用します。カスタムボットは内部グループや通常のDingTalkグループへのグループメッセージ送信をサポートしますが、個別チャットの送信はサポートしていません。詳しくは、[カスタムボットを作成する](https://help.dingtalk.io/zh/open/dingstart/custom-bot-creation-and-installation.md)を参照してください。

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

グループテンプレートボットは、シーンベースのグループにおけるもう一つのコアコンポーネントです。グループテンプレートボットは、アプリ内のコラボレーション情報をグループにプッシュできます。グループテンプレートを通じてインストールされたグループアシスタントは、グループへのメッセージプッシュや、グループユーザーからの @ メッセージへの応答が可能になります。これにより、開発者は高度に標準化された汎用ボット機能を構築し、グループ内のユーザーと対話できます。詳しくは、グループテンプレートボットを作成するを参照してください。

| **タイプ** | **グループチャット対応** | **個別チャット対応** | **作成方法** |
| - | - | - | - |
| 社内アプリボット | ✅（内部グループ） | ✅ | 社内アプリボットを作成する |
| カスタムボット | ✅（外部グループ && 内部グループ） | ❌ | [カスタムボットを作成する](https://help.dingtalk.io/zh/open/dingstart/custom-bot-creation-and-installation.md) |
| グループテンプレートボット | ✅（内部グループ） | ❌ | グループテンプレートボットを作成する |

## **基本概念**

#### **ボットID**

| **ボットタイプ** | **固定値識別フィールド** | **確認パス** |
| - | - | - |
| 社内アプリボット | robotCode | image.png |
| グループテンプレートボット | ID | image.png |
| カスタムボット | 利用不可 | 利用不可 |

## **OpenAPI**

* ### **グループチャット**

| | **API名** | **対応タイプ** |
| - | - | - |
| メッセージ送信 | [ボットがグループチャットメッセージを送信する](https://help.dingtalk.io/ja/open/development/the-robot-sends-a-group-message.md) | 社内アプリボット |
| [カスタムボットがグループメッセージを送信する](https://help.dingtalk.io/ja/open/development/custom-robots-send-group-messages.md) | カスタムボット | |
| グループアシスタント（グループテンプレートボット）メッセージを送信する | グループテンプレートボット | |
| メッセージ照会 | [ボットのグループチャットメッセージの既読状態を照会する](https://help.dingtalk.io/ja/open/development/chatbot-queries-the-read-status-of-a-message.md) | 社内アプリボット |
| メッセージ送信取消 | [社内ボットが内部グループメッセージを送信取消する](https://help.dingtalk.io/ja/open/development/enterprise-chatbot-withdraws-internal-group-messages.md) | 社内アプリボット |
| ボット管理 | [グループ内のボット一覧を取得する](https://help.dingtalk.io/ja/open/development/obtain-the-list-of-robots-in-the-group.md) | 社内アプリボット |

* ### **個別チャット**

| | **API名** | **対応タイプ** |
| - | - | - |
| メッセージ送信 | DINGメッセージを送信する | 社内アプリボット |
| [ユーザーとボットのチャットでボットメッセージを一括送信する](https://help.dingtalk.io/ja/open/development/chatbots-send-one-on-one-chat-messages-in-batches.md) | 社内アプリボット | |
| [ボットが個別チャットで通常メッセージを送信する](https://help.dingtalk.io/ja/open/development/the-robot-sends-ordinary-messages-in-a-person-to-person-conversation.md) | 社内アプリボット | |
| メッセージ照会 | [ユーザーとボットのチャットでボットメッセージが既読かどうかを一括照会する](https://help.dingtalk.io/ja/open/development/chatbot-batch-query-the-read-status-of-messages.md) | 社内アプリボット |
| [個別チャットでのボットメッセージの既読リストを照会する](https://help.dingtalk.io/ja/open/development/query-the-read-list-of-robot-messages-in-person-to-person-conversations.md) | 社内アプリボット | |
| メッセージ送信取消 | 送信済みのDINGメッセージを送信取消する | 社内アプリボット |
| [ユーザーとボットのチャットでボットメッセージを一括送信取消する](https://help.dingtalk.io/ja/open/development/batch-message-recall-chat.md) | 社内アプリボット | |
| [個別チャットでボットメッセージを一括送信取消する](https://help.dingtalk.io/ja/open/development/batch-withdrawal-of-single-chat-robot-messages-in-person-to-person-conversations.md) | 社内アプリボット | |
| クイックエントリ管理 | [シングルチャットボットのクイックエントリを設定する](https://help.dingtalk.io/ja/open/development/set-robot-quick-entrance.md) | 社内アプリボット |
| [シングルチャットボットのクイックエントリを照会する](https://help.dingtalk.io/ja/open/development/quick-entrance-of-inquiry-single-chat-robot.md) | 社内アプリボット | |
| [シングルチャットボットのクイックエントリをクリアする](https://help.dingtalk.io/ja/open/development/clear-single-chat-robot-quick-entry.md) | 社内アプリボット | |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.