APP-iOS 接入
快速接入
想要在你的产品中接入兔小巢,首先需要获取该产品的 url,一般由https://support.qq.com/product/ + 该产品的 ID
组成。
产品的 ID 在创建时已经分配给你。每个产品有唯一的 ID,可以在 全部产品 处,点击“设置”查看。
以下为部分关键代码:
#import "ViewController.h"
// 如果使用 WKWebview 的话,需要导入 Webkit 的头文件
#import "WebKit/WebKit.h"
@interface ViewController ()
@end
@implementation ViewController
- (void)viewDidLoad {
[super viewDidLoad];
//创建WKWebView对象,设置大小为屏幕大小
WKWebView *webview = [[WKWebView alloc] initWithFrame:CGRectMake(0, 36, [[UIScreen mainScreen] bounds].size.width,
[[UIScreen mainScreen] bounds].size.height)];
// 用户ID
NSString *open_id = @"tucao_123";
// 昵称
NSString *nickname = @"tucao_test";
// 头像url地址
NSString *avatar = @"https://txc.qq.com/static/desktop/img/products/def-product-logo.png";
// 获得 webview url,请注意url单词是product而不是products,products是旧版本的参数,用错地址将不能成功提交
// 把1221数字换成你的产品ID,否则会不成功
NSString *appUrl = @"https://support.qq.com/product/1221";
// 设置请求体
NSMutableURLRequest *request = [NSMutableURLRequest requestWithURL:[NSURL URLWithString:appUrl]];
// 请求方式为POST请求
[request setHTTPMethod:@"POST"];
[request setValue:@"application/x-www-form-urlencoded" forHTTPHeaderField:@"Content-Type"];
NSString *body = [NSString stringWithFormat:@"nickname=%@&avatar=%@&openid=%@", nickname, avatar, open_id];
[request setHTTPBody:[body dataUsingEncoding:NSUTF8StringEncoding]];
// 将WebView对象添加到当前页面当中
[self.view addSubview:webview];
// WebView对象加载请求并且现实内容
[webview loadRequest:request];
}
@end
这里根据你的产品 ID 来配置接入链接,然后用一个 webview(UI/WKWebView)
加载这个链接,或者可以使用你喜欢的任意 webview
容器。甚至可以在手机浏览器中输入该地址前往你的产品反馈页面,因为兔小巢页面就是一个 Web App。
如果你不需要其他可选的参数或传递自己的登录态,那么恭喜你,已经可以使用了🌚
发条帖子试试吧。
重要提示
使用这种方式接入的用户将会获得随机分配头像和昵称,如果需要传入自定义登录态详见下方「建议配置1」
小技巧
建议配置1:配置产品自己的用户登录态(用户头像、昵称、ID),查看 配置产品自己的用户登录态
建议配置2:配置自定义参数来获得更多用户使用环境信息,查看 配置自定义参数
可选配置1:通过微信通知用户的反馈已得到管理员回复,查看 微信回复通知可选配置2:通过接口实时获得用户反馈通知,查看 配置 Webhooks
可选配置3:通过接口取出用户的反馈数据,查看 用户反馈数据 API
可选配置4:适老化支持接入,查看 适老化支持接入
适老化支持提醒:兔小巢已参照《互联网网站适老化通用设计规范》对移动端进行了适老化改造。
建议你参考 《适老化支持接入文档》,将产品的老人相关设置同步到兔小巢Wbeview中,方便老人浏览、使用反馈。