创建群组频道

创建用于一对一或一对多对话的群组频道，默认支持最多 100 名成员，超级群组（Supergroup）可扩展至数万名。频道可为私密（仅受邀加入）或公开，并支持输入指示、未读计数与已读回执；单个用户最多可加入 2,000 个群组频道。

通过官方 Sendbird Chat Platform API v3 管理用户、群组频道、开放频道、消息、元数据、审核、机器人与公告。完整边界为固定官方生成 SDK revision 重建的 83 个 REST Endpoint；客户端实时协议与 Chat SDK 不在本集合内。应用数据为调用方私有内容，Pontx 不代理、缓存或聚合，调用方使用本地 SDK/CLI 直连。

请求

operationId: createAGroupChannel
服务器: https://api-{app_id}.sendbird.com
认证: apiTokenAuth

请求参数

无 URL、查询或 Header 参数。

Body 参数

CreateAGroupChannelRequest

字段: access_codeblock_sdk_user_channel_joinchannel_urlcover_filecover_urlcustom_typedatahidden_statusinvitation_statusinviter_idis_distinctis_ephemeralis_publicis_supernameoperator_idsstrictuser_idsusers

响应

`200`

SendbirdGroupChannelDetailapplication/json

请求成功。

字段: channelchannel_urlcover_urlcreated_atcreated_bycustom_typedatadelivery_receiptdisappearing_messagefreezehas_ai_bothas_botidignore_profanity_filteris_access_code_requiredis_broadcastis_discoverableis_distinctis_ephemeralis_publicis_superjoined_member_countlast_messagemax_length_messagemember_countmembersmessage_survival_secondsnameoperatorsread_receiptsms_fallbackunread_mention_countunread_message_count

`400`

SendbirdApiErrorapplication/json

请求参数无效。

字段: codemessage

`401`

SendbirdApiErrorapplication/json

未认证或 API 令牌无效。

字段: codemessage

`403`

SendbirdApiErrorapplication/json

无权限访问该资源。

字段: codemessage

`404`

SendbirdApiErrorapplication/json

未找到指定资源。

字段: codemessage

`429`

SendbirdApiErrorapplication/json

请求频率超限，请稍后重试。

字段: codemessage

`500`

SendbirdApiErrorapplication/json

上游服务内部错误。

字段: codemessage

{
  "channel_url": "group_channel_123",
  "cover_url": "https://example.com/avatar.png",
  "created_at": 1,
  "created_by": {
    "is_active": true,
    "is_blocked_by_me": true,
    "nickname": "Alice",
    "profile_url": "https://example.com/avatar.png",
    "require_auth_for_profile_image": true,
    "role": "none",
    "user_id": "user_id_123"
  },
  "custom_type": "default",
  "data": "{\"key\":\"value\"}",
  "delivery_receipt": {}
}