当前位置：网站首页 > 云服务教程 > 正文

2023 年最新 QQ 开放平台官方企业 QQ 群机器人新特性超详细教程（更新中）

云服务教程 来源： 网络 编辑：小编 更新时间：2024-11-24 22:09:09 浏览量：61

注册 开放平台账号

开放平台是腾讯应用综合开放类平台，包含 机器人、 小程序、 小游戏 等集成化管理，也就是说你注册了 开放平台，你开发 机器人还是 小程序都是在这个平台进行部署上线和管理。

在这里插入图片描述
如何注册 开放平台账号？点击首页右上角【立即注册】

注意主体的选择，当然无论是企业还是个人，都是可以开发 小程序 或者 机器人 的，但是如果您是个人主体的话，那么你的权限将有所局限，因为部分服务权限是需要企业主体的。

企业主体入驻开发者默认支持频道、群场景开发能力；个人主体入驻开发者默认仅支持频道场景开发能力。除默认开通的能力外，后续其他接口能力申请上，企业开发者与个人开发者也存在差异。

在这里插入图片描述

温馨提示：姓名和身份证号码务必与手机号码对应运营商实名登记的信息一致，否则会提示错误。

创建 机器人

注册完成后登陆开放平台！在机器人分栏点击【创建机器人】
在这里插入图片描述
填写 机器人资料信息（名称、头像、介绍）

在这里插入图片描述
机器人管理端后台

资料提交成功后，即会生成 appid，点击对应的应用即可跳转管理端。

在这里插入图片描述
机器人类型 和 测试频道 / 群 配置

机器人类型 包含 私域机器人或者 公域机器人。当然公域机器人对于服务器的要求过高，我们这边也可以选择私域机器人进行开发。特别注意在选择沙箱测试频道的时候，你必须提前创建个沙箱测试频道，必须＜20人的频道。但是选择沙箱测试 群则需要您是企业资质。

沙箱频道仅可设置当前用户为频道主/管理员的频道、沙箱群仅可设置当前用户为群主/群管理员的群，且沙箱频道成员、沙箱群成员不可大于20人。

在这里插入图片描述

在沙箱配置页面不同类型开发者支持开发不同场景机器人功能

建议开发者根据实际的需要，选择在不同场景开发机器人，完成对应场景的沙箱环境配置。配置沙箱后，开发者可在「功能配置」、「使用范围与人员」页面解锁相应场景的配置能力。

认证身份 频道 消息列表单聊
企业开发者 ✅ ✅ 申请后可开发
个人开发者 ✅ 暂不开放 暂不开放

配置沙箱 群 / 频道，需要先在客户端创建符合沙箱要求的/频道。在频道场景，机器人仍然保留「公域」/「私域」机器人的区分，设置为公域机器人保存确认后不可切换为私域机器人，但在「使用范围与人员」可设置公域机器人的允许添加范围：“全部用户可添加”/“仅白名单用户可添加”。配置沙箱频道/群后，机器人会出现在沙箱频道/沙箱群的机器人列表当中。

查看 机器人设置

Token 和 AppSecret

请妥善保管 机器人令牌 Token（用于以机器人身份调用 openapi） 和 机器人密钥 AppSecret （用于在 oauth 场景进行请求签名的密钥）

在这里插入图片描述
消息 URL 配置

机器人发送的消息中包含的 URL 必须先在这里设置，消息才可以下发生效。域名需经过ICP备案，新备案域名 24 小时后才可以配置，请下载校验文件，并将文件放置在域名根目录下，并确保可访问该文件。

在这里插入图片描述

频道用户意见反馈

为了帮助开发者获取 C 端用户对于机器人的评价与反馈，平台在频道场景为开发者接入了"兔小巢反馈空间"，开发者可以通过创建产品反馈空间。

在这里插入图片描述

频道用户意见反馈： 点击进入登陆后，根据提示创建产品，将会获得一个兔小巢反馈空间，C 端用户所填写的机器人反馈将同步至此空间，开发者以后可登陆此空间查看用户反馈。

产品 ID 填写： 需要在此处填写兔小巢反馈空间的产品 ID，C 端用户的机器人反馈才可同步至此处，详细获取路径如开发者端提示：设置 > 产品设置 > 产品 ID。

机器人 SDK

SDK 链接地址
Node.Js SDK 文档 https://bot.q..com/wiki/develop/nodesdk/
Python SDK 文档 https://bot.q..com/wiki/develop/pythonsdk/
GoLang SDK 文档 https://bot.q..com/wiki/develop/gosdk/

安装 机器人 Node.Js SDK

npm i -guild-bot # 或者使用yarn yarn add -guild-bot # 国内安装可以使用腾讯源 npm i -guild-bot --registry=https://mirrors.tencent.com/npm/

配置 .env：在根目录创建 .env 环境变量配置文件

appID= token=你的token AppSecret=你的AppSecret

-guild-sdk 更新

打开 node_modules > -guild-sdk

因为 -guild-sdk 不支持 群消息监听处理，需要使用调整后的 -guild-sdk 新的 Node 模块包，同学们点击下载之后，把原先的 -guild-sdk 模块包整个进行替换即可。

调整后 -guild-sdk Node 模块包：下载地址

websocket 监听

机器人 创建 WS 实例并监听消息

import { 
    createWebsocket } from '-guild-bot'; const ws = createWebsocket(testConfigWs); ws.on('READY', data => { 
    console.log('[READY] 事件接收 :', data); }); ws.on('ERROR', data => { 
    console.log('[ERROR] 事件接收 :', data); }); ws.on('GUILDS', data => { 
    console.log('[GUILDS] 事件接收 :', data); }); ws.on('GUILD_MEMBERS', data => { 
    console.log('[GUILD_MEMBERS] 事件接收 :', data); }); ws.on('GUILD_MESSAGES', data => { 
    console.log('[GUILD_MESSAGES] 事件接收 :', data); }); ws.on('GUILD_MESSAGE_REACTIONS', data => { 
    console.log('[GUILD_MESSAGE_REACTIONS] 事件接收 :', data); }); ws.on('DIRECT_MESSAGE', data => { 
    console.log('[DIRECT_MESSAGE] 事件接收 :', data); }); ws.on('INTERACTION', data => { 
    console.log('[INTERACTION] 事件接收 :', data); }); ws.on('MESSAGE_AUDIT', data => { 
    console.log('[MESSAGE_AUDIT] 事件接收 :', data); }); ws.on('FORUMS_EVENT', data => { 
    console.log('[FORUMS_EVENT] 事件接收 :', data); }); ws.on('AUDIO_ACTION', data => { 
    console.log('[AUDIO_ACTION] 事件接收 :', data); }); ws.on('PUBLIC_GUILD_MESSAGES', data => { 
    console.log('[PUBLIC_GUILD_MESSAGES] 事件接收 :', data); });

监听 群消息

const { 
    createOpenAPI, createWebsocket } = require('-guild-bot'); const { 
    config } = require("dotenv") config() const testConfig = { 
    appID: process.env.appID, token: process.env.token, shards: [0, 1], intents: ['PUBLIC_GUILD_MESSAGES', 'GROUPS'], sandbox: false, }; const client = createOpenAPI(testConfig); const ws = createWebsocket(testConfig); ws.on('GROUPS', data => { 
    console.log('Gourp messgae:', data); });

配置说明

参数 说明 类型
appID 机器人 ID（ 开放平台机器人管理端获得） String
token 机器人身份调用 openapi（ 开放平台机器人管理端获得） String
shards 配置 机器人分布式部署 [集群编号, 集群数量] Array
intents 机器人事件类型订阅 Array
sandbox 机器人是否开启沙箱测试 Boolean

intents 可选值举例：[‘GUILDS’, ‘GUILD_MEMBERS’, ‘GUILD_MESSAGES’,‘GUILD_MESSAGE_REACTIONS’,‘DIRECT_MESSAGE’, ‘INTERACTION’,‘MESSAGE_AUDIT’,‘FORUMS_EVENT’,‘AUDIO_ACTION’, ‘PUBLIC_GUILD_MESSAGES’]

事件类型的订阅，是有权限控制的，除了 GUILDS，PUBLIC_GUILD_MESSAGES，DIRECT_MESSAGE，GUILD_MEMBERS 事件是基础的事件，默认有权限订阅之外，其他的特殊事件，都需要经过申请才能够使用，如果在鉴权的时候传递了无权限的 intents，websocket 会报错，并直接关闭连接。

特别注意：intents传空数组时，将默认开启全部事件类型的监听。

群消息 group message

Gourp messgae: { 
    eventType: 'GROUP_AT_MESSAGE_CREATE', eventId: 'GROUP_AT_MESSAGE_CREATE:h2wlsxge4luozgoigwumbriafsda7kdjiuwpmwrrlxqkgxwpynhysl6q6ws849', msg: { 
    author: { 
    id: 'E2976DBFBB2EDA36DF1', member_openid: 'E2976DBFBB2EDA36DF1' }, content: ' 测试', group_id: 'A85B11B27A39FB0C238B0F19FA09DDF7', group_openid: 'A85B11B27A39FB0C238B0F19FA09DDF7', id: 'ROBOT1.0_h2WlSxGE4lUOz.gOiGwumPXNIo3bQDNfDUL9B6RR64rOz1lFtaet2maxZIYEGiAlunES0n.7u0HtihQXiTG9mw!!', timestamp: '2023-11-11T23:32:29+08:00' } }

获取接口凭证

截止当前日期 2023 年 11 月 10 日，腾讯 BOT 机器人官方还没更新相关 SDK，所以需要进行调用群 API 则需要 POST 请求进行处理，我们通过 axios 库获取接口凭证。

安装 axios 第三方库

npm install axios

接口凭证 请求参数设置

clientSecret / AppSecret：oauth 场景进行请求签名的密钥（ 开放平台机器人管理端获得）String
在这里插入图片描述

接口凭证请求地址：https://bots..com/app/getAppAccessToken

调用 axios 请求获取接口凭证

const axios = require('axios') const { 
    config } = require("dotenv") config() let data = { 
    appId: process.env.appId, clientSecret: process.env.AppSecret } axios.post('https://bots..com/app/getAppAccessToken', data) .then(res => { 
    console.log(res.data) }) .catch(err => { 
    console.log(err) })

请求错误：data: { code: , message: ‘invalid appid or secret’ }

acesss_token 返回结果示例

data: { 
    access_token: '2HEWxcMy12Vc3ZC3yIgWxJcnilSp-gdXjtdLmP_yFief3wQMPQuWUzu5cFKhsAnIjPFRAUXPajLl', expires_in: '7200' }

在这里插入图片描述

目前 access_token 生命周期默认 7200 秒，每次请求不会刷新新的 access_token，开发者需要在过期后自行刷新 access_token，保证调用链路权限正常。

group 群接口调用

在每次调用 https 的 openapi 开放接口请求的时候，需要在 header 内引入 access_token 进行调用权限验证。

统一地址

https://api.sgroup..com

在这里插入图片描述

发送群消息

通过 v2 post 发送群消息 基本：HTTP URL /v2/users/{openid}/messages

在这里插入图片描述
具体代码展示

const axios = require('axios') const { 
    config } = require("dotenv") config() const axiosconfig = { 
    headers:{ 
    'Authorization': "Bot 【access_token】", 'X-Union-Appid': "", } }; let data = { 
    content: "Nonebot Perfect", msg_type: 1, image: "https://i2.hdslb.com/bfs/face/41c1233ac533fb5e03cd325e0e70c0b9fa87f841.jpg" } axios.post('https://api.sgroup..com/v2/groups/A85B11B27A39FB0C238B0F19FA09DDF7/messages', data, axiosconfig) .then(res => { 
    console.log(res.data) }) .catch(err => { 
    console.log(err) })

发送媒体消息（图片类型）

属性 类型 必填 说明
file_type int 是 媒体类型：1 图片，2 视频，3 语音，4 文件（暂不开放）资源格式要求图片：png / jpg，视频：mp4，语音：silk
url string 是 需要发送媒体资源的url
srv_send_msg bool 是 设置 true

具体代码展示

const axios = require('axios') const { 
    config } = require("dotenv") config() const axiosconfig = { 
    headers:{ 
    'Authorization': "Bot 【access_token】", 'X-Union-Appid': "", } }; let file = { 
    file_type: 1, url: "https://i2.hdslb.com/bfs/face/41c1233ac533fb5e03cd325e0e70c0b9fa87f841.jpg", srv_send_msg: true } axios.post('https://api.sgroup..com/v2/groups/A85B11B27A39FB0C238B0F19FA09DDF7/files', file, axiosconfig) .then(res => { 
    console.log(res.data) }) .catch(err => { 
    console.log(err) })

群聊事件监听

发送消息分为，主动推送与被动回复，主动消息和被动消息在不同的场景下，发送的频次有不同的规则。 发送消息的接口有4个场景：单聊、聊、文字子频道、频道私信。

const axios = require('axios') const { 
    config } = require("dotenv") config() const axiosconfig = { 
    headers:{ 
    'Authorization': "Bot wjy2j3CIDvFmN0HyPEPO-nwJOGpis2krvDtmxsiJwMKxI9lIY_ZoN73uVKtrMmViut_mHOdz70h8gw", 'X-Union-Appid': "", } }; let data = { 
    content: "Nonebot Perfect", msg_type: 0 } axios.post('https://api.sgroup..com/v2/groups/A85B11B27A39FB0C238B0F19FA09DDF7/messages', data, axiosconfig) .then(res => { 
    console.log(res) }) .catch(err => { 
    console.log(err) })

响应结果结构

事件接收 : { 
    eventType: 'GROUP_AT_MESSAGE_CREATE', eventId: 'GROUP_AT_MESSAGE_CREATE:qdtawy6rufj9ziciulptyfvpd84zm7lk9q6pumnyjuv957wseidnfe0ixfc6s', msg: { 
    author: { 
    id: 'BFE7C7D3C30C96678ABBB5F48', member_openid: 'BFE7C7D3C30C96678ABBB5F48' }, content: ' 12434', group_id: 'A85B11B27A39FB0C238B0F19FA09DDF7', group_openid: 'A85B11B27A39FB0C238B0F19FA09DDF7', id: 'ROBOT1.0_QD.TAWY6RUfJ9ZicIULpTzch-F9MKMiKg1RG04Gel8V2I.0HgXgR0D8UfhgqMN2Jy0bzWi8-PDzwfCMemkroZw!!', timestamp: '2023-11-10T10:44:07+08:00' } }

ffmpeg 音频格式

在这里插入图片描述

下载地址：https://github.com/BtbN/FFmpeg-Builds/releases

ffmpeg 工具 bin 目录

在这里插入图片描述

配置 ffmpeg/bin 系统环境变量

在这里插入图片描述

被动回复语音

配置功能 api 地址

let groupApiUrl = (groupOpenid, mode) => { 
    return `https://api.sgroup..com/v2/groups/${ 
     groupOpenid}/${ 
     mode}` }

发送群消息 sendGroupAudio 语音函数

let sendGroupAudio = (msgid, url, groupOpenid) => { 
    let file = { 
    file_type: 3, url: url, srv_send_msg: false } axios.post(groupApiUrl(groupOpenid, "files"), file, axiosConfig).then(res => { 
    let data = { 
    content: " ", msg_type: 7, media: { 
    file_info: res.data.file_info }, msg_id: msgid } axios.post(groupApiUrl(groupOpenid, "messages"), data, axiosConfig).then(res => { 
    console.log(res.data) }).catch(err => { 
    console.log(err) }) }).catch(err => { 
    console.log(err) }) }

机器人启动代码

const { 
    createOpenAPI, createWebsocket } = require('-guild-bot'); const axios = require('axios') const { 
    config } = require("dotenv") config() const testConfig = { 
    appID: process.env.appID, token: process.env.token, shards: [0, 1], intents: ['PUBLIC_GUILD_MESSAGES', 'GROUPS'], sandbox: false, }; const axiosConfig = { 
    headers: { 
    'Authorization': `Bot ${ 
     process.env.access_token}`, 'X-Union-Appid': process.env.appID, } }; const ws = createWebsocket(testConfig); ws.on('GROUPS', data => { 
    console.log('Gourp messgae:', data); const msgid = data.msg.id let groupOpenid = "A85B11B27A39FB0C238B0F19FA09DDF7" sendAudio(msgid, "https://xxx.com/.silk", groupOpenid) });

特别注意：发送语音文件格式必须是 Tencent silk 语音格式

运行测试

在这里插入图片描述

silk 格式转换处理

Node 异步请求获取 mp3 文件

const axios = require('axios') const fs = require('fs') let getAudio = (content) => { 
    axios({ 
    method: 'get', url: `https://api.vvhan.com/api/song?txt=${ 
     content}`, responseType: 'stream', }).then(res => { 
    let ws = fs.createWriteStream('initaudio.mp3') res.data.pipe(ws); ws.on('finish', () => { 
    console.log('finish') }) }).catch(err => { 
    console.log(err); }); }

Node 同步请求获取 mp3 文件

let getAudioSync = async (content) => { 
    let response = await axios({ 
    method: 'get', url: `https://api.vvhan.com/api/song?txt=${ 
     content}`, responseType: 'stream', }) const reader = response.data; const writer = fs.createWriteStream('initaudio.mp3'); reader.pipe(writer); return new Promise((resolve, reject) => { 
    writer.on('finish', resolve); writer.on('error', reject); }); }

格式转换操作

let encodeSilk = () => { 
    execSync('ffmpeg -i "initaudio.mp3" -f s16le -ar 24000 -ac 1 -acodec pcm_s16le "outaudio.pcm"'); execSync('silk_v3_encoder "outaudio.pcm" ".silk" -tencent') }
到此这篇2023 年最新 开放平台官方企业 群机器人新特性超详细教程（更新中）的文章就介绍到这了,更多相关内容请继续浏览下面的相关推荐文章，希望大家都能在编程的领域有一番成就！

  • 上一篇： 如何免费试用阿里云服务器
  • 下一篇： 史上最简单的openshift免费空间上传代码教程！没有之一！

    • 版权声明：

    本文来自互联网用户投稿，该文观点仅代表作者本人，不代表本站立场。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。
    如若内容造成侵权、违法违规、事实不符，请将相关资料发送至xkadmin@xkablog.com进行投诉反馈，一经查实，立即处理！


    转载请注明出处，原文链接：https://www.xkablog.com/do-yfwjc/10487.html

    # 平台 # 最新 # 教程

    相关文章：

  • 如何免费试用阿里云服务器2024-11-24 22:09:09
  • IDM磁力解析 IDM磁力使用教程2024-11-24 22:09:09
  • 超碰网站源码搭建教程超碰在线视频搭建超碰网站搭建教程2024-11-24 22:09:09
  • 超碰网站源码搭建教程超碰在线视频搭建超碰网站搭建教程2024-11-24 22:09:09
  • 超碰网站源码搭建教程超碰在线视频搭建超碰网站搭建教程2024-11-24 22:09:09
  • 史上最简单的openshift免费空间上传代码教程！没有之一！2024-11-24 22:09:09
  • Windows 7 开机启动动画自定义教程2024-11-24 22:09:09
  • 阿里云centos7，tomcat8配置catalina.out日期分割并定期删除2024-11-24 22:09:09
  • 阿里云centos7服务器卸载openJDK并安装jdk2024-11-24 22:09:09
  • 阿里云centos7安装2个tomcat，用nginx实现负载均衡2024-11-24 22:09:09
    • ❮ 全屏图片 ❯