开发Webhook如何获取域内用户USER_ID以实现@提及功能？

算力阿峰

2026-5-20

获取域内用户USER_ID的实用方法

刚好碰到过类似的需求，给你分享几个靠谱的方法——毕竟你不是机器人，没法从发送者字段拿ID，这些方法专门针对域内用户：

从平台管理后台直接查找/导出
大部分支持Webhook的企业协作平台（比如内部聊天、协作工具），管理员后台都有用户管理板块。登录后台后，找到目标用户的详情页，一般都会显示对应的USER_ID（可能叫“内部用户ID”“系统用户ID”）。如果需要批量获取，很多平台支持导出域内所有用户的清单，导出的CSV或JSON文件里会包含ID、邮箱、用户名这些信息，直接筛选就行。
调用平台的用户API接口
如果你有平台的API访问权限（通常需要管理员生成的API密钥或令牌），可以调用官方提供的用户列表接口。比如常见的GET /api/v1/users这类接口，返回的响应里会包含每个用户的完整信息，其中就有你要的USER_ID。写个简单的Python或Shell脚本请求一下，就能批量提取出需要的ID了。
通过用户唯一标识精准查询
要是你知道用户的邮箱、用户名这类唯一信息，很多平台支持通过这些参数查询单个用户的ID。比如调用GET /api/v1/users?email=john@yourdomain.com或者GET /api/v1/users?username=john_doe，接口会直接返回该用户的详情，里面就有USER_ID。这种方法比查整个列表更高效，适合单个用户的情况。
临时发送测试消息解析ID
有些平台允许Webhook发送@用户名的消息，发送后你可以查看消息的原始数据（一般在消息的“查看详情”或“原始内容”选项里），系统会把@用户名转换成<users/USER_ID>的格式，这样就能直接拿到对应的ID了。不过这个方法得看平台是否支持，而且需要你有发送测试消息的权限。