消息实体

class dingtalk.model.message.TextBody(content, **kwargs)[源代码]
__init__(content, **kwargs)[源代码]

文本消息

参数:
  • content – 消息内容
  • kwargs
class dingtalk.model.message.FileBody(media_id, **kwargs)[源代码]
__init__(media_id, **kwargs)[源代码]

文件消息

参数:
  • media_id – 媒体文件id,可以调用上传媒体文件接口获取。10MB
  • kwargs
class dingtalk.model.message.ImageBody(media_id, **kwargs)[源代码]
__init__(media_id, **kwargs)[源代码]

图片消息

参数:
  • media_id – 图片媒体文件id,可以调用上传媒体文件接口获取。建议宽600像素 x 400像素,宽高比3:2
  • kwargs
class dingtalk.model.message.VoiceBody(media_id, duration=None, **kwargs)[源代码]
__init__(media_id, duration=None, **kwargs)[源代码]

语音消息

参数:
  • media_id – 语音媒体文件id,可以调用上传媒体文件接口获取。2MB,播放长度不超过60s,AMR格式
  • duration – 正整数,小于60,表示音频时长
  • kwargs
class dingtalk.model.message.LinkBody(message_url, pic_url, title, text, **kwargs)[源代码]
__init__(message_url, pic_url, title, text, **kwargs)[源代码]

超链接消息

参数:
  • message_url – 消息点击链接地址
  • pic_url – 图片媒体文件id,可以调用上传媒体文件接口获取
  • title – 消息标题
  • text – 消息描述
class dingtalk.model.message.MarkdownBody(title, text, **kwargs)[源代码]
__init__(title, text, **kwargs)[源代码]

markdown消息

参数:
  • title – 首屏会话透出的展示内容
  • text – markdown格式的消息
  • kwargs
class dingtalk.model.message.OaBodyContent(title=None, content=None, author=None, image=None, file_count=None, forms=<class 'dict'>, rich_num=None, rish_unit=None, **kwargs)[源代码]
__init__(title=None, content=None, author=None, image=None, file_count=None, forms=<class 'dict'>, rich_num=None, rish_unit=None, **kwargs)[源代码]

OA消息 消息体

参数:
  • title – 消息体的标题
  • content – 消息体的内容,最多显示3行
  • author – 自定义的作者名字
  • image – 消息体中的图片media_id
  • file_count – 自定义的附件数目。此数字仅供显示,钉钉不作验证
  • forms – 消息体的表单
  • rich_num – 单行富文本信息的数目
  • rish_unit – 单行富文本信息的单位
  • kwargs
class dingtalk.model.message.OaBody(message_url, head_bgcolor, head_text, body, pc_message_url=None, **kwargs)[源代码]
__init__(message_url, head_bgcolor, head_text, body, pc_message_url=None, **kwargs)[源代码]

OA消息

参数:
  • message_url – 客户端点击消息时跳转到的H5地址
  • head_bgcolor – 消息头部的背景颜色。长度限制为8个英文字符,其中前2为表示透明度,后6位表示颜色值。不要添加0x
  • head_text – 消息的头部标题(向普通会话发送时有效,向企业会话发送时会被替换为微应用的名字),长度限制为最多10个字符
  • body – OaBodyContent OA消息 消息体
  • pc_message_url – PC端点击消息时跳转到的H5地址
  • kwargs
class dingtalk.model.message.SingleActionCardBody(title, markdown, single_title, single_url, **kwargs)[源代码]
__init__(title, markdown, single_title, single_url, **kwargs)[源代码]

整体跳转ActionCard消息

参数:
  • title – 透出到会话列表和通知的文案
  • markdown – 消息内容,支持markdown
  • single_title – 标题
  • single_url – 链接url
  • kwargs
class dingtalk.model.message.BtnActionCardBody(title, markdown, btn_orientation, btn_list=(), **kwargs)[源代码]
__init__(title, markdown, btn_orientation, btn_list=(), **kwargs)[源代码]

独立跳转ActionCard消息

参数:
  • title – 透出到会话列表和通知的文案
  • markdown – 消息内容,支持markdown
  • btn_orientation – 按钮排列方式,竖直排列(0),横向排列(1)
  • btn_json_list – 按钮列表
  • kwargs
add_btn(title, action_url)[源代码]

添加按钮

参数:
  • title – 标题
  • action_url – 链接url
返回: