IM
1. 创建讨论组
(@since 云助手app 3.4.0)
yzs.createDiscussionGroup({
name: "审批流程讨论("+getCurrentTime(),
topic: {
title: "讨论主题",
description: "待审批(发起人:梅义2016/10/20)",
openUrl: "https://www.fdccloud.com/",
iconUrl:"https://o1wh05aeh.qnssl.com/image/view/app_icons/a010c2c368e390f112ed133cb5880271/120"
},
optionalMember: [{
imUserId: "my55c455da9a0d9_mysoft582c455a4154b806989681",
wzsUserId: "wzs123456",
name: "梅义",
selected: true,
groupName:"流程相关人"
},
{
imUserId: "my55c455da9a0d9_mysoft582c455bb8eff011633992",
wzsUserId: "wzs123457",
name: "朱稳",
selected: false,
groupName:"流程相关人"
},
{
imUserId: "my55c455da9a0d9_mysoft582c455ca9314841111369",
wzsUserId: "wzs123458",
name: "彭江",
selected: false,
groupName:"历史责任人"
}],
businessId: "9314841111369",
memberFrom: "specify",
extra:"云助手ApiDemo",
appCode:"9001",
success:function(result){
},
error:function(result) {
}
});
参数说明
| 参数 | 参数类型 | 必须 | 说明 |
|---|---|---|---|
| name | String | 是 | 讨论组名称 |
| topic | Obj | 否 | 讨论组主题信息 |
| optionalMember | Obj | 是 | 讨论组可选成员列表 |
| groupName | String | 否 | 分组字段，可以将讨论组可选成员列表按照groupName进行分组展示 @since3.5.2 |
| businessId | String | 是 | 业务id |
| memberFrom | String | 是 | 可选值为specify,any @since3.5.2版本开始支持any模式可以从云助手通讯录中选择人员,3.5.2之前版本只能从optionalMember数组中选人) |
| extra | String | 否 | 扩展字段 |
| appCode | String | 否 | 应用标识，在云助手企业平台中添加第三方应用时生成 |
2. 打开讨论组
(@since 云助手app 3.4.0)
yzs.openDiscussionGroup({
discussionGroupId: "213123123123",
discussionGroupName: "审批流程讨论",
success:function(result){
},
error:function(result) {
}
});
参数说明
| 参数 | 参数类型 | 必须 | 说明 |
|---|---|---|---|
| discussionGroupName | String | 是 | 讨论组名称 |
| discussionGroupId | String | 是 | 讨论组id |
3. 是否支持IM功能
var isImEnable = yzs.isImEnable();
4. 创建会话
yzs.createConversation({
topic: {
title: "报表名称("+getCurrentTime(),
description: "描述信息",
openUrl: "https://www.fdccloud.com/",
iconUrl: "https://o1wh05aeh.qnssl.com/image/view/app_icons/cec69ceb5cf8ff13ff22764dafaf0cf6/60"
},
talkTo: {
imUserId: "111",
name: "梅义",
avatar: "https://ss1.bdstatic.com/70cFuXSh_Q1YnxGkpoWK1HF6hhy/it/u=2013171600,4013211525&fm=21&gp=0.jpg"
},
imageLocalResourceId: "",
mode: "share",
extra:"云助手ApiDemo",
success:function(result){
},
error:function(result) {
}
});
参数说明
| 参数 | 参数类型 | 必须 | 说明 |
|---|---|---|---|
| topic | Obj | 否 | 讨论组主题信息 |
| talkTo | Obj | 否 | 指定联系人发起回话，如果不传则选择通讯录联系人 |
| optionalMember | Obj | 是 | 讨论组可选成员列表 |
| imageLocalResourceId | String | 否 | 取本地发送给联系人 |
| mode | String | 是 | “share”是分享模式，“talk”是会话模式 |
| extra | String | 否 | 扩展字段 |
5. 关联工作项
(@since 云助手app 3.6.2)
yzs.topic({
topic: {
title: "工作项01",
description: "工作项描述信息",
openUrl: "https://www.fdccloud.com/",
iconUrl: "https://o1wh05aeh.qnssl.com/image/view/app_icons/cec69ceb5cf8ff13ff22764dafaf0cf6/60"
},
businessId:"bid001",
appCode:"9001",
success:function(result){
},
error:function(result) {
}
});
参数说明
| 参数 | 参数类型 | 必须 | 说明 |
|---|---|---|---|
| businessId | String | 是 | 业务id |
| title | String | 是 | 工作项标题 |
| description | String | 否 | 工作项描述信息 |
| openUrl | String | 是 | 工作项页面地址 |
| iconUrl | String | 否 | 工作项图标 |
| appCode | String | 否 | 应用标识，在云助手企业平台中添加第三方应用时生成 |