2.0 KiB
Raw Permalink Blame History

id, title, type, feature, scope, locale, aliases, related_tools, related_pages, prerequisites, negative, last_verified
id title type feature scope locale aliases related_tools related_pages prerequisites negative last_verified
messenger.bot.concept 系统机器人会话 concept messenger end-user zh
系统机器人
机器人会话
任务提醒机器人
签到机器人
谁给我发的系统消息
这个机器人是谁
send_message
messenger
dialog_chat
机器人会话不能被踢出 / 屏蔽,会随对应业务消息长期保留
不能 @ 机器人触发动作,机器人是单向推送通道
机器人不会触发未读 mention 数(不被加入 @ 提及统计)
v1.7.90

系统机器人会话

DooTask 内置一组「系统机器人」bot=1 的特殊用户),每个机器人有自己的单聊会话,用来推送特定类型的系统消息。出现在用户的消息列表里,但发送者是机器人而非真人。

定义

  • bot_type=system-msg系统消息默认
  • bot_type=task-alert任务提醒截止 / 分配 / 完成 / 修改)
  • bot_type=todo-alert待办提醒
  • bot_type=check-in签到打卡通知
  • bot_type=approval-alert审批流转通知
  • bot_type=meeting-alert会议通知
  • bot_type=anon-msg匿名消息中转
  • bot_type=okr-alertOKR 推送
  • bot_type=user-auto-xxxxxx用户自定义机器人6-20 字符标识)

关键属性

  • 每个 bot_type 在每个用户处单独建一个单聊会话
  • 推送方式:调用 sendbot 接口或对应业务事件触发
  • 消息为 markdown 文本,最长 2000 字符
  • 机器人消息可被自己撤回(不受 msg_rev_limit 限制)

与普通消息的区别

维度 真人消息 机器人消息
发送者 真实 userid bot=1 的虚拟账号
撤回时限 受 msg_rev_limit 控制 无限制
@ 提醒 计入 mention 统计 不计入

不支持

  • 不支持给机器人单聊发消息(机器人不会回应)
  • 不支持把机器人加入群组
  • 不支持自定义机器人头像 / 替换内置机器人头像