当前位置：首页 > 行业动态 > 正文

钉钉机器人发送钉钉卡片消息

admin
行业动态
2024-05-07
2

钉钉机器人发送钉钉卡片消息是一种自动化的方式，可以向指定的钉钉群或用户发送包含特定信息的消息，下面是详细的步骤和小标题：

1、创建钉钉机器人

登录钉钉开发者后台

点击左侧导航栏的"机器人管理"

点击"添加机器人"按钮

填写机器人的基本信息，如名称、头像等

配置机器人的权限和接收消息的群组或用户

钉钉机器人发送钉钉卡片消息

2、获取钉钉机器人的Webhook地址

在机器人管理页面，找到刚刚创建的机器人

点击"查看"按钮，进入机器人详情页

在详情页中，找到"Webhook"字段，复制该地址

3、编写代码发送钉钉卡片消息

钉钉机器人发送钉钉卡片消息

使用编程语言（如Python）编写代码，调用钉钉机器人的API接口

将Webhook地址作为参数传递给API接口

构建卡片消息的结构，包括标题、内容、按钮等

将卡片消息作为参数传递给API接口

发送请求，触发钉钉机器人发送卡片消息

钉钉机器人发送钉钉卡片消息

4、解析钉钉卡片消息的结构

钉钉卡片消息的结构由多个字段组成，可以使用单元表格进行说明

字段名	类型	描述
title	String	卡片的标题，最多不超过64个字符
text	String	卡片的内容，最多不超过1024个字符
btn_text	String	卡片底部按钮的文字，最多不超过6个字符
btn_url	String	卡片底部按钮的跳转链接，最长不超过2048个字符
is_at_all	Boolean	是否@所有人，默认为false
is_single	Boolean	是否单聊模式，默认为false
at_mobiles	List	@指定手机号的用户列表，最多不超过10个
at_users	List	@指定用户的列表，最多不超过10个
at_party_ids	List	@指定群组的ID列表，最多不超过10个
at_discussions	List	@指定讨论组的ID列表，最多不超过10个
at_stared	List	@指定已置顶的群组或讨论组的ID列表，最多不超过10个
at_mentioned	List	@被@的用户列表，最多不超过10个
is_hidden	Boolean	是否隐藏卡片，默认为false
ext	Map	扩展字段，用于传递额外的信息，最多不超过5个

5、发送钉钉卡片消息的示例代码（Python）

import requests
import json
webhook = "https://oapi.dingtalk.com/robot/send?access_token=ACCESS_TOKEN"
headers = {"ContentType": "application/json;charset=utf8"}
data = {
    "msgtype": "link",
    "link": {
        "title": "卡片标题",
        "text": "卡片内容",
        "btn_text": "按钮文字",
        "btn_url": "https://www.example.com",
        "is_at_all": False,
        "is_single": False,
        "at_mobiles": ["手机号码"],
        "at_users": ["用户名"],
        "at_party_ids": ["群组ID"],
        "at_discussions": ["讨论组ID"],
        "at_stared": ["已置顶群组或讨论组ID"],
        "at_mentioned": ["被@的用户"],
        "is_hidden": False,
        "ext": {"key": "value"}
    }
}
response = requests.post(webhook, data=json.dumps(data), headers=headers)
print(response.text)

注意：请将ACCESS_TOKEN替换为你自己的钉钉机器人的访问令牌。