チャット送受信タイプ

本文書では、ボットを通じて送信するチャットのタイプとデータ形式、およびボットが受信するチャットのデータ形式について詳しく説明します。

ボットによるチャット送信

チャットタイプ

ボットチャットの送信方法は 2 種類あり、API 経由でボットチャットを送信する方法と、Webhook 経由でボットチャットを送信する方法があります。それぞれ、サポートされるチャットタイプとデータ形式が異なります。

API 経由でのチャット送信を推奨します。

チャットタイプ	API 経由のボットチャット送信	Webhook 経由のボットチャット送信
Text テキストタイプ	✅	✅
Markdown タイプ	✅	✅
画像 Image タイプ	✅	❌
ActionCard タイプ	✅	✅
FeedCard タイプ	❌	✅
Link リンクチャット	✅	✅
Audio 音声タイプ	✅	❌
File ファイルタイプ	✅	❌
Video 動画タイプ	✅	❌

方法 1：API 経由

重要

ユーザーとボットの個別チャットにおけるボットチャット：画像・音声・ファイルの送受信に対応しています。
グループチャットにおけるボットチャット：画像・音声・動画・ファイルの送信に対応していますが、グループチャット内でユーザーがボットに対して音声・動画・ファイルを@メンションで送信することはできません。

対応 API

データ形式

チャットテンプレート Key：チャットテンプレート Key とは、開発者がチャットを送信する際に使用する一意の識別子です。プログラムコードを記述する際に、事前に設定したチャットテンプレートを素早く参照できます。
チャットテンプレートパラメータ：チャットテンプレート内で事前定義されたプレースホルダーを置き換える実データです。例えば、sampleText というチャットテンプレート Key を使用する場合、content フィールドの値を定義する必要があります。
例：社内アプリのボットがグループ内でテキストタイプを送信する HTTP のサンプルコードを提供します：
- チャットテンプレート Key： "msgKey" : "sampleText"
- チャットテンプレートパラメータ： "msgParam" : "{\"content\":\"DingTalk、進歩を起こす\"}"

詳細はボットによるグループチャットメッセージの送信を参照してください。

POST /v1.0/robot/groupMessages/send HTTP/1.1
Host:api.dingtalk.io
x-acs-dingtalk-access-token:<your access token>
Content-Type:application/json

{
  "msgParam" : "{\"content\":\"DingTalk、進歩を起こす\"}",
  "msgKey" : "sampleText",
  "openConversationId" : "cid6KeBBLov********",
  "robotCode" : "dingue4kfzdxbyn*******"
}

チャットタイプ	チャットテンプレート Key	チャットテンプレートパラメータ	説明
テキストタイプ	sampleText	`{ "content": "xxxx" }`
Markdown タイプ	sampleMarkdown	`{ "title": "xxxx", "text": "xxxx" }`
画像タイプ	sampleImageMsg	`{ "photoURL": "xxxx" }`	説明 photoURL には、画像の完全な URL パス、または画像の mediaId を指定できます。mediaId は、メディアファイルのアップロード API を呼び出して `media_id` パラメータの値として取得できます。
リンクタイプ	sampleLink	`{ "text": "メッセージ内容テスト", "title": "sampleLinkメッセージテスト", "picUrl": "@lADOADmaWMzazQKA", "messageUrl": "http://dingtalk.io" }`	リンクチャット。
ActionCard タイプ	sampleActionCard	`{ "title": "テストタイトル", "text": "内容テスト", "singleTitle": "詳細を見る", "singleURL": "https://open.dingtalk.com" }`	カードメッセージ：ボタン 1 つ。
sampleActionCard2	`{ "title": "メッセージタイトルテスト", "text": "メッセージ本文テスト", "actionTitle1": "ボタン1", "actionURL1": "https://www.taobao.com", "actionTitle2": "ボタン2", "actionURL2": "https://www.tmall.com" }`	カードメッセージ：縦並びのボタン 2 つ。
sampleActionCard3	`{ "title": "メッセージタイトルテスト", "text": "メッセージ内容テスト", "actionTitle1": "1つ目のボタンのテキスト", "actionURL1": "1つ目のボタンがトリガーするurl", "actionTitle2": "2つ目のボタンのテキスト", "actionURL2": "2つ目のボタンがトリガーするurl", "actionTitle3": "3つ目のボタンのテキスト", "actionURL3": "3つ目のボタンがトリガーするurl" }`	カードメッセージ：縦並びのボタン 3 つ。
sampleActionCard4	{ "title":"メッセージタイトルテスト", "text":"メッセージ内容テスト", "actionTitle1":"1つ目のボタンのテキスト", "actionURL1":"1つ目のボタンがトリガーするurl", "actionTitle2":"2つ目のボタンのテキスト", "actionURL2":"2つ目のボタンがトリガーするurl", "actionTitle3":"3つ目のボタンのテキスト", "actionURL3":"3つ目のボタンがトリガーするurl", "actionTitle4":"4つ目のボタンのテキスト", "actionURL4":"4つ目のボタンがトリガーするurl" }	カードメッセージ：縦並びのボタン 4 つ。
sampleActionCard5	{ "title":"メッセージタイトルテスト", "text":"メッセージ内容テスト", "actionTitle1":"1つ目のボタンのテキスト", "actionURL1":"1つ目のボタンがトリガーするurl", "actionTitle2":"2つ目のボタンのテキスト", "actionURL2":"2つ目のボタンがトリガーするurl", "actionTitle3":"3つ目のボタンのテキスト", "actionURL3":"3つ目のボタンがトリガーするurl", "actionTitle4":"4つ目のボタンのテキスト", "actionURL4":"4つ目のボタンがトリガーするurl", "actionTitle5":"5つ目のボタンのテキスト", "actionURL5":"5つ目のボタンがトリガーするurl" }	カードメッセージ：縦並びのボタン 5 つ。
sampleActionCard6	`{ "title": "xxxx", "text": "xxxx", "buttonTitle1":"xxxxx", "buttonUrl1":"xxxxx", "buttonTitle2":"xxxxx", "buttonUrl2":"xxxxx" }`	カードメッセージ：横並びのボタン 2 つ。
音声タイプ	sampleAudio	`{ "mediaId": "@IR_P********nFkfhsisbf4A", "duration":"xxxxx" }`	音声チャット： - mediaId：メディアファイルのアップロード API を呼び出して `media_id` パラメータの値として取得します。説明 ogg、amr 形式に対応しています。 - duration：音声チャットの長さ。単位はミリ秒。
ファイルタイプ	sampleFile	`{ "mediaId":"@lAz*********shRs5m2pRL", "fileName":"スプレッドシート.xlsx", "fileType":"xlsx" }`	ファイルメッセージ： - mediaId：メディアファイルのアップロード API を呼び出して `media_id` パラメータの値として取得します。 - fileName：ファイル名。 - fileType：ファイルタイプ。説明ファイルタイプは xlsx、pdf、zip、rar、doc、docx 形式に対応しています。
動画タイプ	sampleVideo	`{ "duration":"999", "videoMediaId":"$iQEL********AXNSs6QPPAAABhKN2L3EEzTcTB84BFM7iCAAJomlt", "videoType":"mp4", "picMediaId":"$igE********tAFzQUABtoAIYQBpAtR3SICqrQ7ZX0nEJzAKxUDzwAAAYSjdi2cBM02vwcACAAJomltCgQ" }`	動画メッセージ： - duration：音声チャットの長さ。単位は秒。 - videoMediaId：メディアファイルのアップロード API を呼び出して `media_id` パラメータの値として取得します。 - videoType：動画タイプ。mp4 形式に対応しています。 - picMediaId：動画のカバー画像。メディアファイルのアップロード API を呼び出して `media_id` パラメータの値として取得します。 - height：動画の表示の高さ。単位は px。 - width：動画の表示の幅。単位は px。

Markdown でサポートされる構文

チャットタイプ sampleMarkdown における Markdown 構文の補足説明です。

見出し
# 見出し1
## 見出し2
### 見出し3
#### 見出し4
##### 見出し5
###### 見出し6
 
参照
> A man who stands for nothing will fall for anything.
 
テキスト太字、斜体
**bold**
*italic*
 
リンク
[this is a link](http://name.com)
 
画像

 
箇条書き
- item1
- item2
 
番号付きリスト
1. item1
2. item2

改行
 \n （\nの前後にそれぞれ2つのスペースを追加することを推奨します）

方法 2：Webhook 経由

Webhook 方式はグループチャットでのみ対応しています。

Webhook によるチャット送信の実装方法については、ボットの返信/チャット送信およびカスタムボットの作成を参照してください。

テキスト text タイプ

{
    "at": {
        "atMobiles": [
            "180xxxxxx"
        ],
        "atUserIds": [
            "user123"
        ],
        "isAtAll": false
    },
    "text": {
        "content": "私は私、@180xxxxxx は唯一無二の存在です"
    },
    "msgtype": "text"
}

パラメータ	必須	タイプ	説明
msgtype	必須	String	text。
content	必須	String	チャットテキスト。
atMobiles	任意	Array	@メンション対象者の携帯電話番号。説明 content 内に@メンション対象者の携帯電話番号を追加します。グループ内のユーザーのみ@メンション可能で、グループ外のユーザーの携帯電話番号はマスキングされます。
atUserIds	任意	Array	@メンション対象者のユーザー ID。説明 content 内に@メンション対象者の userId を追加します。
isAtAll	任意	Boolean	@全員の場合は true、それ以外は false。

リンク Link タイプ

このタイプは@メンションには対応していません。

{
    "msgtype": "link", 
    "link": {
        "text": "まもなくリリースされるこの新バージョンを、創業者xxはマングローブと呼んでいます。これ以前、大型アップグレードのたびに、プロダクトマネージャーは時宜にかなったコードネームを付けてきました。今回、なぜマングローブなのでしょうか", 
        "title": "時代の列車は前へ進む", 
        "picUrl": "https://img.alicdn.com/tfs/TB1NwmBEL9TBuNjy1zbXXXpepXa-2400-1218.png", 
        "messageUrl": "https://open.dingtalk.com/document/"
    }
}

パラメータ	パラメータタイプ	必須	説明
msgtype	String	必須	チャットタイプ。ここでは link 固定です。
title	String	必須	チャットの見出し。
text	String	必須	チャットコンテンツ。長すぎる場合は一部のみ表示されます。
messageUrl	String	必須	チャットをクリックした際に遷移する URL。開き方は以下の通りです： - モバイル端末では DingTalk クライアント内で開きます - PC 端末 - デフォルトではサイドバーで開きます - 外部ブラウザで開きたい場合は、チャットリンクの説明を参照してください。
picUrl	String	任意	画像 URL。

Markdown タイプ

{
     "msgtype": "markdown",
     "markdown": {
         "title":"杭州の天気",
         "text": "#### 杭州の天気 @150XXXXXXXX \n> 9度、北西風1級、空気質89、相対湿度73%\n> \n> ###### 10時20分発表 [天気](https://www.dingalk.com) \n"
     },
      "at": {
          "atMobiles": [
              "150XXXXXXXX"
          ],
          "atUserIds": [
              "user123"
          ],
          "isAtAll": false
      }
 }

パラメータ	必須	タイプ	説明
msgtype	必須	String	チャットタイプ。ここでは markdown 固定です。
title	必須	String	チャット一覧の最初の画面に表示される内容。
text	必須	String	Markdown 形式のチャットコンテンツ。
atMobiles	任意	Array	@メンション対象者の携帯電話番号。説明 text コンテンツ内に@メンション対象者の携帯電話番号を含める必要があります。グループ内のユーザーのみ@メンション可能で、グループ外のユーザーの携帯電話番号はマスキングされます。
atUserIds	任意	Array	@メンション対象者のユーザー ID。説明 text 内に@メンション対象者の userId を追加します。
isAtAll	任意	Boolean	@全員の場合は true、それ以外は false。

現在は Markdown 構文のサブセットのみ対応しており、対応する要素は以下の通りです：

見出し
# 見出し1
## 見出し2
### 見出し3
#### 見出し4
##### 見出し5
###### 見出し6
 
参照
> A man who stands for nothing will fall for anything.
 
テキスト太字、斜体
**bold**
*italic*
 
リンク
[this is a link](https://www.dingtalk.io/)
 
画像

 
箇条書き
- item1
- item2
 
番号付きリスト
1. item1
2. item2

ActionCard タイプ

全体遷移 ActionCard タイプ

{
    "msgtype": "actionCard",
    "actionCard": {
        "title": "コーヒーショップを作る", 
        "text": " \n #### ジョブズが20年前に作りたかったAppleカフェ \n\n Apple Storeのデザインは、フルハイテク感から生活感へと向かっており、その生活化の流れは20年前のAppleのカフェ建設計画まで遡ることができます",
        "singleTitle" : "全文を読む",
        "btnOrientation": "0", 
        "singleURL" : "https://www.dingtalk.io/"
    }
}

パラメータ	必須	タイプ	説明
msgtype	必須	String	チャットタイプ。ここでは actionCard 固定です。
title	必須	String	チャット一覧の最初の画面に表示される内容。
text	必須	String	markdown 形式のチャット。説明 @ 機能を実装する場合は、text コンテンツ内に @ ユーザーの userId を追加してください。例：@manager7675
singleTitle	必須	String	単一ボタンの見出し。
singleURL	必須	String	チャットをクリックした際に遷移する URL。開き方は以下の通りです： - モバイル端末では DingTalk クライアント内で開きます - PC 端末 - デフォルトではサイドバーで開きます - 外部ブラウザで開きたい場合は、チャットリンクの説明を参照してください。
btnOrientation	任意	String	ボタンの配置方式： - 0：ボタンを縦並びに配置 - 1：ボタンを横並びに配置

独立遷移 ActionCard タイプ

{
    "msgtype": "actionCard",
    "actionCard": {
        "title": "ジョブズが20年前にAppleカフェを作りたかった、それこそがApple Storeの前身です", 
        "text": " \n\n #### ジョブズが20年前に作りたかったAppleカフェ \n\n Apple Storeのデザインは、フルハイテク感から生活感へと向かっており、その生活化の流れは20年前のAppleのカフェ建設計画まで遡ることができます", 
        "btnOrientation": "0", 
        "btns": [
            {
                "title": "内容が良い", 
                "actionURL": "https://www.dingtalk.io/"
            }, 
            {
                "title": "興味がない", 
                "actionURL": "https://www.dingtalk.io/"
            }
        ]
    }
}

パラメータ	必須	タイプ	説明
msgtype	必須	String	actionCard。
title	必須	String	チャット一覧の最初の画面に表示される内容。
text	必須	String	markdown 形式のチャットコンテンツ。説明 @ 機能を実装する場合は、text コンテンツ内に @ ユーザーの userId を追加してください。例：@manager7675
btns	必須	Array	ボタン。
title	必須	String	ボタンの見出し。
actionURL	必須	String	ボタンをクリックした際にトリガーされる URL。開き方は以下の通りです： - モバイル端末では DingTalk クライアント内で開きます - PC 端末 - デフォルトではサイドバーで開きます - 外部ブラウザで開きたい場合は、チャットリンクの説明を参照してください。
btnOrientation	任意	String	ボタンの配置順序。 0：ボタンを縦並びに配置 1：ボタンを横並びに配置

FeedCard タイプ

このタイプは@メンションには対応していません。

{
    "msgtype": "feedCard",
    "feedCard": {
        "links": [
            {
                "title": "時代の列車は前へ進む1", 
                "messageURL": "https://www.dingtalk.io/", 
                "picURL": "https://img.alicdn.com/tfs/TB1NwmBEL9TBuNjy1zbXXXpepXa-2400-1218.png"
            },
            {
                "title": "時代の列車は前へ進む2", 
                "messageURL": "https://www.dingtalk.io/", 
                "picURL": "https://img.alicdn.com/tfs/TB1NwmBEL9TBuNjy1zbXXXpepXa-2400-1218.png"
            }
        ]
    }
}

パラメータ	必須	タイプ	説明
msgtype	必須	String	feedCard。
title	必須	String	単一情報のテキスト。
messageURL	必須	String	単一情報をクリックした際の遷移リンク。詳細はチャットリンクの説明を参照してください。
picURL	必須	String	単一情報の後ろに表示される画像の URL。

グループにチャットを返信したくない場合は、以下の形式で返信します：

{
    "msgtype": "empty"
}

ボットによるチャット受信

ユーザーがグループボットを@メンションした場合、またはボットと個別チャットでメッセージを送信した場合、DingTalk はボットが受信したチャットを、開発者が設定したボットのコールバックサービスへ送信します。

チャット本文

本例では text テキストタイプを例に説明します。HTTP コールバック方式を使用する場合、POST リクエストで DingTalk からプッシュされたチャットを受信します。

{
  "senderPlatform": "Mac",
  "conversationId": "cid6EUxxxxsg==",
  "atUsers": [
    {
      "dingtalkId": "xxx",
      "staffId":"xxx",
      "unionId":"edxxx34"
    }
  ],
  "chatbotCorpId": "ding9733d095*******6cb783455b",
  "chatbotUserId": "$:LWCP_xxxxr5",
  "msgId": "msgrK2xxxxU+riw==",
  "senderNick": "ディンディン",
  "isAdmin": true,
  "senderStaffId": "0147xxxx8602",
  "sessionWebhookExpiredTime": 1708332604316,
  "createAt": 1708327204136,
  "senderCorpId": "ding9733d095*******6cb783455b",
  "conversationType": "2",
  "senderId": "$:LWCP_v1xxxxBv1MhAv9",
  "conversationTitle": "テストグループ",
  "isInAtList": true,
  "sessionWebhook": "https://oapi.dingtalk.io/robot/sendBySession?session=66d7c695a9xxxxdeb885",
  "text": {
    "content": " text"
  },
  "robotCode": "dingoxxxxdm3k",
  "msgtype": "text"
}

パラメータ	タイプ	説明
senderPlatform	String	チャット送信プラットフォーム。
conversationId	String	チャット ID。
atUsers	Array of Object	@メンション対象者の情報。 - dingtalkId：暗号化された@メンション対象者の ID。 - staffId：@メンション対象者の userId。外部グループの外部ユーザーの場合、このフィールドは空です。 - unionId：@メンション対象者の unionid。
chatbotCorpId	String	暗号化されたボットが所属する企業の組織 ID。
chatbotUserId	String	暗号化されたボット ID。
msgId	String	暗号化されたチャット ID。
senderNick	String	送信者の名前。
isAdmin	Boolean	管理者かどうか： - true：はい - false：いいえボットが公開された後に有効となります。それ以外の場合は返されません。
senderStaffId	String	社内グループにおいて、このボットを@メンションしたユーザーの userId。送信者がボットの所属企業のユーザーでない場合（例：外部グループで外部ユーザーがボットを@メンションした場合）、このフィールドは空です。ボットが公開された後に有効となります。それ以外の場合は返されません。
senderUnionId	String	送信者の unionid。
sessionWebhookExpiredTime	Long	現在のチャットの Webhook アドレスの有効期限。
createAt	String	チャットのタイムスタンプ。単位はミリ秒。
senderCorpId	String	社内グループにおける送信者の現在のグループの企業の組織 ID。
conversationType	String	会話タイプ： - 1：個別チャット - 2：グループチャット
senderId	String	暗号化された送信者 ID。
conversationTitle	String	グループチャットの場合のみ存在する会話の見出し。
isInAtList	Boolean	@メンションリストに含まれているかどうか。
sessionWebhook	String	現在のチャットの Webhook アドレス。
text	Object	チャットテキスト： - content：ボットが受信したチャットコンテンツ。このフィールドは、チャットタイプが text の場合にのみ存在します。
msgtype	String	チャットタイプ： - text：テキストチャット - richText：リッチテキストチャット - picture：画像メッセージ - audio：音声チャット - video：動画メッセージ - file：ファイルメッセージチャットタイプの具体的な形式は、下記のチャットタイプを参照してください。
robotCode	String	ボットコード。カスタムボットには robotCode はありません。

チャットタイプ

ボットは現在、テキスト・音声・画像・ファイル・動画・リッチテキストタイプのチャット受信に対応しています。以下は、ボットが受信する各チャットタイプのフィールドの説明です。チャットタイプとチャット本文のフィールドが異なる以外は、その他のパラメータフィールドは上記のテーブルと同じです。

テキストチャット

{
  "msgtype": "text",
  "text": {
    "content": "こんにちは"
  }
}

パラメータ	タイプ	説明
msgtype	String	チャットタイプ： - text：テキストチャット
text	Object	チャットテキスト： - content：ボットが受信したチャットコンテンツ。

リッチテキストチャット

{
  "msgtype": "richText",
  "content": {
    "richText": [
      {
        "text": "こんにちは"
      },
      {
        "downloadCode": "mIofN681YE3f*************JkVBG2vhj4Q9、d2tn/t6XxjaB6UxxxxOVnYYbn1aMT/n3JFgb4i64X3TFxxxxGWxJPR/egKS8syvGzxxxxOO/FYLor2Q==",
        "type": "picture"
      }
    ]
  }
}

名前	タイプ	説明
msgtype	String	チャットタイプ： - richText：リッチテキスト
content	Object	チャットコンテンツ。
richText	Array of Object	リッチテキストリスト。説明チャットリストには以下を含めることができます： - text：テキストチャット - picture：画像メッセージ画像ファイルのダウンロードコード downloadCode は、サーバー API のボットが受信したチャットのファイルコンテンツのダウンロード API を呼び出して一時ダウンロードリンクを取得できます。

画像メッセージ

{
  "msgtype": "picture",
  "content": {
    "downloadCode": "mIofN681YE3f/+m+**********8rs4RGdQAwyVs3B75N7boKf8ep0FBB122u9YY/novFAM9BQrirm4/+avZaCV+6nnZ0Zk="
  }
}

パラメータ	タイプ	説明
msgtype	String	チャットタイプ： - picture：画像メッセージ
downloadCode	String	画像ファイルのダウンロードコード。画像のバイナリファイルをダウンロードするために使用されます。サーバー API のボットが受信したチャットのファイルコンテンツのダウンロード API を呼び出して一時ダウンロードリンクを取得できます。

音声チャット

グループチャットにおいて、グループメンバーがボットを @メンションした場合、ボットは音声チャットの受信に対応していません。

{
  "msgtype": "audio",
  "content": {
    "duration": 4000,
    "downloadCode": "mIofN681YE3f/+m+Nn***********geqPd7xpJF/9NbOAORDnadz0WbSwWTiYvByBeYDjbg2ecUdno/RGtZ/sqzdvoh00EWw1U6xNqLC3Bk51U+i",
    "recognition": "DingTalk、進歩を起こす"
  }
}

パラメータ	タイプ	説明
msgtype	String	チャットタイプ： - audio：音声チャット
downloadCode	String	音声ファイルのダウンロードコード。音声のバイナリファイルをダウンロードするために使用されます。サーバー API のボットが受信したチャットのファイルコンテンツのダウンロード API を呼び出して一時ダウンロードリンクを取得できます。
recognition	String	音声認識後のテキスト。
duration	Long	音声の長さ。単位はミリ秒。

動画メッセージ

グループチャットにおいて、グループメンバーがボットを @メンションした場合、ボットは動画メッセージの受信に対応していません。

{
  "msgtype": "video",
  "content": {
    "duration": 4000,
    "downloadCode": "mIofN681YE3f/****************OAORDnadz0WbSwWTiYvByBeYDjbg2ecUdno/RGtZxxxxLC3Bk51U+i",
    "videoType": "mp4"
  }
}

パラメータ	タイプ	説明
msgtype	String	チャットタイプ： - video：動画メッセージ
downloadCode	String	動画ファイルのダウンロードコード。動画のバイナリファイルをダウンロードするために使用されます。サーバー API のボットが受信したチャットのファイルコンテンツのダウンロード API を呼び出して一時ダウンロードリンクを取得できます。
videoType	String	動画ファイルタイプ。
duration	Long	動画の長さ。単位はミリ秒。

ファイルメッセージ

グループチャットにおいて、グループメンバーがボットを @メンションした場合、ボットはファイルメッセージの受信に対応していません。

{
  "msgtype": "file",
  "content": {
    "downloadCode": "mIofN681YE3f*************pJF/9NbOAORDnadxxxxg2ecUdno/RGtZ/sqzdxxxxC3Bk51U+i",
    "fileName": "DingTalk進歩を起こす.pdf"
  }
}

パラメータ	タイプ	説明
msgtype	String	チャットタイプ： - video：ファイルメッセージ
downloadCode	String	ファイルのダウンロードコード。ファイルのバイナリファイルをダウンロードするために使用されます。サーバー API のボットが受信したチャットのファイルコンテンツのダウンロード API を呼び出して一時ダウンロードリンクを取得できます。
fileName	String	ファイル名。

パラメータ	説明
timestamp	チャットを送信したタイムスタンプ。単位はミリ秒。
sign	署名値。

設定項目	説明
timestamp	現在時刻のタイムスタンプ。単位はミリ秒。
appSecret	アプリの Client Secret。詳細は Client Secret を参照してください。

エラーコード

ボットの Webhook と Stream の使用量が上限を超えた場合、以下のような内容が表示されます：

エラーの状態

グループチャット

個別チャット

エラーの説明

エラーコード（errorCode）	エラーメッセージ（errorMessage）	説明	解決方法
20001	呼び出し回数の上限を超えたため、現在マイメッセージサービスは一時停止されています。所属組織の管理者へ連絡して対応を依頼してください受信チャットに新たに errorMessage フィールドが追加され、エラーメッセージの表示に使用されます。	- 受信チャットには text と content フィールドのコンテンツがありません - 開発者管理画面にログインすることで呼び出し回数を確認できます。	DingTalk プロフェッショナル版へのアップグレードまたは追加購入パッケージの購入が必要です。詳細は企業追加購入パッケージ購入の説明を参照してください。

API 呼び出しガイド

認証と認可

連絡先

カレンダー

会議

AI Table

Docs とファイル

IM

ボットによるチャット送信

チャットタイプ

方法 1：API 経由

重要

対応 API

データ形式

Markdown でサポートされる構文

方法 2：Webhook 経由

テキスト text タイプ

リンク Link タイプ

Markdown タイプ

ActionCard タイプ

FeedCard タイプ

ボットによるチャット受信

チャット本文

チャットタイプ

テキストチャット

リッチテキストチャット

画像メッセージ

音声チャット

動画メッセージ

ファイルメッセージ

関連情報

エラーコード

エラーの状態

グループチャット

個別チャット

エラーの説明

関連ドキュメント

​ボットによるチャット送信

​チャットタイプ

​方法 1：API 経由

​重要

​対応 API

​データ形式

​Markdown でサポートされる構文

​方法 2：Webhook 経由

​テキスト text タイプ

​リンク Link タイプ

​Markdown タイプ

​ActionCard タイプ

​FeedCard タイプ

​ボットによるチャット受信

​チャット本文

​チャットタイプ

​テキストチャット

​リッチテキストチャット

​画像メッセージ

​音声チャット

​動画メッセージ

​ファイルメッセージ

​関連情報

​エラーコード

​エラーの状態

グループチャット

個別チャット

​エラーの説明

​関連ドキュメント

ボットによるチャット送信

チャットタイプ

方法 1：API 経由

重要

対応 API

データ形式

Markdown でサポートされる構文

方法 2：Webhook 経由

テキスト text タイプ

リンク Link タイプ

Markdown タイプ

ActionCard タイプ

FeedCard タイプ

ボットによるチャット受信

チャット本文

チャットタイプ

テキストチャット

リッチテキストチャット

画像メッセージ

音声チャット

動画メッセージ

ファイルメッセージ

関連情報

エラーコード

エラーの状態

エラーの説明

関連ドキュメント