Rocket.Chat 技能

开源团队聊天平台，用于沟通与协作。

概览

Rocket.Chat 支持：

• 频道（公开/私有）、直接消息（DM）、消息线程（threads）
• 用户与角色管理
• 集成能力（Webhook、机器人）
• 联邦（Federation）与全渠道（Omnichannel）

三种房间类型：频道（channels.*）、群组/私有群（groups.*）、直接消息（im.*）。通用的 chat.* 接口通过 roomId 参数在所有类型中统一工作。

API 认证

# 基于请求头的认证
curl -s 
  -H "X-Auth-Token: $RC_TOKEN" 
  -H "X-User-Id: $RC_USER_ID" 
  "$RC_URL/api/v1/me"

# 通过登录获取 token
curl -s -X POST 
  -H "Content-Type: application/json" 
  -d '{"user":"username","password":"password"}' 
  "$RC_URL/api/v1/login" | jq '{userId: .data.userId, authToken: .data.authToken}'

关键标识符

• roomId — 房间标识符（例如：GENERAL、ByehQjC44FwMeiLbX）
• msgId — 字母数字组成的消息 ID（不同于 Slack，不是时间戳）
• emoji — Emoji 名称，不带冒号（例如：thumbsup、white_check_mark）

消息上下文行中包含 rocketchat message id 和 room 字段 — 可直接复用这些字段。

频道

# 列出频道
curl -s -H "X-Auth-Token: $RC_TOKEN" -H "X-User-Id: $RC_USER_ID" 
  "$RC_URL/api/v1/channels.list?count=50"

# 获取频道信息
curl -s -H "X-Auth-Token: $RC_TOKEN" -H "X-User-Id: $RC_USER_ID" 
  "$RC_URL/api/v1/channels.info?roomId=ROOM_ID"

# 获取频道历史消息
curl -s -H "X-Auth-Token: $RC_TOKEN" -H "X-User-Id: $RC_USER_ID" 
  "$RC_URL/api/v1/channels.history?roomId=ROOM_ID&count=50"

# 创建频道
curl -s -X POST -H "X-Auth-Token: $RC_TOKEN" -H "X-User-Id: $RC_USER_ID" 
  -H "Content-Type: application/json" 
  -d '{"name":"new-channel","members":["user1"]}' 
  "$RC_URL/api/v1/channels.create"

# 归档频道
curl -s -X POST -H "X-Auth-Token: $RC_TOKEN" -H "X-User-Id: $RC_USER_ID" 
  -H "Content-Type: application/json" 
  -d '{"roomId":"ROOM_ID"}' 
  "$RC_URL/api/v1/channels.archive"

# 设置频道主题（topic）
curl -s -X POST -H "X-Auth-Token: $RC_TOKEN" -H "X-User-Id: $RC_USER_ID" 
  -H "Content-Type: application/json" 
  -d '{"roomId":"ROOM_ID","topic":"Weekly standup notes"}' 
  "$RC_URL/api/v1/channels.setTopic"

# 列出频道成员
curl -s -H "X-Auth-Token: $RC_TOKEN" -H "X-User-Id: $RC_USER_ID" 
  "$RC_URL/api/v1/channels.members?roomId=ROOM_ID&count=50"

对于私有群组，请使用 groups.*；对于直接消息，请使用 im.*。查询参数保持一致。

消息

# 发送消息（简易方式）
curl -s -X POST -H "X-Auth-Token: $RC_TOKEN" -H "X-User-Id: $RC_USER_ID" 
  -H "Content-Type: application/json" 
  -d '{"channel":"#general","text":"Hello!"}' 
  "$RC_URL/api/v1/chat.postMessage"

channel 参数支持以下格式：#channel-name（频道名）、@username（发送 DM）、或直接传入 roomId。

# 发送消息（高级方式 — 自定义 _id、alias、avatar）
curl -s -X POST -H "X-Auth-Token: $RC_TOKEN" -H "X-User-Id: $RC_USER_ID" 
  -H "Content-Type: application/json" 
  -d '{"message":{"rid":"ROOM_ID","msg":"Hello from Clawdbot"}}' 
  "$RC_URL/api/v1/chat.sendMessage"

# 读取最近消息
curl -s -H "X-Auth-Token: $RC_TOKEN" -H "X-User-Id: $RC_USER_ID" 
  "$RC_URL/api/v1/channels.messages?roomId=ROOM_ID&count=20"

# 编辑消息
curl -s -X POST -H "X-Auth-Token: $RC_TOKEN" -H "X-User-Id: $RC_USER_ID" 
  -H "Content-Type: application/json" 
  -d '{"roomId":"ROOM_ID","msgId":"MSG_ID","text":"Updated text"}' 
  "$RC_URL/api/v1/chat.update"

# 删除消息
curl -s -X POST -H "X-Auth-Token: $RC_TOKEN" -H "X-User-Id: $RC_USER_ID" 
  -H "Content-Type: application/json" 
  -d '{"roomId":"ROOM_ID","msgId":"MSG_ID"}' 
  "$RC_URL/api/v1/chat.delete"

# 搜索消息
curl -s -H "X-Auth-Token: $RC_TOKEN" -H "X-User-Id: $RC_USER_ID" 
  "$RC_URL/api/v1/chat.search?roomId=ROOM_ID&searchText=keyword"

# 对消息添加反应（toggle 模式 — 再次调用将移除该反应）
curl -s -X POST -H "X-Auth-Token: $RC_TOKEN" -H "X-User-Id: $RC_USER_ID" 
  -H "Content-Type: application/json" 
  -d '{"messageId":"MSG_ID","emoji":"thumbsup"}' 
  "$RC_URL/api/v1/chat.react"

# 获取单条消息（返回结果中 message.reactions 字段包含所有反应）
curl -s -H "X-Auth-Token: $RC_TOKEN" -H "X-User-Id: $RC_USER_ID" 
  "$RC_URL/api/v1/chat.getMessage?msgId=MSG_ID"

置顶消息（Pins）

# 置顶消息
curl -s -X POST -H "X-Auth-Token: $RC_TOKEN" -H "X-User-Id: $RC_USER_ID" 
  -H "Content-Type: application/json" 
  -d '{"messageId":"MSG_ID"}' 
  "$RC_URL/api/v1/chat.pinMessage"

# 取消置顶消息
curl -s -X POST -H "X-Auth-Token: $RC_TOKEN" -H "X-User-Id: $RC_USER_ID" 
  -H "Content-Type: application/json" 
  -d '{"messageId":"MSG_ID"}' 
  "$RC_URL/api/v1/chat.unPinMessage"

# 列出已置顶消息（query 参数需 URL 编码为 {"pinned":true}）
curl -s -H "X-Auth-Token: $RC_TOKEN" -H "X-User-Id: $RC_USER_ID" 
  "$RC_URL/api/v1/channels.messages?roomId=ROOM_ID&query=%7B%22pinned%22%3Atrue%7D"

用户

# 列出用户
curl -s -H "X-Auth-Token: $RC_TOKEN" -H "X-User-Id: $RC_USER_ID" 
  "$RC_URL/api/v1/users.list"

# 获取用户信息（按 username 或 userId 查询）
curl -s -H "X-Auth-Token: $RC_TOKEN" -H "X-User-Id: $RC_USER_ID" 
  "$RC_URL/api/v1/users.info?username=john"

curl -s -H "X-Auth-Token: $RC_TOKEN" -H "X-User-Id: $RC_USER_ID" 
  "$RC_URL/api/v1/users.info?userId=USER_ID"

# 创建用户（仅管理员可用）
curl -s -X POST -H "X-Auth-Token: $RC_TOKEN" -H "X-User-Id: $RC_USER_ID" 
  -H "Content-Type: application/json" 
  -d '{"email":"user@example.com","name":"John","username":"john","password":"pass123"}' 
  "$RC_URL/api/v1/users.create"

# 设置用户状态
curl -s -X POST -H "X-Auth-Token: $RC_TOKEN" -H "X-User-Id: $RC_USER_ID" 
  -H "Content-Type: application/json" 
  -d '{"message":"In a meeting","status":"busy"}' 
  "$RC_URL/api/v1/users.setStatus"

Emoji

# 列出自定义 Emoji
curl -s -H "X-Auth-Token: $RC_TOKEN" -H "X-User-Id: $RC_USER_ID" 
  "$RC_URL/api/v1/emoji-custom.list"

集成

# 列出 Webhook
curl -s -H "X-Auth-Token: $RC_TOKEN" -H "X-User-Id: $RC_USER_ID" 
  "$RC_URL/api/v1/integrations.list?type=webhook-incoming"

# 使用入站 Webhook（无需认证）
curl -s -X POST 
  -H "Content-Type: application/json" 
  -d '{"text":"Alert from external system!"}' 
  "$RC_URL/hooks/WEBHOOK_ID/WEBHOOK_TOKEN"

统计信息

# 服务器统计信息
curl -s -H "X-Auth-Token: $RC_TOKEN" -H "X-User-Id: $RC_USER_ID" 
  "$RC_URL/api/v1/statistics"

速率限制

默认限制：每个用户每秒最多 20 次请求。可通过响应头检查：X-RateLimit-Limit、X-RateLimit-Remaining。

可尝试的想法

• 使用 white_check_mark 表情对已完成任务进行标记
• 置顶关键决策或每周状态更新
• 提问前先搜索历史消息，查找过往讨论
• 为不同项目创建专属频道，并设置清晰的主题（topic）
• 通过 chat.postMessage 向用户发送 DM，指定 "channel": "@username"
• 利用入站 Webhook 向 Rocket.Chat 推送外部系统告警，无需认证

完整文档请参阅 Rocket.Chat API 文档。