應用管理
企業微信在 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);