连接平台简介
开发指南
实践教程
连接器中心
内置工具
官方连接器
考勤
宜搭
表格
邮箱
日程
公告
签到
日志
AI能力
多维表
通讯录
机器人
OA审批
工作通知
消息通知
概述
参数说明
智能人事
待办事项
应用管理
数据目录
会话管理(场景群)
三方连接器
连接平台自动化
历史文档

参数说明

更新于 2024-02-02

执行动作说明

发送消息到企业群[文本消息]

入参

类型

必填

详细说明

msg

Object

发送消息的类型。

text

Object

文本消息。

content

String

消息内容。

chatid

String

输入群会话ID,待发送群的会话ID。

发送消息到企业群[图片消息]

入参

类型

必填

详细说明

msg

Object

发送消息的类型。

image

Object

图片消息。

media_id

String

可以通过调用上传媒体文件接口获取mediaId参数值。

chatid

String

输入群会话ID,待发送群的会话ID。

发送消息到企业群[markdown消息]

入参

类型

必填

详细说明

msg

Object

消息类型。

markdown

Object

markdown消息。

text

String

markdown格式的消息。

title

String

首屏会话透出的展示内容。

chatid

String

输入群会话ID,待发送群的会话ID。

发送消息到企业群[OA消息]

入参

类型

必填

详细说明

msg

Object

消息类型。

oa

Object

oa消息。

head

Object

消息头部内容。

bgcolor

String

消息头部的背景颜色。长度限制为8个英文字符,其中前2为表示透明度,后6位表示颜色值。不要添加0x。

text

String

消息的头部标题 。

说明
  • 向普通会话发送时有效,向企业会话发送时会被替换为微应用的名字

  • 长度限制为最多10个字符。

pc_message_url

String

PC端点击消息时跳转到的地址。

body

Object

消息体。

file_count

String

自定义的附件数目。

说明

此数字仅供显示,钉钉不作验证。

image

String

可以通过调用上传媒体文件接口获取mediaId参数值。

form

Array of Object

消息体的表单。例如:

Loading...
说明

最多显示6个,超过会被隐藏。

key

String

消息体的关键字。

value

String

消息体的关键字对应的值。

author

String

自定义的作者名字。

rich

Object

单行富文本信息。

unit

String

单行富文本信息的单位。

num

String

单行富文本信息的数目。

title

String

消息体的标题。

说明

建议50个字符以内

content

String

消息体的内容。

说明

最多显示3行。

message_url

String

消息点击链接地址,当发送消息为小程序时支持小程序跳转链接。

chatid

String

输入群会话ID,待发送群的会话ID。

发送消息到企业群[链接消息]

名称

类型

是否必填

描述

chatid

String

输入群会话ID,待发送群的会话ID。

msg

Object

消息类型。

link

Object

链接消息。

messageUrl

String

消息点击链接地址。

picUrl

String

图片地址。

text

String

消息文本。

title

String

消息标题。

发送消息到企业群[voice消息]

入参

类型

必填

详细说明

msg

Object

消息类型。

voice

Object

voice消息。

duration

String

录音时长,单位s。

说明

播放长度不超过60s。

media_id

String

可以通过调用上传媒体文件接口获取mediaId参数值。

说明

不超过2MB,AMR格式。

chatid

String

输入群会话ID,待发送群的会话ID。

发送消息到企业群[文件消息]

入参

类型

必填

详细说明

msg

Object

发送消息的类型。

file

Object

文件消息。

media_id

String

可以通过调用上传媒体文件接口获取mediaId参数值。

chatid

String

输入群会话ID,待发送群的会话ID。

发送消息到企业群[卡片消息]

整体跳转ActionCard样式,支持一个点击Action,必须传入参数 single_title和 single_url。

Loading...

独立跳转ActionCard样式,支持多个点击Action,必须传入参数 btn_orientation 和 btn_json_list。

Loading...

名称

类型

是否必填

描述

chatid

String

输入群会话ID,待发送群的会话ID。

msg

Object

发送消息的类型。

action_card

Object

卡片消息。

agentid

String

应用在企业的AgentId

btn_json_list

Array

使用独立跳转ActionCard样式时的按钮列表。

说明

必须与btn_orientation同时设置。

action_url

String

使用独立跳转消息点击链接地址。

title

String

使用独立跳转ActionCard样式时的按钮的标题。

说明

最长20个字符。

single_url

String

使用整体跳转消息点击链接地址。

说明

最长500个字符。

btn_orientation

String

使用独立跳转ActionCard样式时的按钮排列方式:

  • 0:竖直排列

  • 1:横向排列

说明

必须与btn_json_list同时设置。

single_title

String

使用整体跳转ActionCard样式时的标题。

说明
  • 必须与single_url同时设置。

  • 最长20个字符。

markdown

String

消息内容。

说明

建议1000个字符以内。

hide_avatar

Boolean

是否隐藏发送者头像。

title

String

透出到会话列表和通知的文案。

说明

最长64个字符。

点击纠错