开发者社区 问答 正文

钉钉互动卡片有哪些属性,如何发送、更新和控制回调?

钉钉互动卡片有哪些属性,如何发送、更新和控制回调?

展开
收起
三分钟热度的鱼 2023-08-08 16:53:50 811 分享 版权
4 条回答
写回答
取消 提交回答
  • 面对过去,不要迷离;面对未来,不必彷徨;活在今天,你只要把自己完全展示给别人看。

    钉钉互动卡片是一种在钉钉工作通知、审批等场景下使用的消息类型,具有丰富的交互功能。以下是钉钉互动卡片的常见属性和相关操作:

    1. 属性:

      • title:卡片标题
      • markdown:使用Markdown语法的卡片内容
      • btnOrientation:按钮排列方式(横向或纵向)
      • hideAvatar:是否隐藏发送者头像
      • btns:按钮列表,包含按钮名称、链接和回调信息
    2. 发送卡片消息:

      • 使用"DingTalkPC.message.post"接口发送互动卡片消息。
      • 在消息中指定"msgtype"为"interactive",并提供互动卡片的属性数据。
    3. 更新卡片消息:

      • 使用"DingTalkPC.conversation.sendMessage"接口更新已发送的互动卡片消息。
      • 需要提供原始消息的messageId和corpid,并在消息中指定更新后的卡片属性数据。
    4. 控制回调:

      • 在互动卡片的按钮(btns)中定义回调信息,包括"actionURL"和"extInfo"。
      • 当用户点击按钮时,将触发相应的回调事件,可以在回调URL中处理和响应该事件。

    需要注意的是,以上操作涉及到钉钉开放平台的接口和相关参数,具体的接口名称和参数可能会因钉钉版本和组织设置而有所不同。建议您查阅钉钉开放平台的文档和接口说明,以获取最新的接口列表和具体使用方法。
    image.png

    image.png

    2023-08-09 23:01:06
    赞同 展开评论
  • 钉钉的互动卡片(Interactive Card)是一种用于在群聊中展示交互式内容的消息类型。它可以包含文本、图片、按钮、表单等元素,并且支持通过回调进行用户操作的响应。

    互动卡片具有以下属性:

    1. msgtype:消息类型,设置为interactive表示发送互动卡片。
    2. interaction_type:互动类型,指定互动卡片的样式和行为。例如,可选值为cardformpicker等。
    3. title:卡片标题,用于展示在互动卡片的顶部。
    4. content:卡片内容,可以是文本或富文本形式的内容描述。
    5. buttons:按钮列表,包含多个按钮,在互动卡片上展示不同的操作按钮。

    发送互动卡片:

    要发送互动卡片,您需要使用钉钉开放平台提供的机器人接口(Webhook),将互动卡片作为消息内容发送到指定的群聊。

    更新互动卡片:

    如果您想要更新已经发送的互动卡片,可以通过再次发送一个新的互动卡片消息来覆盖原有的卡片内容。这样,钉钉会自动将新的卡片显示在群聊中,并隐藏旧的卡片。

    控制回调:

    互动卡片中的按钮可以设置回调参数,当用户点击按钮时,钉钉会发送一个回调事件给您的服务器。您可以在机器人接口(Webhook)配置的回调 URL 中处理这些回调事件,并根据需要进行业务逻辑的处理。

    2023-08-08 21:52:06
    赞同 展开评论
  • 北京阿里云ACE会长

    卡片类型:

    action_card:操作类卡片,包含一组操作按钮
    news_card:图文类卡片,包含标题、内容和图片
    其他类型
    配置属性:

    title:卡片标题
    description:描述
    btns:按钮组,用于操作类卡片
    articles:文章组,用于图文类卡片
    image:图片地址
    更多属性
    发送过程:

    调用聊天API或个人API,发送初始化卡片
    钉钉在手机端显示该卡片
    更新卡片:

    通过聊天API或个人API再次发送卡片JSON
    手机号端会判断为更新操作,实时更新卡片内容
    控制回调:

    在按钮组btns中,配置action_url作为回调URL
    用户点击按钮后,会 GET 或 POST请求配置的回调URL
    在回调URL中,可以获取到调用该API的钉钉用户userid和部门deptid信息
    回调数据格式:

    json
    Copy
    {
    "encrypt_type": 0,
    "msg_signature": "xxxxxx",
    "timestamp": 1582471623,
    "nonce": "1584136020",
    "user_id":"xxxx" //回调用户ID
    }
    {
    "userid":"xxxx",
    "deptid":"1"
    }
    通过上述方式,就可以实现钉钉互动卡片的发送、更新和事件回调。

    2023-08-08 19:28:30
    赞同 展开评论
  • 互动卡片的属性包括发送人、接收人、卡片标题、卡片内容、卡片按钮等。可以通过调用API接口来发送、更新和控制回调互动卡片。具体包括:发送互动卡片、更新互动卡片、注册互动卡片回调地址、人与人会话中机器人发送互动卡片等。此回答整理自钉群“钉钉开发者社区(互助群)”

    2023-08-08 16:56:39
    赞同 展开评论