如何为钉钉机器人设置自定义头像和名称

文章导读
钉钉机器人能不能换头像和名称,先看它是怎么创建的。自定义机器人创建之后,头像和名称就跟着机器人走了,群里没有二次编辑入口。如果是企业内部应用里的机器人,又得回开发者后台改。不同情况下,处理路径完全不同。
📋 目录
  1. 壹 先确认当前机器人能不能改
  2. 贰 改不动就新建一个机器人
  3. 叁 新建或修改时注意这些坑
  4. 肆 改完怎么验证效果
  5. 伍 不能直接改的场景
A A

钉钉机器人能不能换头像和名称,先看它是怎么创建的。自定义机器人创建之后,头像和名称就跟着机器人走了,群里没有二次编辑入口。如果是企业内部应用里的机器人,又得回开发者后台改。不同情况下,处理路径完全不同。

先确认当前机器人能不能改

钉钉机器人默认头像和名称来自创建时绑定的自建应用或群机器人设置。如果你在群内添加的是自定义机器人,只能通过Webhook的msgtype及at等字段控制消息内容,头像和名称固定为机器人创建时填写的名称和上传的图标。想确认当前是否能改,可以进入群设置-机器人-点击机器人详情,查看是否出现“编辑头像”和“修改名称”入口;如果只有“删除”按钮,则说明该类型机器人不支持直接修改外观。

这里的判断要落在“入口”上。打开群设置,找到机器人详情,如果列表里没有“编辑头像”或“修改名称”这类按钮,就不用在群里继续找了。注意,有些版本的钉钉把入口放在机器人详情页的右上角,如果找不到,可以切换一下钉钉版本再看。通常情况下,如果是自定义机器人,基本只有“删除”按钮,意味着外观改不了。

改不动就新建一个机器人

如果必须更换头像或名称,实际可行的做法是新建一个自定义机器人。进入目标群,依次点击群设置-机器人-添加机器人-自定义,此时可以填写自定义名称并上传本地图片作为头像。创建成功后,把新的Webhook地址替换掉旧地址,并同步修改调用方代码中的URL。旧机器人建议删除,以免消息发到废弃地址。整个过程约5分钟,不影响群内其他成员。

新建机器人时,Webhook地址会重新生成,这个地址通常以 https://oapi.dingtalk.com/robot/send?access_token= 开头。你需要把代码里硬编码的旧URL整个替换掉,不要只改参数。替换后先不要删旧机器人,用新地址发一条测试消息,确认所有服务都能正常推送,再考虑清理旧机器人。如果旧机器人还在被某些定时任务使用,可以先保留,但要在后台标记废弃,避免后续误用。

如何为钉钉机器人设置自定义头像和名称

新建或修改时注意这些坑

常见坑有两个:一是部分用户先删除了旧机器人,再添加新机器人,导致代码里保留的Webhook地址失效,消息一直发送失败;应该先创建新机器人并验证新地址可用,再删除旧机器人。二是上传头像时,图片尺寸过小或比例异常,钉钉会提示“图片不合法”,建议使用500x500像素的方形图片。另外,修改名称不能包含表情符号,且长度限制在20个字符内,超出会被截断。

除了上面提到的两个坑,还要注意头像文件的大小。钉钉对上传图片有硬性限制,格式建议JPG或PNG,大小不超过1MB。如果图片超过这个范围,上传界面会直接拒绝。另一个容易忽略的是名称长度,超过20个字符会被截断,不会报错,但显示出来不完整。所以提前在本地数好字符数,中文和英文都算一个字符。

改完怎么验证效果

修改后应立即用一条测试消息验证效果。可以用curl命令发送一个简单的text消息到新Webhook,例如在命令行执行 curl -X POST -H "Content-Type: application/json" -d '{"msgtype":"text","text":{"content":"头像名称测试"}}' 你的Webhook地址 ,返回{ "errcode": 0, "errmsg": "ok" }即表示成功。随后打开群聊,查看机器人消息右上角的头像和名称是否与设置一致。如果没变化,可能是钉钉客户端缓存,退出群聊重新进入即可。

如何为钉钉机器人设置自定义头像和名称

注意,curl命令里用了单引号包裹JSON,Windows命令行可能需要转义,建议在Linux、macOS或Git Bash里执行。返回的JSON中“errcode”为0才说明推送成功,如果出现“errcode”其他值,比如310000之类的,说明Webhook地址错误或消息内容不符合格式,需要检查access_token和msgtype。

验证的时候,不能只看机器人详情页里的配置,要看实际推送消息上显示的头像和名称。因为详情页可能显示的是创建时的快照,而推送消息才会读取机器人最新的外观设置。如果消息显示的还是旧头像,先退出群聊再进来,或者强制刷新客户端。

不能直接改的场景

如果机器人由企业内部应用创建,群里的自定义机器人路径就不适用。此时需要登录钉钉开发者后台,找到对应的应用,在“机器人”配置中修改名称和头像。修改后要重新发布应用,新版本上线后群聊里的机器人外观才会更新。这个过程中,Webhook地址会保持不变,所以已部署的推送代码不用动,但调用方可能会在发布后短暂看到新老名称交替显示。

还有一种容易被忽略的情况:同一个机器人被添加到了多个群。在群设置里修改的是“当前群”的机器人配置,还是所有群通用?如果你修改的是自定义机器人,它本身是每个群单独创建的,所以只影响当前群;如果是应用机器人,修改的是全局配置,所有引用这个应用的群都会一起变化。动手之前,先确认自己需要改动的是单个群还是全部群。