# wecom-app-sdk

**Repository Path**: hacker__007/wecom-app-sdk

## Basic Information

- **Project Name**: wecom-app-sdk
- **Description**: No description available
- **Primary Language**: Go
- **License**: Apache-2.0
- **Default Branch**: develop
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 2
- **Created**: 2024-10-25
- **Last Updated**: 2024-10-25

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

![wecom-app-sdk](./logo.png)

[![JetBrains Logo (Main) logo](https://resources.jetbrains.com/storage/products/company/brand/logos/jb_beam.svg "logo")](https://jb.gg/OpenSourceSupport)


# wecom-app-sdk　golang版企业微信自建应用sdk

## 主要功能

- 自动维护`accesstoken`
- 统一格式返回，只需要判断 `resp.ErrCode`　是不是为 **0** 即可

## 注意事项

- 自建应用需要有客户联系权限
- 通讯录写权限较高，所以需要配置通讯录和自建应用两个`secret`

## 联系我

![contactme](./contact_me.jpeg)


## 安装使用

    go get github.com/go-laoji/wecom-app-sdk

## 使用样例

样例中配置为测试使用,请根据实际情况修改，但切记不要公开secret配置

    package main

    import (
        "github.com/go-laoji/wecom-app-sdk"
        "log"
    )
    
    func main() {
        defer func() {
            if e := recover(); e != nil {
                log.Println("recover", e)
            }
        }()
        var testConfig = wecom.WorkChatConfig{
            CorpId:        "ww190690c489d2eb53",
            ContactSecret: "08tnu5LGrsbKwvEDfTGlBMFMw3CsUCwRMavxvkLZSH8",
            AppId:         "1000002",
            AppSecret:     "pedn4nqraARPFOG_A-aVFz1F9pp1sdR-3K1fsCpTwg0",
        }
        weworkApp := wecom.NewWeComApp(testConfig)
        resp := weworkApp.CorpTagList([]string{}, []string{})
        log.Println(resp)
    }



## 接口列表(更新ing...)

- 通讯录管理
    - 成员管理
      - [x] 创建成员
      - [x] 读取成员
      - [x] 更新成员
      - [x] 删除成员
      - [x] 批量删除成员
      - [x] 获取部门成员
      - [x] 获取部门成员详情
      - [x] userid与openid互换
      - [ ] 二次验证
      - [ ] 邀请成员
      - [ ] 获取加入企业二维码
      - [ ] 获取企业活跃成员数
    - 部门管理
      - [x] 创建部门
      - [x] 更新部门
      - [x] 删除部门
      - [x] 获取部门列表
    - 标签管理
      - [x] 创建标签
      - [x] 更新标签名字
      - [x] 删除标签
      - [x] 获取标签成员
      - [x] 删除标签成员
      - [x] 获取标签列表
    - 异步批量接口
      - [ ] 增量更新成员
      - [ ] 全量覆盖成员
      - [ ] 全量覆盖部门
      - [ ] 获取异步任务结果
    - 通讯录回调通知
      - [ ] 成员变更通知
      - [ ] 部门变更通知
      - [ ] 标签变更通知
      - [ ] 异步任务完成通知
    - 互联企业
      - [ ] 获取应用的可见范围
      - [ ] 获取互联企业成员详细信息
      - [ ] 获取互联企业部门成员
      - [ ] 获取互联企业部门成员详情
      - [ ] 获取互联企业部门列表
    - 异步导出接口
      - [ ] 导出成员
      - [ ] 导出成员详情
      - [ ] 导出部门
      - [ ] 导出标签成员
      - [ ] 获取导出结果
      - [ ] 导出任务完成通知

- 客户联系
    - 企业服务人员管理
      - [x] 获取配置了客户联系功能的成员列表
    - 客户联系「联系我」管理
      - [x] 配置客户联系「联系我」方式
      - [x] 获取企业已配置的「联系我」方式
      - [x] 获取企业已配置的「联系我」列表
      - [x] 更新企业已配置的「联系我」方式
      - [x] 删除企业已配置的「联系我」方式
      - [x] 结束临时会话
    - 客户群「加入群聊」管理
      - [x] 配置客户群进群方式
      - [x] 获取客户群进群方式配置
      - [x] 更新客户群进群方式配置
      - [x] 删除客户群进群方式配置 
    - 客户管理
      - [x] 获取客户列表
      - [x] 获取客户详情
      - [x] 批量获取客户详情
      - [x] 修改客户备注信息
    - 客户联系规则组管理
      - [x] 获取规则组列表
      - [x] 获取规则组详情
      - [x] 获取规则组管理范围
      - [x] 创建新的规则组
      - [x] 编辑规则组及其管理范围
      - [x] 删除规则组
    - 客户标签管理
        - 管理企业标签
          - [x] 获取企业标签库
          - [x] 添加企业客户标签
          - [x] 编辑企业客户标签
          - [x] 删除企业客户标签
        - 编辑客户企业标签
    - 在职继承
      - [x] 分配在职成员的客户
      - [x] 查询客户接替状态
    - 离职继承
      - [x] 获取待分配的离职成员列表
      - [x] 分配离职成员的客户
      - [x] 查询客户接替状态
      - [x] 分配离职成员的客户群
    - 客户群管理
        - [x] 获取客户群列表
        - [x] 获取客户群详情
        - [x] 客户群opengid转换
    - 客户朋友圈
      - 企业发表内容到客户的朋友圈
          - [x] 创建发表任务
          - [x] 获取任务创建结果
      - 获取客户朋友圈全部的发表记录
          - [x] 获取企业全部的发表列表
          - [x] 获取客户朋友圈企业发表的列表
    - 上传附件资源
    - 消息推送
      - [x] 创建企业群发
      - 获取企业的全部群发记录
          - [x] 获取群发记录列表
          - [x] 获取群发成员发送任务列表
          - [x] 获取企业群发成员执行结果
- 应用管理
  - 获取应用
    - [x] 获取指定的应用详情
    - [x] 获取access_token对应的应用列表
- 消息推送
  - [x] 发送应用消息
    - 文本消息
    - 图片消息
    - 语音消息
    - 视频消息
    - 文件消息
    - 文本卡片消息
    - 图文消息
    - 图文消息(mpnews)
    - markdown消息
    - 小程序通知消息
    - 模板卡片消息
      - 文本通知
      - 图文展示
      - 按钮交互
      - 投票选择
      - 多项选择
  - [x] 更新模板卡片消息
  - [x] 撤回应用消息
  - [x] 发送消息到群聊会话
    - [x] 创建群聊会话
    - [x] 修改群聊会话
    - [x] 获取群聊会话
    - [x] 应用推送消息
- 身份验证
    - [x] 获取访问用户身份