使用Slack API添加多频道访客至频道时遇user_is_restricted错误

我们使用Slack专业版，通过Python调用Slack API的conversations.invite接口向频道添加用户。目前添加普通成员正常，但添加**Multi-Channel Guests（多频道访客）**时，API返回错误：

'error': 'user_is_restricted'

手动操作可将该类访客添加至目标频道，不清楚问题原因。目标频道详情如下：

{'ok': True, 'channel': {'id': 'xxxxx', 'name': 'xxxx', 'is_channel': True, 'is_group': False, 'is_im': False, 'is_mpim': False, 'is_private': False, 'created': 1679535429, 'is_archived': False, 'is_general': False, 'unlinked': 0, 'name_normalized': 'ar001_dely', 'is_shared': False, 'is_org_shared': False, 'is_pending_ext_shared': False, 'pending_shared': [], 'context_team_id': 'T0XRJN529', 'updated': 1679535429777, 'parent_conversation': None, 'creator': 'xxxxx', 'is_ext_shared': False, 'shared_team_ids': ['xxxx'], 'pending_connected_team_ids': [], 'is_member': True, 'last_read': '0000000000.000000', 'topic': {'value': 'xx', 'creator': 'xxxx', 'last_set': 1679535429}, 'purpose': {'value': 'xxx', 'creator': 'xxxx', 'last_set': 1679535429}, 'previous_names': []}}

可能的原因与解决方法 #

• API权限不足：手动操作使用的账号权限充足，但调用API的Token可能缺失权限。检查Token是否包含channels:write.invites（公开频道）或groups:write.invites（私有频道）权限，同时需要users:read权限识别用户类型、team:read权限确认团队配置。
• Bot Token限制：Bot账号处理访客用户时可能存在权限限制，尝试替换为具备管理员权限的User Token调用接口。示例代码：

  import requests
  
  url = "https://slack.com/api/conversations.invite"
  headers = {"Authorization": "Bearer YOUR_USER_TOKEN"}
  payload = {
      "channel": "CHANNEL_ID",
      "users": "MULTI_CHANNEL_GUEST_USER_ID"
  }
  
  response = requests.post(url, headers=headers, data=payload)
  print(response.json())
  

• 团队配置限制：确认团队设置中是否允许多频道访客加入当前类型的频道，避免配置层面的权限拦截。
• 访客账号状态：检查该多频道访客账号是否处于活跃状态，未被限制或暂停，且属于当前团队的有效访客用户。

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