智能门户实现与企业微信同步数据的方案

智能门户系统是部署在企业微信上的企业级应用。智能门户系统是一种集成了多种功能模块的企业信息管理平台，可以提供员工信息、内部新闻、文件共享等服务。企业微信是一款专为企业打造的即时通讯工具，可以方便地进行企业内部沟通、协作和信息分享。智能门户与企业微信的系统级融合可以完善企业全平台业务信息管理能力。

为了提高企业内部的工作效率和信息流动性，将智能门户系统与企业微信进行数据同步是一种常见的需求。通过将两者的数据进行同步，可以实现以下目标：

1. 员工可以在企业微信平台上方便地查看智能门户系统的信息，避免频繁切换应用的不便。
2. 员工在企业微信上发布的信息可以及时同步到智能门户系统，使得全员都能及时获得最新的信息。
3. 通过数据同步，还可以实现单点登录，提供更方便的用户体验。

为了实现智能门户系统与企业微信的数据同步，需要进行系统集成和数据对接。具体来说，可以通过开发API接口或使用中间件进行数据传输和同步。通过这种方式，可以实现双向数据同步，确保两个系统之间的数据一致性和实时性。这样，企业内部的信息流动将更加高效和便捷，有助于提升整体的工作效率和协作能力。

接下来小编就以道一云智能门户（七星 Portal ）为例 , 给大家讲解一下智能门户是如何实现与企业微信同步数据的。

1.产品简介

道一云智能门户（七星Portal）是集"自定义门户+综合管理后台+OA场景轻应用"为一体的综合平台型产品，助力客户打造企业多端个性化工作台。通过搭配定制化的业务模块及多样化组件满足自定义配置、个性化运营及丰富多样化场景交互需求，快速搭建千人千面的工作门户，提升业务场景交互和用户体验，同时通过统一待办聚合各应用系统的待办与信息，业务及应用统一界面展示及统一待办处理，实现跨平台的高效协同，提高办公效率，缩减管理成本，助力企业数字化办公转型。

目前产品主要着力在企业微信平台生态上运营，助力客户升级企业微信工作台体验。道一云作为腾讯企业微信的深度合作伙伴，产品设计模式与企业微信生态紧密结合，产品能力基于企业微信作为客户端办公入口，鉴权认证、用户登录、通讯录管理等基础能力均以企业微信底层能力来构建。

智能门户（七星Portal）支持基于企业微信的组织通讯录作为系统主数据。支持基于企业微信上的自建应用作为系统应用使用。通过搭建更具特色和结合业务场景的工作台页面替换原生工作台，实现企业多维度、个性化的千人千面工作台需求。

工作台升级前：应用堆砌、主次不清、单调乏味

工作台升级后：层次分明、美观清晰、丰富有趣

2.技术方案

道一云智能门户（七星Portal）采用以下架构实现与企业微信的数据同步交互（以私有化企业微信为例）

• 组织通讯录主数据：

企业微信组织通讯录包括了部门数据、人员数据、标签数据，均开放了API可获取数据，并支持配置通讯录助手实现双向同步。智能门户（七星Portal）已完成标准对接，部署初始化后点击同步数据操作即可进行主数据的获取。

企业微信开放了两种权限，通讯录的读取以及编辑权限，读取通讯录的部门接口如下：

请求方式：GET

请求参数：

参数	必须	说明
access_token	是	调用接口凭证
id	否	部门id。获取指定部门及其下的子部门。 如果不填，默认获取全量组织架构
no_fetch_child	否	填"0"则为递归获取子部门下面的部门，填"1"则为不递归获取子部门下面的部门

返回结果：
下面展示一些 内联代码片。

{
   "errcode": 0,
   "errmsg": "ok",
   "department": [
        {
            "id": 2,
            "name": "广州研发中心",
            "parentid": 1,
            "order": 10,
            "party_user_limit": 10,
       },
       {
            "id": 3,
            "name": "邮箱产品部",
            "parentid": 2,
            "order": 40,
            "party_user_limit": 10,
       }
   ]
}

读取通讯录的人员接口如下：

请求方式：GET

请求参数：

参数	必须	说明
access_token	是	调用接口凭证
department_id	是	获取的部门id
fetch_child	否	1/0：是否递归获取子部门下面的成员

返回结果：

{
   "errcode": 0,
   "errmsg": "ok",
   "userlist": [{
        "userid": "zhangsan",
        "name": "李四",
        "department": [1, 2]
    }],
    "is_leader_in_dept": [1, 0],
    "positions": ["产品经理1","产品经理2"],
}

• 应用数据：

企业微信应用包括了基础应用、自建应用，其中只有自建应用开放了API可获取数据，并支持双向同步。智能门户（七星Portal）已完成标准对接，部署初始化后点击同步数据操作即可进行应用的获取。

企业微信开放了两种权限，应用的读取以及编辑权限，批量读取应用信息接口如下：

请求方式：POST

请求示例：

下面展示一些 内联代码片。

{
    "agent_status": 1
}

参数说明：

参数	必须	说明
access_token	是	调用凭证
agent_status	否	0：获取所有停用的应用； 1： 获取所有打开的应用

返回结果：
下面展示一些 内联代码片。

{
    "errcode": 0,
    "errmsg": "ok",
    "agentlist": [
        {
            "agentid": 1000030,
            "name": "hahah",
            "logo_mediaid": "xxxxxxxxxx",
            "description": "hahah",
            "allow_userinfos": {
                "user": [{
                        "userid": "userid1"
                 }]
            },
           "allow_partys": {
               "partyid": [1]
            },
            "allow_tags": {
             "tagid": [33]
            },
              "disallow_userinfos":  {
                      "user":  [{
                              "userid":  "userid1"
                                        }]
                          },
               "disallow_partys":  {
                         "partyid":  [1]
                          },
                "disallow_tags":  {
                               "tagid":  [33]
                          },
                "show_in_mobile": 1,
                "show_in_pc": 1,
                "app_mng_url": "http://www.tencent.com",
                "sso_domain": {
                                "redirect_domain_sso":  ["www.xxxxxx1.com", "www.xxxxxx2.com"]
                 },
                "bundleid_ios": 123456789,
                "signature_android":  "应用签名",
                "packagename_android": "应用包名",
                "close": 0,
                "redirect_domain": "",
                "isreportenter": 0,
                "home_url": "",
                "callback_open": 1,
                "groupid": 0,
                "arch_rw_flag": 0
        },
        {
            "agentid": 1000031,
            "name": "franktest10",
            "logo_mediaid": "xxxxxxxxx",
            "description": "",
            "allow_userinfos": {
               "user": [{
                    "userid": "userid1"
                }]
            },
           "allow_partys": {
               "partyid": [1]
           },
           "allow_tags": {
                "tagid": [34]
           },
            "disallow_userinfos":  {
                         "user":  [{
                                     "userid":  "userid1"
                                 }]
                          },
             "disallow_partys":  {
                         "partyid":  [1]
                          },
              "disallow_tags":  {
                               "tagid":  [33]
                          },
           "show_in_mobile": 1,
           "show_in_pc": 1,
           "app_mng_url": "http://www.tencent.com",
           "sso_domain": {
                   "redirect_domain_sso":  ["www.xxxxxx1.com", "www.xxxxxx2.com"]
           },
           "bundleid_ios": "123456789",
           "signature_android":  "应用签名",
           "packagename_android": "应用包名",
           "close": 0,
           "redirect_domain": "www.qq.com",
           "isreportenter": 0,
           "home_url": "",
           "callback_open": 1,
        }
    ]
}

本文章介绍了道一云智能门户（七星Portal）与企业微信的数据接口进行对接与交互的技术方案，包括了通讯录的部门、用户等主数据，还有应用数据。接下来还会陆续带来更多有关道一云智能门户（七星Portal）产品的内容，敬请期待，也希望感兴趣的大家多多关注。

作者介绍：
道一云 ，成立于2004年，是中国低代码领域的领导厂商、腾讯战略投资企业、腾讯生态核心合作伙伴。拥有自主知识产权管理软件产品百余项，涵盖数字化应用构建低代码平台-七巧、全场景智能业务分析BI-七析、千人千面、数智化办公企业级门户-七星以及30多款开箱即用的场景应用。

欢迎关注：
公众号：道一云低代码（do1info）
官网： https://www.do1.com.cn/