QQ频道机器人零基础开发详解(基于QQ官方机器人文档)[第二期]

于 2024-09-09 09:30:00 发布
阅读量637 收藏 7
点赞数 14
分类专栏： QQ机器人开发 文章标签： 机器人
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/qq_71745595/article/details/142031292
版权

QQ频道机器人零基础开发详解(基于QQ官方机器人文档)[第二期]

第二期介绍：频道模块之频道管理

目录

不懂得的也可以来私聊或评论区问哦～
在这里插入图片描述
原力到一千才可以推广，三连啊喂！！！

在这里插入图片描述

获取用户详情

接口

GET /users/@me

功能描述
用于获取当前用户（机器人）详情。

Content-Type

application/json

返回
返回 User 对象。

错误码
详见错误码。

Python示例

# 用于获取当前用户（机器人）详情。
import requests

url = "https://api.sgroup.qq.com/users/@me"
Authorization = f"QQBot {这个内容填写第一期我们获取的调用凭证}"
herders = {
    "Content-Type": "application/json",
    "Authorization": Authorization
        }

response = requests.get(url, headers=herders)

print(response.json())

获取的数据包如下：

{
  "id": "11586990140073229091",
  "username": "gitsub",
  "avatar": "https://thirdqq.qlogo.cn/g?b=oidb&k=M5TibpXicS7Jt4z89BZxiamAA&s=100&t=1641802698",
  "union_openid": "74F138F7F3AF68C4B8E8325013FCA295",
  "union_user_account": ""
}

获取用户频道列表

接口

GET /users/@me/guilds

功能描述
用于获取当前用户（机器人）所加入的频道列表，支持分页。

当 HTTP Authorization 中填入 Bot Token 是获取机器人的数据，填入 Bearer Token 则获取用户的数据。

总的来说就是

Authorization = f"QQBot {这个内容填写第一期我们获取的调用凭证}"

你要获取机器人数据，格式为QQBot {这个内容填写第一期我们获取的调用凭证}，如果获取用户数据，格式为Bearer 调用凭证

Content-Type

application/json

返回
返回 Guild 对象数组。

错误码
详见错误码。

Python示例

import requests

"""
用于获取当前用户（机器人）所加入的频道列表，支持分页。

当 HTTP Authorization 中填入 Bot Token 是获取机器人的数据，填入 Bearer Token 则获取用户的数据。
"""

url = "https://api.sgroup.qq.com/users/@me/guilds"
Authorization = f"QQBot {这个内容填写第一期我们获取的调用凭证}"
headers = {
    "Content-Type": "application/json",
    "Authorization": Authorization
}

response = requests.get(url, headers=headers).json()
print(response)

获取的数据包如下：

[{
    "id": "696527283900292399",
    "name": "鹅们的萌宠啦咔咔啦",
    "icon": "https://groupprohead-76292.picgzc.qpic.cn/482231626508223/100?t=1626508224633",
    "owner_id": "4828365788198541698",
    "owner": false,
    "joined_at": "2021-12-08T16:12:31+08:00",
    "member_count": 17,
    "max_members": 300,
    "description": "123"
}]

🧐这里需要注意，当你有多个频道时，你获取的数据包格式为：

[{你第一个频道的数据},{你第二个频道的数据},{...}]

当你想要获取其中某一个值时，例如 id 的值，可以使用：

response[0]['id']

获取频道详情

接口

GET /guilds/{guild_id}

🧐在获取频道列表的数据包后，数据包内包含了频道的 guild_id

功能描述
用于获取 guild_id 指定的频道的详情。

Content-Type

application/json

返回
返回 Guild 对象

错误码
详见错误码。

Python示例

import requests
"""
用于获取 guild_id 指定的频道的详情。
"""
url = f"https://api.sgroup.qq.com/guilds/{guild_id}"
Authorization = f"QQBot {这个内容填写第一期我们获取的调用凭证}"
herders = {
    "Content-Type": "application/json",
    "Authorization": Authorization
        }

response = requests.get(url, headers=herders).json()
print(response)

获取的数据包如下：

{
  "id": "123456",
  "name": "xxxxxx",
  "icon": "xxxxxx",
  "owner_id": "xxxxxx",
  "owner": false,
  "joined_at": "2022-01-13T11:02:21+08:00",
  "member_count": 5,
  "max_members": 300,
  "description": "千江有水千江月，万里无云万里天"
}

获取子频道列表

接口

GET /guilds/{guild_id}/channels

🧐在获取频道列表的数据包后，数据包内包含了频道的 guild_id

功能描述
用于获取 guild_id 指定的频道下的子频道列表。

Content-Type

application/json

返回
返回 Channel 对象数组。

错误码
详见错误码。

Python示例

import requests

url = f"https://api.sgroup.qq.com/guilds/{guild_id}/channels"
Authorization = f"QQBot {这个内容填写第一期我们获取的调用凭证}"
herders = {
    "Content-Type": "application/json",
    "Authorization": Authorization
        }

response = requests.get(url, headers=herders).json()
print(response)

获取的数据包如下：

[
  {
    "id": "xxxxxx",
    "guild_id": "123456",
    "name": "很高兴遇见你",
    "type": 4,
    "position": 2,
    "parent_id": "0",
    "owner_id": "0",
    "sub_type": 0
  },

  {
    "id": "xxxxxx",
    "guild_id": "123456",
    "name": "🔒管理员议事厅",
    "type": 0,
    "position": 1,
    "parent_id": "xxxxxx",
    "owner_id": "0",
    "sub_type": 0,
    "private_type": 1
  },
  {
    "id": "xxxxxx",
    "guild_id": "123456",
    "name": "🚪小黑屋",
    "type": 0,
    "position": 2,
    "parent_id": "xxxxxx",
    "owner_id": "0",
    "sub_type": 0,
    "private_type": 0
  },
  {
    "id": "xxxxxx",
    "guild_id": "123456",
    "name": "新的子频道",
    "type": 0,
    "position": 2,
    "parent_id": "123456",
    "owner_id": "0",
    "sub_type": 0,
    "private_type": 2
  }
]

🧐这里需要注意，当你有多个子频道时，你获取的数据包格式为：

[{你第一个频道的数据},{你第二个频道的数据},{...}]

当你想要获取其中某一个值时，例如 id 的值，可以使用：

response[0]['id']

获取子频道详情

接口

GET /channels/{channel_id}

🧐在获取子频道列表的数据包后，数据包内包含了频道的 channel_id

功能描述
用于获取 channel_id 指定的子频道的详情。

Content-Type

application/json

返回
返回 Channel 对象。

错误码
详见错误码。

Python示例

import requests

url = f"https://api.sgroup.qq.com/channels/{channel_id}"
Authorization = f"QQBot {这个内容填写第一期我们获取的调用凭证}"
herders = {
    "Content-Type": "application/json",
    "Authorization": Authorization
        }

response = requests.get(url, headers=herders).json()
print(response)

获取的数据包如下：

{
  "id": "123456",
  "guild_id": "xxxxxx",
  "name": "很高兴遇见你",
  "type": 4,
  "position": 2,
  "owner_id": "0",
  "sub_type": 0,
  "private_type": 0,
  "speak_permission": 0,
  "application_id": "0"
}

创建子频道

接口

POST /guilds/{guild_id}/channels

功能描述
用于在 guild_id 指定的频道下创建一个子频道。

  • 要求操作人具有管理频道的权限，如果是机器人，则需要将机器人设置为管理员。
  • 创建成功后，返回创建成功的子频道对象，同时会触发一个频道创建的事件通知。

注意
公域机器人暂不支持申请，仅私域机器人可用，选择私域机器人后默认开通。
注意: 开通后需要先将机器人从频道移除，然后重新添加，方可生效。

Content-Type

application/json

参数

字段名类型描述
namestring子频道名称
typeint子频道类型 ChannelType
sub_typeint子频道子类型 ChannelSubType
positionint子频道排序，必填；当子频道类型为 子频道分组（ChannelType=4） 时，必须大于等于 2
parent_idstring子频道所属分组ID
private_typeint子频道私密类型 PrivateType
private_user_idsstring 数组子频道私密类型成员 ID
speak_permissionint子频道发言权限 SpeakPermission
application_idstring应用类型子频道应用 AppID，仅应用子频道需要该字段

返回
返回 Channel 对象。

错误码
详见错误码。

Python示例

import requests

url = f"https://api.sgroup.qq.com/guilds/{guild_id}/channels"
Authorization = f"QQBot {你自己的鉴权}"

data = {
  "name": "测试频道1",# 名字随意
  "type": 0,# 文字子频道
  "position": 1,
  "parent_id": "xxx",
  "owner_id": "xxx",
  "sub_type": 0,
  "private_type": 0
}

herders = {
    "Content-Type": "application/json",
    "Authorization": Authorization
        }

response = requests.post(url, headers=herders, json=data).json()
print(response)

获取的数据包如下：

{
  "id": "xxxxxx",
  "guild_id": "xxxxxx",
  "name": "测试频道1",
  "type": 0,
  "position": 1,
  "parent_id": "xxxxx",
  "owner_id": "xxxxxx",
  "sub_type": 0
}

修改子频道

接口

PATCH /channels/{channel_id}

🧐在获取子频道列表的数据包后，数据包内包含了频道的 channel_id

功能描述
用于修改 channel_id 指定的子频道的信息。

  • 要求操作人具有管理子频道的权限，如果是机器人，则需要将机器人设置为管理员。
  • 修改成功后，会触发子频道更新事件。

注意
公域机器人暂不支持申请，仅私域机器人可用，选择私域机器人后默认开通。
注意: 开通后需要先将机器人从频道移除，然后重新添加，方可生效。

Content-Type

application/json

参数

字段名类型描述
namestring子频道名
positionint排序
parent_idstring分组 id
private_typeint子频道私密类型 PrivateType
speak_permissionint子频道发言权限 SpeakPermission

🤗需要修改哪个字段，就传递哪个字段即可。

返回
返回 Channel 对象。

错误码
详见错误码。

Python示例

import requests

channel_id = "xxx"
url = f"https://api.sgroup.qq.com/channels/{channel_id}"
Authorization = f"QQBot xxx"

data = {
  "name": "测试频道2",
}


herders = {
    "Content-Type": "application/json",
    "Authorization": Authorization
        }

response = requests.patch(url, headers=herders, json=data).json()
print(response)

获取的数据包如下：

{
  "id": "xxxxxx",
  "guild_id": "xxxxxx",
  "name": "测试频道2",
  "type": 0,
  "position": 1,
  "parent_id": "xxxxx",
  "owner_id": "xxxxxx",
  "sub_type": 0
}

删除子频道

接口

DELETE /channels/{channel_id}

🧐在获取子频道列表的数据包后，数据包内包含了频道的 channel_id

功能描述
用于删除 channel_id 指定的子频道。

  • 要求操作人具有管理子频道的权限，如果是机器人，则需要将机器人设置为管理员。
  • 修改成功后，会触发子频道删除事件。

注意
公域机器人暂不支持申请，仅私域机器人可用，选择私域机器人后默认开通。
注意: 开通后需要先将机器人从频道移除，然后重新添加，方可生效。

Content-Type

application/json

返回
成功返回 HTTP 状态码 200。

错误码
详见错误码。

Python示例

import requests

channel_id = "xxx"
url = f"https://api.sgroup.qq.com/channels/{channel_id}"
Authorization = f"QQBot xxx"

herders = {
    "Content-Type": "application/json",
    "Authorization": Authorization
        }

response = requests.delete(url, headers=herders, json=data).json()
print(response)

注意
子频道的删除是无法撤回的，一旦删除，将无法恢复。

致谢和更新

文章持续更新，如果三连支持，速更！！！
请在评论区提出疑惑和建议
上次更新: 9/8/2024, PM

👻关于频道和子频道事件，它们基于websocket方法。因为目前在讲openapi方法调用QQ频道机器人，所以暂时跳过这部分，当然放心啦，三连我速更，肯定会讲啦。

在这里插入图片描述
⬅️QQ频道机器人零基础开发详解(基于QQ官方机器人文档)[第一期]
➡️第三期：频道模块之频道成员(更新中…)

吃点李子
关注
  • 14
    点赞
  • 踩
  • 7
    收藏
    觉得还不错? 一键收藏
  • 打赏
    打赏
  • 0
    评论
专栏目录
QQ频道机器人零基础开发详解(基于QQ官方机器人文档)[第一期]
qq_71745595的博客
09-08 1214
QQ频道机器人零基础开发详解第一期
2024 年最新使用 Node 搭建QQ开放平台官方 QQ 频道机器人详细教程（更新中）
唤醒手腕
06-15 2441
QQ频道机器人是一种对QQ频道进行功能扩展的程序，通过开放的接口，让开发者能够实现开发出交互形式丰富的机器人，以辅助实现频道/社群内的管理、消息互动，满足频道主或群主运营者多样化、个性化的运营需求，从而提高运营效率，同时为用户带来丰富的服务和便捷的体验。资料提交成功后，即会生成 appid，点击对应的应用即可跳转管理端。
如何基于 Python 快速搭建 QQ 开放平台 QQ 群官方机器人详细教程（更新中）
唤醒手腕
06-13 4800
配置完成后，群主可从沙箱群“设置-群机器人”打开机器人列表页添加测试机器人进行开发调试。部分之前就注册的机器人可能不需要进行配置，但是新注册的机器人在进行腾讯开放平台的提审之前，需要进行 IP 白名单的配置。原机器人的老版本qq-bot仍然可以使用，但新接口的支持上会逐渐暂停，此次升级不会影响线上使用的机器人。QQ 机器人：一个机器人可以被添加到 群聊/频道 内对话，QQ 用户也可以直接跟机器人 单独对话。如需开发在QQ群使用的机器人功能请完成此项配置。注意：每个事件会下发具体的数据对象，如。
2023 版 QQ 机器人运行部署文档
是谢添啊
09-25 3179
QQ机器人框架，登录QQ机器人，消息处理，Linux 服务器持续运行 QQ 机器人，将手机与 linux 服务器处于同一网络，socks5，pbrq，pbbot-rq。问题解决：当前设备网络不稳定或处于夏杂网络环境，为了你的帐号安全，建议将两个设备连接同一网络或将被扫描设备连接你的手机热点后，重新扫码登录。
python开发qq聊天机器人_python3+qqBot+图灵机器人实现qq聊天机器人
weixin_39640221的博客
12-06 2290
原理：通过Python3的qqBot开源库，基于腾讯的smartQQ协议登录个人QQ，实现监控、收集QQ消息，进而通过图灵机器人API接入方式实现自动聊天。零、前期准备：1、Python32、qqBot & requests & re3、申请图灵机器人一、安装Python3的3个库：Windows下打开cmd命令提示符，进入python，尝试import导入一下库。若均已安装，则显...
Python 基于 NoneBot 框架 Centos 云服务器端开发 QQ 机器人基础详细教程（更新中）
唤醒手腕
09-28 1745
官方地址NoneBot2 是一个可扩展的 Python 异步机器人框架，它会对机器人收到的事件进行解析和处理，并以插件化的形式，按优先级分发给事件所对应的事件响应器，来完成具体的功能。除了起到解析事件的作用，NoneBot 还为插件提供了大量实用的预设操作和权限控制机制。对于命令处理，它更是提供了完善且易用的会话机制和内部调用机制，以分别适应命令的连续交互和插件内部功能复用等需求。
Mirai QQ群机器人零基础教程（1）
m0_63754068的博客
06-01 3433
Mirai Console 是一个基于命令行界面的 QQ 机器人控制台，主要用于管理QQ群聊。界面简洁，插件丰富，安装简便。我已经使用了一个多月，但是功能还是很多都没有吃透，这里介绍一下安装方法，如果大家遇到问题可以在下面留言，我看到了会帮忙解决。如果按我的教程一步一步基本不会出问题。 感谢您下载IntelliJ IDEA！使用 IntelliJ IDEA 享受更高效的 Java 和 Kotlin 开发！https://www.jetbrains.com/zh-cn/idea/download/downlo
傻妞教程——对接QQ频道机器人
blog.jichun29.cn
01-02 491
前往傻妞插件市场安装QQ频道机器人插件，基于Node开发。
Mirai QQ群机器人零基础教程（2）
m0_63754068的博客
08-21 789
Mirai QQ群机器人
[于2024/9/5第一次更新] QQ 腾讯官方机器人搭建（更新中）
qq_71745595的博客
08-01 1147
QQ机器人通过开放的平台承载机器人的定制化功能，让开发者获得更畅快的开发体验。
PC9.6.2HIQQ机器人框架源码.zip
10-02
HIQQ机器人框架基于PC协议9.6.2构建，旨在简化QQ机器人的开发流程。该框架包含多种协议，每种协议对应特定的交互场景，如好友聊天、群聊、消息广播等。开发者可以根据需求选择合适的协议，快速实现所需功能。同时，...
基于JavaScript开发的QQ聊天机器人，支持二维码登录，群组讨论，消息派发，HTTP接口，qqbot等+源码+项目开发解析
06-01
基于JavaScript开发的QQ聊天机器人，支持二维码登录，群组讨论，消息派发，HTTP接口，qqbot等+源码+项目开发解析，基于JavaScript开发的QQ聊天机器人，支持二维码登录，群组讨论，消息派发，HTTP接口，qqbot等+源码+...
小白菜QQ云端机器人源码 去除解密授权学习版的原始代码
11-17
小白菜QQ云端机器人源码分享：解密授权学习版已去除 这款源码是专为群机器人爱好者设计的，它基于挂机宝机器人框架构建的网页站点。用户可以通过网页登录QQ账号至挂机宝框架中，无需通过机器人实现登录。而且，该...
基于C++实现QQ空间机器人.zip
03-03
QQ空间机器人是一个利用C++编程语言开发的自动化程序，它能模拟用户行为，对QQ空间中的新动态进行自动监控、评论和回复。这样的程序在社交网络自动化管理、数据分析或者个性化用户体验方面具有一定的应用价值。下面...
QQ频道机器人文档-bot-docs.zip
01-31
总之，QQ频道机器人文档-Bot-docs.zip为你提供了一个全面的指南，帮助你从零开始创建和管理自己的QQ频道机器人，提升频道的互动性和用户体验。无论你是编程新手还是有经验的开发者，这份文档都将是你宝贵的参考资料...
IMU助力JAXA空间站机器人
abcyxjk的博客
09-05 638
近日，日本宇宙航空研究开发机构（JAXA）宣布，在国际空间站（ISS）实验舱“希望号”（Kibo）上部署的一款移动摄像机器人将采用Epson M-G370系列惯性测量单元（IMU）。此次Epson IMU被JAXA选中，不仅彰显了其在航天领域的卓越性能，还为未来空间探索任务提供了可靠的技术保障。Epson M-G370系列IMU凭借其小巧轻便的设计和卓越的精度，成为助力机器人在飞行过程中准确估算空间位置和旋转姿态的理想选择。这些特点使得Epson IMU非常适合在资源有限且要求高性能的空间任务中使用。
【机器人工具箱Robotics Toolbox开发笔记（七）】 创建机器人连杆对象
m0_72676510的博客
09-04 352
在机器人工具箱中，用变量表示机器人的关节类型。其中表示转动关节，表示移动关节（若未指定该参数，默认为转动关节）。在工具箱中，用函数Link（）可以创建一个机器人对象，其中输入的参数顺序分别是关节角、连杆偏距、连杆长度、连杆扭角、关节类型。
用python fastapi写一个http接口，使ros2机器人开始slam toolbox建图
aal779的博客
09-06 464
用python fastapi写一个http接口，使ros2机器人开始slam toolbox建图
【机器人工具箱Robotics Toolbox开发笔记（十）】机器人微分运动学
最新发布
m0_72676510的博客
09-07 207
机器人工具箱中，可用函数SerialLink.jacob0（）求出对应某个位姿下绝对坐标系中的雅可比矩阵，用SerialLink.jacobn（）求出对应某个位姿下工具坐标系中的雅可比矩阵。
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

吃点李子

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付：¥1
获取中
扫码支付

您的余额不足，请更换扫码支付或充值

打赏作者

实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值