使用@twilio/conversations添加参与者时遭遇Forbidden错误

问题描述 #

在NextJS + React应用中使用@twilio/conversations库，通过Access Token成功连接Client后，可正常获取参与者、会话、用户等信息，但调用Conversation的add方法添加其他用户时，始终返回Forbidden错误。

相关代码：

import { Client } from "@twilio/conversations"

const client = new Client(token)

// 获取会话并尝试添加参与者
const conversation = await client.getConversationByUniqueName(conversationUniqueName)
const res = await conversation.add(userIdentity)

错误信息：

Uncaught (in promise) Error: Forbidden
    at Upstream._callee$ (browser.js?5550:2968:1)
    at tryCatch (regeneratorRuntime.js?6f37:86:1)
    at Generator.eval [as _invoke] (regeneratorRuntime.js?6f37:66:1)
    at Generator.eval [as next] (regeneratorRuntime.js?6f37:117:1)
    at asyncGeneratorStep (asyncToGenerator.js?8e4b:3:1)
    at _next (asyncToGenerator.js?8e4b:25:1)

解决方案 #

1. 确认Access Token的权限配置 #

生成Access Token时，必须为Chat Grant指定addParticipant权限，否则即使是会话成员也无法添加其他参与者。示例配置如下：

const { AccessToken, ChatGrant } = require('twilio').jwt;

const chatGrant = new ChatGrant({
  serviceSid: '你的Chat Service SID',
  permissions: ['addParticipant', 'viewConversation', 'sendMessage'] // 必须包含addParticipant
});

const token = new AccessToken(
  '你的Account SID',
  '你的API Key',
  '你的API Secret',
  { identity: '当前用户标识', grants: [chatGrant] }
);

2. 检查Twilio控制台的会话权限设置 #

• 登录Twilio控制台，进入对应的Chat Service页面
• 查看会话的角色权限配置，确保当前用户所属的角色拥有addParticipant权限
• 若为私有会话，只有会话创建者或管理员角色才能添加参与者，普通成员无此权限

3. 验证目标用户标识的有效性 #

确认传入conversation.add()的userIdentity是Twilio系统中已注册的有效用户标识，且该用户未被限制访问相关服务。

4. 排查SDK版本兼容性 #

当前使用的是2.1.0版本的@twilio/conversations，建议升级至最新稳定版，或检查该版本是否存在已知的权限相关bug，必要时回退到兼容版本。

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