三七互娱技术团队

企信消息中心系统新增“日程”利器

前言:

相信大家对企微的日程已经玩得很溜了吧,作为时间管理大师的我们,日程能够让我们明确每天每个时刻需要做的事情。它不仅可以当作一个备忘录,也可以很好地提高我们工作的效率。

相信我们大多人在日常工作中经常会参与各种会议,而我们的一般流程就是先在会议室系统定个会议室,然后增加时间、地点、参会人等,然后再去日程应用再重复操作一波。考虑大家的痛点,接下来会议室将上线同步日程的功能,值得期待哈。

在这个业务实现中,考虑到未来其他系统有可能也需要日程应用,所以我们把接入企微日程模块的代码编写在企微消息中心系统,封装成基础组件提供对外使用。

好了,接下来我们进入实现模块。

实现:

1、查阅企微日程对接文档

https://developer.work.weixin.qq.com/document/path/93648

2、企微日程api对接

利用企信消息中心系统的优势,对接文档中很多内容我们都可以直接利用了

(1)确定要创建日程的应用及获取应用token

$wechatClass = new wechat\wechat();// 日程应用ID$wechatClass->setAppID(MESSAGE_APP_ID);// 调用接口凭证$accessToken = $wechatClass->checkToken();

(2)封装好对应的数据结构体

$postData = array();$url = "";if (strval($operateType) == 'del') {    // 删除    $postData['schedule_id'] = $scheduleId;    // 接口地址    $url = URL_POST_SCHEDULE_DEL . '?access_token=' . $accessToken;} else {    // 新增 or 修改    $postData['schedule']['admins'] = $organizer;    $postData['schedule']['start_time'] = $startTime;    $postData['schedule']['end_time'] = $endTime;    $postData['schedule']['attendees'] = $attendeesData;    $postData['schedule']['summary'] = $summary;    $postData['schedule']['description'] = $description;    $postData['schedule']['location'] = $location;    if (strval($operateType) == 'add') {        // 新增接口地址        $url = URL_POST_SCHEDULE_ADD . '?access_token=' . $accessToken;    } elseif (strval($operateType) == 'update') {        // 修改需传入参数        $postData['schedule']['schedule_id'] = $scheduleId;        $url = URL_POST_SCHEDULE_UPDATE . '?access_token=' . $accessToken;    }}

(3)调用企微api

$result = curlRequest($url, $postData, true, true);

3、改造企信消息中心新增日程增删改接口

好了,接下来就是打广告的环节了,为了更好地提供基础组件复用服务,所以我们在企信消息中心系统新增了日程相关的api,让其他系统可以减少与企微交互的逻辑,安心做系统业务的逻辑。

目前,已成功接入会议室系统的业务,功能运行正常。大体的接入流程跟之前企微消息类似,接口文档大体如下:

Image

实际效果:

Image

总结:

在企信消息中心的应用,因为有着跟企微相关的基础搭建,所以在对接企微api显得相对轻松。而企信消息中心作为一个中间桥梁,我们也会慢慢完善一些基础组件(消息、日程、邮件等)方便大家接入使用,大家有业务需求的话,可以联系我们进行接入。