开发者社区> 问答> 正文

在钉钉的Webhook方式中,文本、链接、Markdown、整体跳转ActionCard和独立跳转A

在钉钉的Webhook方式中,文本、链接、Markdown、整体跳转ActionCard和独立跳转ActionCard都需要哪些必填参数?

展开
收起
乐天香橙派 2023-07-06 11:18:44 558 0
3 条回答
写回答
取消 提交回答
  • 北京阿里云ACE会长

    在钉钉的Webhook方式中,不同类型的消息所需的必填参数不同。以下是文本、链接、Markdown、整体跳转ActionCard和独立跳转ActionCard所需的必填参数:

    文本类型消息
    文本类型消息是最简单的一种消息类型,只包含一段文本内容。在发送文本类型消息时,需要以下必填参数:

    msgtype: 消息类型,固定为text;
    text: 文本消息内容,最长不超过2048个字节。
    链接类型消息
    链接类型消息可以包含一个标题、一段描述和一个URL链接。在发送链接类型消息时,需要以下必填参数:

    msgtype: 消息类型,固定为link;
    title: 消息标题,最长不超过128个字节;
    text: 消息描述,最长不超过2048个字节;
    messageUrl: 点击消息跳转的URL链接,最长不超过2048个字节。
    Markdown类型消息
    Markdown类型消息可以使用Markdown语法来格式化消息内容。在发送Markdown类型消息时,需要以下必填参数:

    msgtype: 消息类型,固定为markdown;
    title: 首屏会话透出的展示内容,最长不超过128个字节;
    text: Markdown格式的消息内容,最长不超过4096个字节。
    整体跳转ActionCard类型消息
    整体跳转ActionCard类型消息可以包含一个标题、一段描述和一个按钮,点击按钮可以跳转到一个URL链接。在发送整体跳转ActionCard类型消息时,需要以下必填参数:

    msgtype: 消息类型,固定为actionCard;
    title: 消息标题,最长不超过128个字节;
    text: 消息描述,最长不超过2048个字节;
    singleTitle: 按钮标题,最长不超过16个字节;
    singleURL: 点击按钮跳转的URL链接,最长不超过2048个字节。
    独立跳转ActionCard类型消息
    独立跳转ActionCard类型消息可以包含一个标题、一段描述和多个按钮,点击每个按钮可以跳转到一个不同的URL链接。在发送独立跳转ActionCard类型消息时,需要以下必填参数:

    msgtype: 消息类型,固定为actionCard;
    title: 消息标题,最长不超过128个字节;
    text: 消息描述,最长不超过2048个字节;
    btnOrientation: 按钮排列的方向,可选值为0(竖直排列)或1(横向排列);
    btns: 按钮列表,最多包含4个按钮,每个按钮需要包含两个参数:
    title: 按钮标题,最长不超过16个字节;
    actionURL: 点击按钮跳转的URL链接,最长不超过2048个字节。

    2023-07-29 21:58:53
    赞同 展开评论 打赏
  • 在钉钉的Webhook方式中,你可以使用以下几种方式发送消息:

    1. 文本消息(Text Message):使用text类型的消息,可以发送简单的文本内容。例如:
    {
      "msgtype": "text",
      "text": {
        "content": "这是一条文本消息"
      }
    }
    
    1. 链接消息(Link Message):使用link类型的消息,可以发送带有标题、描述和链接的消息。例如:
    {
      "msgtype": "link",
      "link": {
        "title": "这是一个链接消息",
        "text": "点击查看详情",
        "messageUrl": "https://example.com"
      }
    }
    
    1. Markdown消息(Markdown Message):使用markdown类型的消息,可以发送支持Markdown语法的消息。例如:
    {
      "msgtype": "markdown",
      "markdown": {
        "title": "这是一个Markdown消息",
        "text": "# 标题\n\n- 列表项1\n- 列表项2\n\n[链接文本](https://example.com)"
      }
    }
    
    1. 整体跳转ActionCard消息(Single Jump ActionCard Message):使用actionCard类型的消息,可以以整体跳转的方式展示消息,并包含一个按钮。例如:
    {
      "msgtype": "actionCard",
      "actionCard": {
        "title": "这是一个整体跳转ActionCard",
        "text": "点击按钮进行跳转",
        "singleTitle": "跳转按钮",
        "singleURL": "https://example.com"
      }
    }
    
    1. 独立跳转ActionCard消息(Independent Jump ActionCard Message):使用actionCard类型的消息,可以以独立跳转的方式展示消息,并包含多个按钮供用户选择。例如:
    {
      "msgtype": "actionCard",
      "actionCard": {
        "title": "这是一个独立跳转ActionCard",
        "text": "请选择要进行的操作",
        "btnOrientation": "1",
        "btns": [
          {
            "title": "按钮1",
            "actionURL": "https://example.com/1"
          },
          {
            "title": "按钮2",
            "actionURL": "https://example.com/2"
          }
        ]
      }
    }
    

    以上是钉钉Webhook方式中常用的几种消息类型及其对应的示例。根据你的需求,选择相应的消息类型和参数来发送消息。

    2023-07-06 16:29:07
    赞同 展开评论 打赏
  • 在Webhook方式中,无论是文本、链接、Markdown、整体跳转ActionCard还是独立跳转ActionCard,都需要填写msgtype参数,并且文本和Markdown类型需要填写text或markdown参数,链接类型需要填写link参数,整体跳转ActionCard类型需要填写singleTitle和singleURL参数,独立跳转ActionCard类型需要填写btns参数。其他参数根据需求选择填写。—此回答来自钉群“钉钉开发者社区(互助群)”

    2023-07-06 13:20:51
    赞同 展开评论 打赏
来源圈子
更多
收录在圈子:
+ 订阅
问答排行榜
最热
最新

相关电子书

更多
钉钉小程序——为工作方式插上翅膀 立即下载
钉钉客户端自动化的应用 立即下载
使命必达 —— 钉钉企业级 消息服务的机遇与挑战 立即下载