QQ群内容转发到公会开发说明

2013年8月14日前创建的“托管模式”应用,不管是否上线均可以直接调用本接口。
2013年8月14日及以后上线的“托管模式”应用,需要申请使用权限。请按照模版提交API接口权限申请(申请方式详见这里),以获取接口调用权限。
“非托管模式”应用不支持调用本接口。

目录

1. 准备需要的信息

在申请使用权限时,请在应用管理中心填写下列信息,便于腾讯开放平台将公会QQ群聊天内容转发到应用对应的公会内:
(1)群openid;
(2)公会ID;
(3)CGI的URL:用于提供给腾讯后台回调。当应用公会QQ群有聊天内容时,腾讯后台将回调该URL将聊天内容转发到应用对应的公会内。如图:
testqq3_qqgroup_url.png

1. 本功能只限hosting应用,no-hosting应用不能使用本功能。
2. CGI的URL标准格式为ip:port/xxx(例如10.204.156.59:10003/cgi-bin/test_cgi,其中ip:port为应用服务器对应的ip地址和端口。)
3. 假如该openid对应的用户开启了QQ设备锁,将无法转发该用户在QQ群的聊天信息到应用中。

2. 开发说明

请开发者按照下面的说明开发CGI,当接收到腾讯方传入的请求参数时,可以返回相应的信息。

2.1 请求参数说明

参数名称 类型 描述
msg string 聊天消息(utf-8编码格式),只发送文本和系统表情,不发送图片或者文件。

表情为"[\xx]",xx为表情的索引,表情索引详见#附件 表情索引,开发者可以自己选择过滤掉表情,或者是使用索引来自己转义表情。
另外,对于在QQ群聊天里超过738个字节(246个汉字)的信息,不会被转发到应用对应的公会内。

unionid unsigned int 与QQ群绑定的公会ID。
zoneid unsigned int 应用调用接口fusion2.dialog.manageQQGroup将公会ID与QQ群绑定时,传入参数“zoneid”,在这里由腾讯方回传给应用。
openid string 发起聊天的群成员。
seq unsigned int 消息序列号,请原样返回,便于统计。
sig string 请求串的签名,由需要签名的参数生成。

开发者需要验证签名,从而确认该请求是从腾讯开放平台下发。
(1)签名方法请见文档:腾讯开放平台第三方应用签名参数sig的说明
(2)按照上述文档进行签名生成时,需注意回调协议里多加了一个步骤:
在构造源串的第3步“将排序后的参数(key=value)用&拼接起来,并进行URL编码”之前,需对value先进行一次编码 (编码规则为:除了 0~9 a~z A~Z !*() 之外其他字符按其ASCII码的十六进制加%进行表示,例如“-”编码为“%2D”)。
(3)接收到的所有参数除sig以外都要参与签名。为方便平台后续对协议进行扩展,请不要将参与签名的参数写死。
(4)所有参数都是string型,进行签名时必须使用原始接收到的string型值。

2.2 请求示例

POST /cgi-bin/test_cgi HTTP/1.1
Host: 10.204.156.59
Connection: close
QunIp: 10.204.156.59:10003
Content-Type: appliction/x-www-form-urlencoded
Accept: */*
Content-Length: 138

msg=hello%5B%5C14%5D&union_id=77777777&openid=0000000000000000000000002329FBEF&
sig=SH9iw95TbyqhCjMP6%2FvUyJ1j%2F5M%3D&seq=561&zoneid=123

2.3 CGI应返回参数说明

参数名称 描述
ret 返回码。0为成功,非0为失败。
msg 如果错误,返回错误信息。
appid 应用的appid。
seq 原样返回消息序列号。
zoneid 应用的分区ID,与传入的值一致。

2.4 返回示例

正确返回示例:

Content-type: text/html; charset=utf-8
{
"ret":0,
"msg":"OK",
"appid":123456,
"seq":561,
"zoneid":123
}


错误返回示例:

Content-type: text/html; charset=utf-8
{
"ret":-1,
"msg":"filed"
}

附件 表情索引

0:"惊讶";
1:"撇嘴";
2:"色";
3:"发呆";
4:"得意";
5:"流泪";
6:"害羞";
7:"闭嘴";
8:"睡";
9:"大哭";
10:"尴尬";
11:"发怒";
12:"调皮";
13:"呲牙";
14:"微笑";
15:"难过";
16:"酷";
17:"冷汗";
18:"抓狂";
19:"吐";
20:"偷笑";
21:"可爱";
22:"白眼";
23:"傲慢";
24:"饥饿";
25:"困";
26:"惊恐";
27:"流汗";
28:"憨笑";
29:"大兵";
30:"奋斗";
31:"咒骂";
32:"疑问";
33:"嘘";
34:"晕";
35:"折磨";
36:"衰";
37:"骷髅";
38:"敲打";
39:"再见";
97:"擦汗";
98:"抠鼻";
99:"鼓掌";
100:"糗大了";
101:"坏笑";
102:"左哼哼";
103:"右哼哼";
104:"哈欠";
105:"鄙视";
106:"委屈";
107:"快哭了";
108:"阴险";
109:"亲亲";
110:"吓";
111:"可怜";
112:"菜刀";
89:"西瓜";
113:"啤酒";
114:"篮球";
115:"乒乓";
60:"咖啡";
61:"饭";
46:"猪头";
63:"玫瑰";
64:"凋谢";
116:"示爱";
66:"爱心";
67:"心碎";
53:"蛋糕";
54:"闪电";
55:"炸弹";
56:"刀";
57:"足球";
117:"瓢虫";
59:"便便";
75:"月亮";
74:"太阳";
69:"礼物";
49:"拥抱";
76:"强";
77:"弱";
78:"握手";
79:"胜利";
118:"抱拳";
119:"勾引";
120:"拳头";
121:"差劲";
122:"爱你";
123:"NO";
124:"OK";
42:"爱情";
85:"飞吻";
43:"跳跳";
41:"发抖";
86:"怄火";
125:"转圈";
126:"磕头";
127:"回头";
128:"跳绳";
129:"挥手";
130:"激动";
131:"街舞";
132:"献吻";
133:"左太极";
134:"右太极";

以上信息是否解决您的问题?

Copyright © 1998 - 2018 Tencent. All Rights Reserved.

腾讯公司 版权所有

有问必答 返回顶部