《企业微信自建应用开发流程》前端入门指南：一步步实现JS-SDK功能

2023-01-30 09:53:46

揭秘企业微信自建应用开发的奥秘

在企业数字化浪潮中，企业微信已成为沟通协作的利器。而其自建应用功能更是赋予企业定制化办公体验的强大能力。本文将深入浅出地剖析企业微信自建应用开发流程的前端篇，带你一步步掌握 JS-SDK 的核心功能，从获取用户信息到发送朋友圈，尽情释放应用潜能。

1. 蓄势待发：前期准备

开启自建应用之旅前，几项必要准备不可或缺：

申请企业微信企业号： 获取 CorpID 和 Secret，企业的身份凭证。
创建自建应用： 获取 AgentID，应用的唯一标识。
下载企业微信 JS-SDK： 集成到项目中，沟通前端与企业微信的桥梁。

2. 拨开迷雾：获取用户信息

掌握用户信息是应用交互的基础。通过调用 qy.getCurUserInfo 函数，即可轻松获取用户的姓名、头像、微信号等信息，为个性化体验奠定基础。

qy.getCurUserInfo(function(err, res) {
  if (err) {
    console.log('获取用户信息失败：', err);
  } else {
    console.log('获取用户信息成功：', res);
  }
});

3. 快捷回复：提升效率

便捷高效的快捷回复，助力沟通畅通无阻。通过 qy.setShortcutList 和 qy.getShortcutList 函数，可以设置快捷回复内容和获取快捷回复列表，让预定义信息一键发送，大幅提升回复效率。

qy.setShortcutList([{
  "id": "1",
  "icon": "http://example.com/icon.png",
  "title": "你好",
  "content": "您好，有什么可以帮助您？"
}, {
  "id": "2",
  "icon": "http://example.com/icon.png",
  "title": "再见",
  "content": "再见，欢迎您下次再来！"
}], function(err, res) {
  if (err) {
    console.log('设置快捷回复失败：', err);
  } else {
    console.log('设置快捷回复成功：', res);
  }
});

qy.getShortcutList(function(err, res) {
  if (err) {
    console.log('获取快捷回复失败：', err);
  } else {
    console.log('获取快捷回复成功：', res);
  }
});

4. 授权之门：解锁更多权限

授权机制是应用获取用户访问权限的关键。通过调用 qy.authorize 函数发起授权请求，并通过 qy.checkJsApi 函数检查授权结果，即可解锁通讯录、日历等企业资源的访问权限。

qy.authorize({
  "corpId": "ww25c0b81f58a29f21",
  "redirect_uri": "http://example.com/redirect_uri.html",
  "scope": "snsapi_base",
  "state": "123"
}, function(err, res) {
  if (err) {
    console.log('授权失败：', err);
  } else {
    console.log('授权成功：', res);
  }
});

qy.checkJsApi({
  "jsApiList": ["addressbook", "calendar"],
  "success": function(res) {
    console.log('授权成功：', res);
  },
  "fail": function(err) {
    console.log('授权失败：', err);
  }
});

5.朋友圈发布：分享精彩

朋友圈发布功能，让应用触达更广阔的受众。通过 qy.shareTimeline 函数，可以轻松向用户的企业朋友圈发送消息，分享企业动态、活动预告等精彩内容，扩大应用影响力。

qy.shareTimeline({
  "title": "企业微信自建应用开发指南",
  "desc": "本文提供了一个详细的企业微信自建应用开发流程指南，帮助前端开发人员逐步实现 JS-SDK 功能，包括获取用户信息、快捷回复、授权和发送朋友圈。",
  "link": "http://example.com/article.html",
  "imgUrl": "http://example.com/image.png",
  "success": function() {
    console.log('发送朋友圈成功');
  },
  "cancel": function() {
    console.log('取消发送朋友圈');
  },
  "fail": function(err) {
    console.log('发送朋友圈失败：', err);
  }
});