如何拉取企业微信打卡数据

前言: 

本篇文章主要介绍 拉取企业微信打卡数据这个功能。

本文涉及到阿里巴巴的JsonObject的解析,可参考我的另一篇blog

1)了解企业微信相关文档

本文中涉及的一些专业术语可以参考:https://work.weixin.qq.com/api/doc/90000/90135/90665#corpid

 

拉取企业微信打卡数据在OA数据接口这块, 这块的功能逻辑主要是这样的,

a.企业微信会提供一个接口给你,你需要传入你们公司对应的打卡应用的id 和 打卡应用的秘钥,

b.通过发送post 请求,封装请求的参数,

c.得到企业微信返回的数据,一般情况下数据为json,接下来就可以解析json

 

打卡的Api文档地址:

https://work.weixin.qq.com/api/doc/90000/90135/90262

2)获取打卡数据

可以看到:要做拉取打卡数据功能,我们首先需要获取AccessToken,获取到AccessToken 后我们需要传入用户id.     

 

A.TestController

    @GetMapping(value = "/listPushCardData")
    public void listPushCardData() {
        //获取本地打卡数据
        pushCardService.listPushCardData();
    }

B.PushCardServiceImpl

package com.test.service;

/**
 * @Author tanghh
 * @Date 2020/7/2 11:40
 */
public interface PushCardService {
    /**
     * 获取打卡数据
     */
    void listPushCardData();
}

C.PushCardServiceImpl

package com.test.service.impl;

import com.alibaba.fastjson.JSONObject;
import com.sun.scenario.effect.impl.sw.sse.SSEBlend_SRC_OUTPeer;
import com.test.model.PushCardVo;
import com.test.service.PushCardService;
import com.test.util.DateUtil;
import com.test.util.QiWeiParametersUtil;
import com.test.wechat.SendRequest;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.stereotype.Service;

import java.text.SimpleDateFormat;
import java.util.ArrayList;
import java.util.Date;
import java.util.List;
import java.util.Map;

/**
 * @Author tanghh
 * @Date 2020/7/2 11:40
 */
@Service
public class PushCardServiceImpl implements PushCardService {

    private Logger logger = LoggerFactory.getLogger(PushCardServiceImpl.class);
    /**
     * 获取打卡数据
     */
    /**
     * {
     * "opencheckindatatype": 3,
     * "starttime": 1492617600,
     * "endtime": 1492790400,
     * "useridlist": ["james","paul"]
     * }
     */
    @Override
    public void listPushCardData() {
        try {
            //1.获取打卡数据
            String accessToken = QiWeiParametersUtil.getPushCardAccessToken();
            //2.获取当天的开始时间和结束时间
            SimpleDateFormat simpleDateFormat = new SimpleDateFormat("yyyy-MM-dd");
            String todayTime = simpleDateFormat.format(new Date());
            Map<String, Long> map = DateUtil.getStartTimeAndEndTime(todayTime);
            Long startTime = map.get("startTime");
            Long endTime = map.get("endTime");

            //3.封装请求参数
            PushCardVo vo = new PushCardVo();
            vo.setOpencheckindatatype(3);
            vo.setStarttime(startTime);
            vo.setEndtime(endTime);
            List userList = new ArrayList();
            userList.add("*****");
            vo.setUseridlist(userList);
            String jsonStr = JSONObject.toJSONString(vo);
            //4.发送请求
            String url = QiWeiParametersUtil.getPushCardUrl.replace("ACCESS_TOKEN",accessToken);
            JSONObject jsonObject = SendRequest.sendPost(url,jsonStr);
            List list = (List) jsonObject.get("checkindata");
            for (Object o : list) {
                Map dataMap = (Map) o;
                System.out.println("wifi的名字为:----"+dataMap.get("wifiname"));
                System.out.println("用户id:----"+dataMap.get("userid"));
                System.out.println("地址详情:----"+dataMap.get("location_detail"));
                System.out.println("打卡类型:----"+dataMap.get("checkin_type"));
            }




        } catch (Exception e) {
            logger.error("获取打卡记录数据失败",e);
        }
    }
}

D.其中涉及的类

QiWeiParametersUtil

package com.test.util;

import com.alibaba.fastjson.JSONObject;
import com.test.wechat.SendRequest;

/**
 * 企业微信参数配置类
 *
 * @Author: tanghh18
 * @Date: 2019/8/30 16:21
 */
public class QiWeiParametersUtil {
    /**
     * 1.获取AccessToken
     */
    public static String getAccessTokenUrl = "https://qyapi.weixin.qq.com/cgi-bin/gettoken?corpid={corpid}&corpsecret={corpsecret}";

    /**
     * 发送企业微信AccessToken
     */
    public static String sendAccessTokenUrl = "https://qyapi.weixin.qq.com/cgi-bin/message/send?access_token=ACCESS_TOKEN";

    /**
     * 上传临时文件素材
     * @param
     * @return
     */
    public static String uploadMediaUrl="https://qyapi.weixin.qq.com/cgi-bin/media/upload?access_token=ACCESS_TOKEN&type=TYPE";
    /**
     * 本地打卡数据
     */
    public static String getPushCardUrl = "https://qyapi.weixin.qq.com/cgi-bin/checkin/getcheckindata?access_token=ACCESS_TOKEN";

    /**
     * 企业ID
     */
    public final static String corpId = "企业id";

    /**
     * 企业应用的id,整型。可在应用的设置页面查看(yes)项目测试(ebo0.2版本)
     */
    public final static int agentId = 1000049;
    /**
     * 应用secret
     */
    public static String secret = "yin";
    /**
     * 打卡应用的agentid
     */
    public static String punch_card_agentId = "3010011";
    /**
     * 打卡应用的secret
     */
    public static String punch_card_secret = "在打卡应用中可以看到";

    /**
     * 获得各种access_token
     *
     * @return
     */
    public static String getAccessToken() {
        String url = getAccessTokenUrl.replace("{corpid}", corpId).replace("{corpsecret}", secret);
        JSONObject departmentJson = SendRequest.sendGet(url);
        return departmentJson.getString("access_token");
    }
    /**
     * 获取打卡应用的Secret
     */

    public static String getPushCardAccessToken(){
        String url = getAccessTokenUrl.replace("{corpid}", corpId).replace("{corpsecret}", punch_card_secret);
        JSONObject pushCardJsonObject = SendRequest.sendGet(url);
        return pushCardJsonObject.getString("access_token");
    }
}
 

E.DateUtil

package com.test.util;

import java.text.DateFormat;
import java.text.ParseException;
import java.text.SimpleDateFormat;
import java.util.Date;
import java.util.HashMap;
import java.util.Map;

/**
 * @Author tanghh
 * @Date 2020/7/2 11:30
 */
public class DateUtil {
    /**
     * 获取一天的开始时间和结束时间
     */
    public static Map<String,Long> getStartTimeAndEndTime(String dateTime) throws ParseException {
        DateFormat format = new SimpleDateFormat("yyyy-MM-dd");
        Map<String,Long>  map = new HashMap(3);
        Date date2 = format.parse(dateTime);
        // 一天的毫秒-1
        int dayMis = 1000 * 60 * 60 * 24;
        // 返回自 1970 年 1 月 1 日 00:00:00 GMT 以来此 Date 对象表示的毫秒数。
        // 当天的毫秒
        long curMillisecond = date2.getTime();
        // 当天最后一秒
        long resultMis = curMillisecond + (dayMis - 1);
        // 得到我需要的时间 当天最后一秒
        Date endDate = new Date(resultMis);

        //将数据保存到Map中
        map.put("startTime",date2.getTime()/1000);
        map.put("endTime",endDate.getTime()/1000);
        return map;
    }
}

SendRequest

package com.test.wechat;

import com.alibaba.fastjson.JSON;
import com.alibaba.fastjson.JSONObject;
import org.springframework.web.context.request.RequestContextHolder;
import org.springframework.web.context.request.ServletRequestAttributes;

import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpSession;
import java.io.*;
import java.net.URL;
import java.net.URLConnection;

/**
 * 用来发送请求的类
 *
 * @Author: tanghh18
 * @Date: 2019/8/30 16:21
 */

public class SendRequest {
    /**
     * 发送GET请求
     *
     * @param url
     * @return
     */
    public static JSONObject sendGet(String url) {
        HttpServletRequest request = ((ServletRequestAttributes) RequestContextHolder.getRequestAttributes()).getRequest();
        HttpSession session = request.getSession();
        JSONObject jsonObject = null;
        StringBuffer sb = new StringBuffer();
        BufferedReader in = null;
        try {
            String urlName = url;
            URL realUrl = new URL(urlName);
            // 打开和URL之间的连接
            URLConnection conn = realUrl.openConnection();
            // 设置通用的请求属性
            conn.setRequestProperty("accept", "*/*");
            conn.setRequestProperty("connection", "Keep-Alive");
            conn.setRequestProperty("user-agent", "Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.1; SV1)");
            //针对群晖NAS请求,加一个Cookie
            if (session.getAttribute("sid") != null) {
                conn.addRequestProperty("Cookie", "id=" + session.getAttribute("sid"));
            }
            conn.setConnectTimeout(10000);
            // 建立实际的连接
            conn.connect();
            // 定义BufferedReader输入流来读取URL的响应
            in = new BufferedReader(new InputStreamReader(conn.getInputStream(), "UTF-8"));
            String line;
            while ((line = in.readLine()) != null) {
                sb.append(line);
            }
            jsonObject = JSON.parseObject(sb.toString());
        } catch (Exception e) {
            System.out.println("发送GET请求出现异常!" + e);
        } finally {
            // 使用finally块来关闭输入流
            try {
                if (in != null) {
                    in.close();
                }
            } catch (IOException ex) {
                System.out.println("关闭流异常");
            }
        }
        return jsonObject;
    }


    /**
     * 发送post请求(返回json)
     *
     * @param url
     * @param param
     * @return
     */
    public static JSONObject sendPost(String url, String param) {
        PrintWriter out = null;
        BufferedReader in = null;
        JSONObject jsonObject = null;
        String result = "";
        try {
            URL realUrl = new URL(url);
            // 打开和URL之间的连接
            URLConnection conn = realUrl.openConnection();
            // 发送POST请求必须设置如下两行
            conn.setDoOutput(true);
            conn.setDoInput(true);
//            conn.addRequestProperty("Cookie", "stay_login=1 smid=DumpWzWQSaLmKlFY1PgAtURdV_u3W3beoei96zsXkdSABwjVCRrnnNBsnH1wGWI0-VIflgvMaZAfli9H2NGtJg id=EtEWf1XZRLIwk1770NZN047804");//设置获取的cookie
            // 获取URLConnection对象对应的输出流(设置请求编码为UTF-8)
            out = new PrintWriter(new OutputStreamWriter(conn.getOutputStream(), "UTF-8"));
            // 发送请求参数
            out.print(param);
            // flush输出流的缓冲
            out.flush();
            // 获取请求返回数据(设置返回数据编码为UTF-8)
            in = new BufferedReader(
                    new InputStreamReader(conn.getInputStream(), "UTF-8"));
            String line;
            while ((line = in.readLine()) != null) {
                result += line;
            }
            jsonObject = JSONObject.parseObject(result);
        } catch (IOException e) {
            e.printStackTrace();
        } finally {
            try {
                if (out != null) {
                    out.close();
                }
                if (in != null) {
                    in.close();
                }
            } catch (IOException ex) {
                ex.printStackTrace();
            }
        }
        return jsonObject;
    }

}

3) 测试拉取打卡数据

访问:http://localhost:8084/listPushCardData

本篇文章就到这里了 ,感谢阅读。

 

 

 

<think>嗯,用户想找企业微信和CRM系统实时数据同步的方案,需要整合API接口的配置教程。首先,我得先理解用户的具体需求。他们可能希望员工在企业微信上的操作,比如客户信息更新、订单状态变化等,能实时同步到CRM系统中,反之亦然。这可能涉及到企业微信的API和CRM系统的接口对接。 接下来,我需要回顾现有的知识库内容。比如,引用[1]提到企业微信的监听消息接口,可以用来实现自动回复、考勤集成和公告推送。这可能对实时数据同步有帮助,因为监听消息接口可以捕捉到用户行为或数据变化的事件,然后触发同步操作。而引用[2]提到了不同规模的CRM系统,比如Zoho CRM、Salesforce等,这些系统可能有不同的API接口和集成方式。所以,用户可能需要根据他们使用的CRM类型来选择具体的配置方法。 然后,用户需要具体的步骤教程,所以得把流程分解开来。首先可能需要获取企业微信的API权限,比如配置可信IP获取access_token。然后设置事件监听,比如客户联系变更事件,这样当有客户信息更新时,企业微信可以推送消息到指定的服务器。接着,需要处理这些事件,解析数据,并调用CRM系统的API将数据同步过去。同时,可能还需要反向同步,即从CRM到企业微信,这时候可能需要定时查询或者CRM提供webhook支持。 另外,安全性也是需要考虑的,比如数据加密、身份验证,确保传输过程中数据不被泄露。还有错误处理机制,比如同步失败时的重试策略,日志记录等,这对系统的稳定性很重要。 用户可能还关心具体的代码示例,比如如何接收企业微信的事件推送,如何调用CRM的API。比如引用[1]中的Python示例,可能可以借鉴,用Flask框架搭建一个接收POST求的服务器,处理事件数据,然后使用requests库调用CRM的接口。 此外,最佳实践部分需要结合引用中的案例,比如自动回复机器人、考勤集成,说明实时数据同步如何提升客服效率和数据一致性。可能还需要提到如何测试整个流程,比如使用企业微信的测试环境,或者沙箱模式,确保配置正确后再上线。 最后,用户可能需要一些常见问题的解答,比如如何处理API速率限制,数据冲突时的解决方案,或者如何确保同步的实时性。这些都需要在教程中给出建议,或者引导用户查阅相关文档。</think>### 企业微信与CRM实时数据同步方案 #### 一、技术实现路径 1. **API接口选择** - 企业微信提供`客户联系事件推送`接口,可实时监听客户信息变更(如添加/删除客户、标签更新)[^1]。 - CRM系统需支持数据写入API(如Salesforce的REST API、Zoho CRM的Webhook配置)。 2. **核心架构设计** ```mermaid graph LR 企业微信-->|事件推送|中间服务层-->|数据转换|CRM系统 CRM系统-->|主动查询|中间服务层-->|数据回写|企业微信 ``` #### 二、配置步骤(以Python为例) 1. **企业微信端配置** - 登录企业微信管理后台,进入「应用管理」→「自建应用」→ 开启API接收消息 - 设置可信IP白名单和Token/EncodingAESKey ```python # 事件接收验证示例 from werobot import WeRoBot robot = WeRoBot(token='YOUR_TOKEN', encoding_aes_key='YOUR_AES_KEY') @robot.handler def handle_messages(message): if message.event == 'change_external_contact': sync_to_crm(message.content) # 调用CRM同步函数 return 'success' ``` 2. **CRM系统对接** - 以Salesforce为例配置REST端点: ```python import requests def sync_to_crm(data): url = "https://your_salesforce_instance/services/apexrest/WechatSync" headers = {'Authorization': 'Bearer YOUR_SFDC_TOKEN'} payload = { "name": data['UserName'], "phone": data['Mobile'], "tags": ",".join(data['Tags']) } response = requests.post(url, json=payload, headers=headers) ``` #### 三、关键优化策略 1. **数据增量同步** 使用企业微信的`last_sequence`参数实现增量,避免全量数据重复传输: $$ \Delta D = \sum_{n=last\_seq}^{current\_seq} event_n $$ 2. **异常处理机制** - 实现幂等性校验(如消息去重ID) - 建立死信队列处理失败求 #### 四、典型应用场景 1. **客户画像实时更新** 当员工在企业微信更新客户标签时,自动同步到CRM的客户360视图[^2] 2. **商机状态双向同步** CRM中的订单状态变更可通过企业微信即时通知销售代表
评论 7
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值