如何通过Ejabberd API加入MUC房间成为Occupant以发送消息？

我之前也碰到过类似的问题，Ejabberd的MUC里「房间成员」和「Occupant（实际在场用户）」是完全不同的两个概念：前者是被授权可以加入房间的用户，但只有实际登录并主动加入房间的用户才会被标记为Occupant，这也是你收到报错的核心原因——你的团队成员只是在房间的成员列表里，但并没有实际加入房间。

针对Ejabberd 17.11版本，确实有对应的HTTP API可以解决这个问题，就是join_muc接口，它能让用户主动加入MUC房间，从而被标记为Occupant。下面是具体的使用方法：

1. 调用join_muc HTTP API #

这个接口的作用就是让指定用户加入目标MUC房间，成为在场的Occupant。

请求参数说明 #

你需要发送一个POST请求到Ejabberd的API端点，参数如下：

• user: 要加入房间的用户名（不含域名）
• host: 用户所属的XMPP域名
• room: MUC房间的名称（不含服务域名）
• service: MUC服务的域名（通常是conference.your-domain.com，和你创建房间时的服务一致）
• nick（可选）: 用户在房间内显示的昵称，默认会使用用户名

示例Curl请求 #

curl -X POST http://your-ejabberd-ip:5280/api/join_muc \
  -H "Content-Type: application/json" \
  -d '{
    "user": "arpit",
    "host": "your-domain.com",
    "room": "team-room",
    "service": "conference.your-domain.com",
    "nick": "ArpitVaishnav"
  }'

配置注意事项 #

确保你的Ejabberd已经启用了mod_http_api和mod_muc模块，并且在ejabberd.yml中配置了允许调用join_muc接口的权限，比如：

commands_admin_access: configure
commands:
  - add_commands: [join_muc, get_room_occupants]

2. 验证结果 #

调用完join_muc后，再调用你之前用的get_room_occupants接口，就能看到该用户已经出现在Occupant列表里了。这时候再尝试发送消息，就不会出现「Only occupants are allowed...」的报错了。

额外提示 #

如果需要批量让团队成员加入房间，可以循环调用这个API接口；另外，Ejabberd 17.11的join_muc接口是稳定可用的，虽然版本较老，但适配你的场景完全没问题。

内容的提问来源于stack exchange，提问作者Arpit Vaishnav