互通群机器人发送群消息

接口调用量说明：钉钉标准版接口累计可调用次数为1万次/月，当前接口会消耗调用次数。若该调用量无法满足需求，你可升级钉钉专业版(Open API调用量50万次/月)或钉钉专属版(Open API调用量500万次/月)扩容调用次数。

调用本接口，通过互通群内机器人向群内发送消息。

接口使用说明

说明

本接口只支持互通普通群和跨钉两人群使用。钉外两人群和店铺群暂不支持机器人发送群消息。

调用本接口之前，需要开通钉钉互联应用：

企业内部应用，请参考如何开通钉钉客联。

第三方企业应用，请参考如何开通钉钉客联。

在创建互通群时，会自动添加群内机器人，调用本接口可使用内置的群机器人发送群消息。

消息格式说明

本接口支持的群消息类型有文本、图片、markdown和卡片。

文本信息

{ "content": "我就是我, 是不一样的烟火"}

图片信息

{"img_media_id": "https://lmg.jj20.com/up/allimg/4k/s/02/2109250135252955-0-lp.jpg"}

说明

图片地址需为图片上传后的http或者https的url地址。

markdown信息

{
        "title": "标题",
        "markdown_content": "# 测试内容"
 }

卡片信息

{
        "title": "标题",
        "markdown": "# 测试内容",
        "btn_orientation": "1",
        "btn_title_1": "btn_title_1",
        "action_url_1": "https://www.dingtalk.com/",
        "btn_title_2": "btn_title_2",
        "action_url_2": "https://www.dingtalk.com/",
        "btn_title_3": "btn_title_3",
        "action_url_3": "suitezlqnkv2atcpimsjn_actioncard1",
        "btn_title_4": "btn_title_4",
        "action_url_4": "https://www.dingtalk.com/"
 }

actionCard占位符key值

key	说明
title	会话列表显示标题。
markdown	消息内容，支持markdown语法。
btn_orientation	按钮排列方向，仅2个按钮时有效，传值为0时为竖直排列，传值为1时水平排列。
btn_title_1 ~ btn_title_4	按钮文案，支持最多4个按钮，传空或不传则按钮不显示。
action_url_1 ~ action_url_4	按钮跳转地址，支持最多4个按钮，传空或不传则按钮不显示。

错误码

HttpCode	错误码	错误信息	说明
400	general.parameterError	输入参数有误，请检查是否超出最大值或传参规则不正确	输入参数有误，请检查是否超出最大值或传参规则不正确
400	aim.nonexist	您尚未开通钉钉客联服务，请联系钉钉官方客服咨询开通	您尚未开通钉钉客联服务，请联系钉钉官方客服咨询开通
400	corp.robot.nonexist	该组织机器人不存在，请检查	该组织机器人不存在，请检查
400	msgContent.error	发送消息体参数错误	发送消息体参数错误
400	openConversationIds.error	openConversationIds中存在错误或失效群	openConversationIds中存在错误或失效群
400	image.url.error	上传图片失败，请检查图片url是否可用或者图片大小超过1M	上传图片失败，请检查图片url是否可用或者图片大小超过1M
400	atMember.nonexist	at的人员不存在或者不在群中	at的人员不存在或者不在群中
400	message.notSupportPhoto	暂不支持发送图片	暂不支持发送图片
500	robot.sendMessage.error	机器人发送消息失败	机器人发送消息失败
500	system.error	系统异常	系统异常

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

互通群机器人发送群消息

接口使用说明

消息格式说明

错误码

请求参数

请求示例代码

返回响应

互通群机器人发送群消息

接口使用说明#

消息格式说明#

错误码#

请求参数

请求示例代码

返回响应

接口使用说明

消息格式说明

错误码