应用管理

{warning} 企业微信在17年11月对 API 进行了大量的改动,应用管理部分已经没啥用了

应用管理是企业微信中比较特别的地方,因为它的使用是不基于应用的,或者说基于任何一个应用都能访问这些 API,所以在用法上是直接调用 work 实例的 agent 属性。

$config = [
    ...
];

$app = Factory::work($config);

应用列表

$agents = $app->agent->list(); // 测试拿不到内容

应用详情

$agents = $app->agent->get($agentId); // 只能传配置文件中的 id,API 改动所致

设置应用

$agents = $app->agent->set($agentId, ['foo' => 'bar']);

设置工作台自定义展示

模版类型数据结构

可以通过接口配置展示类型。具体可设置:

  • 关键数据型
  • 图片型
  • 列表型
  • webview型

官方文档 https://open.work.weixin.qq.com/api/doc/90000/90135/92535

设置应用在工作台展示的模版

$params = [
    'agentid' => 1000005,
    'type' => 'image', //展示类型
    'image' => [
        'url' => 'xxxx',
        'jump_url' => 'http://www.qq.com',
        'pagepath' => 'pages/index'
    ],
    'replace_user_data' => true
];

$agents->agent_workbench->setWorkbenchTemplate(array $params);

获取应用在工作台展示的模版

$agentId = 100005;

$agents->agent_workbench->getWorkbenchTemplate(int $agentId);

设置应用在用户工作台展示的数据

$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'
            ]
        ]
    ]
];

$agents->agent_workbench->setWorkbenchData(array $params);
Powered by