createChatInviteLink

创建群组邀请链接。

请求

POST /:token/createchatinvitelink

参数

参数	类型	必填	描述
chat_id	Integer/String	是	目标聊天的唯一标识符或用户名
name	String	否	链接名称，最多 32 个字符
expire_date	Integer	否	链接过期时间，Unix 时间戳
member_limit	Integer	否	通过该链接可加入的最大成员数，1-99999
creates_join_request	Boolean	否	是否需要管理员审批才能加入

响应

返回创建成功的 ChatInviteLink 对象。

json

{
  "ok": true,
  "result": {
    "invite_link": "https://t.me/+abc123def456",
    "creator": {
      "id": 123456789,
      "is_bot": true,
      "first_name": "MyBot",
      "username": "my_bot"
    },
    "creates_join_request": false,
    "is_primary": false,
    "is_revoked": false,
    "name": "推广链接",
    "expire_date": 1700000000,
    "member_limit": 100,
    "pending_join_request_count": 0
  }
}

返回字段说明

字段	类型	描述
invite_link	String	邀请链接 URL
creator	User	创建该链接的用户对象
creates_join_request	Boolean	是否需要管理员审批
is_primary	Boolean	是否为主邀请链接
is_revoked	Boolean	是否已被撤销
name	String	链接名称
expire_date	Integer	过期时间，Unix 时间戳
member_limit	Integer	最大成员数限制
pending_join_request_count	Integer	待审批的加群请求数量

错误码

错误码	描述
400	请求参数错误，如 member_limit 超出范围
401	Token 无效或已过期
403	Bot 无权在该聊天中创建邀请链接
404	聊天不存在
500	服务器内部错误

createChatInviteLink ​

请求 ​

参数 ​

响应 ​

返回字段说明 ​

错误码 ​

createChatInviteLink

请求

参数

响应

返回字段说明

错误码