机器人接收消息
更新于 2023-10-13如果你需要开发机器人接收消息,你可以依据本文档操作步骤完成机器人接收消息服务端的开发。
前提条件
操作步骤
Java 开发环境准备:
运行环境:JDK 1.7 及以上
服务端接入示例:
Loading...此时你可以启用服务,为后续调试准备。
登录开发者后台,单击目标应用,进入应用详情页。
调试机器人功能,单击应用能力 > 机器人。开启机器人配置,配置机器人信息。
配置项
必填
填写规范
机器人名称
是
请使用意图正确、文明的词汇,避免歧义、错别字及不合规词汇。
机器人图标
是
建议大小为 240*240px,请使用清晰的图片,图片核心内容居中。尽量避免尺寸过小、过大或者内容不合规图片。默认使用应用图标。
机器人简介
是
简要描述机器人信息,最多10个字符,该描述将在群内添加机器人时向用户进行展示。
机器人描述
是
描述机器人功能,最多200字符,该描述将在机器人名片信息和群内添加机器人时向用户进行展示。
机器人消息预览图
是
上传机器人消息预览图片,图片格式必须为:png、jpeg、jpg,不超过2M,可修改。
消息接收地址
否
填写一个公网可访问的本企业HTTPS服务地址,用于接收钉钉推送的POST消息。
配置完成后,单击发布。
更多信息
当应用发布上架后,在群内@机器人发送消息时,此时服务端会收到消息内容。例如,当你@机器人发送“你好”,接收消息格式如下:
参数名称 | 说明 |
conversationId | 会话 ID。 |
atUsers | 被@人的信息:
|
chatbotCorpId | 机器人所在的企业corpId。 |
chatbotUserId | 加密的机器人ID,暂无使用场景,可忽略。 |
msgId | 加密的消息 ID,暂无使用场景,可忽略。 |
senderNick | 发送者昵称。 |
isAdmin | 是否为管理员。 |
senderStaffId | 企业内部群中@该机器人的用户 ID。 |
sessionWebhookExpiredTime | 当前会话的 Webhook 地址过期时间。 |
createAt | 消息的时间戳,单位毫秒。 |
senderCorpId | 企业内部群有的发送者当前群的企业 corpId。 |
conversationType | 会话类型:
|
senderId | 加密的发送者 ID。 说明 使用 senderStaffId,为发送者 userId 值。 |
conversationTitle | 群聊时才有的会话标题。 |
isInAtList | 是否在@列表中。 |
sessionWebhook | 当前会话的 Webhook 地址。 |
content | 消息文本。 |
msgtype | 消息类型。 |
后续步骤
机器人接收消息开发完成后,可以进行消息回复或发送消息,你可以继续以下操作:
如果你需要测试接收消息能力,需要进行测试应用。