开发者社区 问答 正文

钉钉如何发送一条整体跳转ActionCard样式的卡片消息?

钉钉如何发送一条整体跳转ActionCard样式的卡片消息?

展开
收起
三分钟热度的鱼 2023-07-26 15:11:52 798 分享 版权
3 条回答
写回答
取消 提交回答
  • 在钉钉中发送一条整体跳转ActionCard样式的卡片消息,您可以按照以下步骤进行:

    1. 构建消息内容:首先,构建卡片消息的内容,包括标题、内容、按钮等。整体跳转ActionCard样式的卡片消息通常包含一个跳转链接和一个按钮。

    2. 创建消息对象:根据钉钉开放平台提供的消息格式,创建一个JSON对象,用于描述消息的具体内容。

    3. 设置消息类型和样式:在消息对象中设置msgtype字段为actionCard,并设置actionCard字段中的titletextsingleTitlesingleURL等字段,分别对应卡片的标题、内容、按钮文字和跳转链接。

    4. 发送消息:使用钉钉开放平台提供的接口,如/topapi/message/corpconversation/asyncsend_v2,将消息对象作为参数发送给指定会话或用户。

    下面是发送整体跳转ActionCard样式卡片消息的示例代码(以Python为例):

    import requests
    
    url = "https://oapi.dingtalk.com/topapi/message/corpconversation/asyncsend_v2"
    access_token = "YOUR_ACCESS_TOKEN"
    
    headers = {'Content-Type': 'application/json'}
    data = {
        "agent_id": YOUR_AGENT_ID,
        "userid_list": ["user1", "user2"],  # 目标用户列表,可根据需要修改
        "msg": {
            "msgtype": "actionCard",
            "actionCard": {
                "title": "卡片标题",
                "text": "卡片内容",
                "singleTitle": "查看详情",
                "singleURL": "https://example.com"
            }
        }
    }
    
    response = requests.post(url, headers=headers, params={"access_token": access_token}, json=data)
    print(response.json())
    
    2023-07-26 19:03:57
    赞同 展开评论
  • 北京阿里云ACE会长

    具体的操作如下:

    注册应用并获得access token
    首先,在钉钉开放平台注册一个应用,会获得appkey和appsecret。使用appsecret和auth code换取access token。

    准备请求参数
    请求参数需要指定卡片的标题、描述、图片、按钮等内容:

    标题和描述

    图片url

    一个跳转整体ActionCard类型的按钮,指定跳转url和文本

    调用群消息接口
    利用access token 调用群消息接口发送卡片消息:

    Copy
    https://oapi.dingtalk.com/message/transpot/send_to_conversation?access_token={access_token}
    请求参数如下:

    json
    Copy
    {
    "msgtype": "action_card",
    "action_card":{
    "title": "卡片标题",
    "text": "卡片描述",
    ...
    "btnorient": "0",
    "btns": [{
    "action_url": "跳转URL",
    "title": "按钮文本",
    "type": "action_url"
    }]
    }
    }
    其中type值为action_url,表示整体跳转类型的按钮。

    2023-07-26 18:54:46
    赞同 展开评论
  • 要发送一条整体跳转ActionCard样式的卡片消息,需要传入参数msgtype、action_card.markdown、action_card.title、action_card.single_title和action_card.single_url。其中,action_card.single_title和action_card.single_url必须同时设置。消息样例如下: { "msgtype": "action_card", "action_card": { "title": "是透出到会话列表和通知的文案", "markdown": "支持markdown格式的正文内容", "single_title": "查看详情", "single_url": "https://open.dingtalk.com" } }此回答整理自钉群“钉钉开发者社区(互助群)”

    2023-07-26 15:14:32
    赞同 展开评论