应用管理

企业微信在 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);