应用管理
企业微信在 2017 年 11 月对 API
进行了大量的改动,应用管理部分已经没啥用了。
应用管理是企业微信中比较特别的地方,因为它的使用是不基于应用的,或者说基于任何一个应用都能访问这些 API
,所以在用法上是直接调用 work
实例的 agent
属性。
<?php
$config = [
// ...
];
$work = \EasySwoole\WeChat\Factory::work($config);
应用列表
$agents = $work->agent->list();
应用详情
$agents = $work->agent->get($agentId);
设置应用
$agents = $work->agent->set($agentId, ['foo' => 'bar']);
设置工作台自定义展示
模版类型数据结构
可以通过接口配置展示类型。具体可设置:
- 关键数据型
- 图片型
- 列表型
- webview型
官方文档:https://open.work.weixin.qq.com/api/doc/90000/90135/92535
设置应用在工作台展示的模版
<?php
$params = [
'agentid' => 1000005,
'type' => 'image', //展示类型
'image' => [
'url' => 'xxxx',
'jump_url' => 'http://www.qq.com',
'pagepath' => 'pages/index'
],
'replace_user_data' => true
];
$work->agentWorkbench->setWorkbenchTemplate(array $params);
获取应用在工作台展示的模版
<?php
$agentId = 100005;
$work->agentWorkbench->getWorkbenchTemplate(int $agentId);
设置应用在用户工作台展示的数据
<?php
$params = [
'agentid' => 1000005,
'userid' => 'test', //员工id
'type' => 'keydata', //展示类型
'keydata' => [
'items' => [
[
'key' => '待审批',
'data' => '2',
'jump_url' => 'http://www.qq.com',
'pagepath' => 'pages/index'
],
[
'key' => '带批阅作业',
'data' => '4',
'jump_url' => 'http://www.qq.com',
'pagepath' => 'pages/index'
],
[
'key' => '成绩录入',
'data' => '45',
'jump_url' => 'http://www.qq.com',
'pagepath' => 'pages/index'
],
[
'key' => '综合评价',
'data' => '98',
'jump_url' => 'http://www.qq.com',
'pagepath' => 'pages/index'
]
]
]
];
$work->agentWorkbench->setWorkbenchData(array $params);