选择应用类型
第三方企业应用开发
学习地图
动态与公告
应用开发平台简介(新版)
应用开发平台简介
开发应用(新版)
开发应用流程
获取开发者权限
创建应用
添加应用能力
配置应用
开发 AI 应用
开发小程序应用
开发网页应用
开发酷应用
开发机器人应用
概述
企业机器人
机器人接收消息
机器人回复/发送消息
Webhook 机器人
监控应用
部署应用
发布应用
(可选)测试应用
自检应用
安全运营
开发应用
服务端API
客户端API
AppLink协议
事件订阅
常见问题
运营规范
历史文档

机器人接收消息

更新于 2023-10-13如果你需要开发机器人接收消息,你可以依据本文档操作步骤完成机器人接收消息服务端的开发。

前提条件

  1. 需要完成创建应用流程。

  2. 需要完成添加应用能力流程

操作步骤

  1. Java 开发环境准备:

    • 运行环境:JDK 1.7 及以上

  2. 服务端接入示例:

    Loading...

    此时你可以启用服务,为后续调试准备。

  3. 登录开发者后台,单击目标应用,进入应用详情页。

  4. 调试机器人功能,单击应用能力 > 机器人。开启机器人配置,配置机器人信息。

    配置项

    必填

    填写规范

    机器人名称

    请使用意图正确、文明的词汇,避免歧义、错别字及不合规词汇。

    机器人图标

    建议大小为 240*240px,请使用清晰的图片,图片核心内容居中。尽量避免尺寸过小、过大或者内容不合规图片。默认使用应用图标。

    机器人简介

    简要描述机器人信息,最多10个字符,该描述将在群内添加机器人时向用户进行展示。

    机器人描述

    描述机器人功能,最多200字符,该描述将在机器人名片信息和群内添加机器人时向用户进行展示。

    机器人消息预览图

    上传机器人消息预览图片,图片格式必须为:png、jpeg、jpg,不超过2M,可修改。

    消息接收地址

    填写一个公网可访问的本企业HTTPS服务地址,用于接收钉钉推送的POST消息。

  5. 配置完成后,单击发布

更多信息

当应用发布上架后,在群内@机器人发送消息时,此时服务端会收到消息内容。例如,当你@机器人发送“你好”,接收消息格式如下:

Loading...

参数名称

说明

conversationId

会话 ID。

atUsers

被@人的信息:

  • dingtalkId:加密的发送者 ID。

  • staffId:当前企业内部群中员工 userId 值。

chatbotCorpId

机器人所在的企业corpId。

chatbotUserId

加密的机器人ID,暂无使用场景,可忽略。

msgId

加密的消息 ID,暂无使用场景,可忽略。

senderNick

发送者昵称。

isAdmin

是否为管理员。

senderStaffId

企业内部群中@该机器人的用户 ID。

sessionWebhookExpiredTime

当前会话的 Webhook 地址过期时间。

createAt

消息的时间戳,单位毫秒。

senderCorpId

企业内部群有的发送者当前群的企业 corpId。

conversationType

会话类型:

  • 1:单聊

  • 2:群聊

senderId

加密的发送者 ID。

说明

使用 senderStaffId,为发送者 userId 值。

conversationTitle

群聊时才有的会话标题。

isInAtList

是否在@列表中。

sessionWebhook

当前会话的 Webhook 地址。

content

消息文本。

msgtype

消息类型。

后续步骤

机器人接收消息开发完成后,可以进行消息回复或发送消息,你可以继续以下操作:

如果你需要测试接收消息能力,需要进行测试应用

这篇文档是否有帮助?
点击纠错