wechat work go

wechat-work-go

 import (
    wechatwork "github.com/dfang/wechat-work-go" // package wechatwork
)

Features

通訊錄管理API

• [✓] 成員管理

  • [✓] 建立成員(只能使用通訊錄secret建立)
  • [✓] 讀取成員
  • [✓] 更新成員
  • [✓] 刪除成員
  • [✓] 批量刪除成員
  • [✓] 取得部門成員
  • [✓] 取得部門成員詳情
  • [✓] userid與openid互換
  • [✓] 二次驗證
  • [✓] 邀請成員

• [✓] 部門管理

  • [✓] 創建部門
  • [✓] 更新部門
  • [✓] 刪除部門
  • [✓] 取得部門列表

• 標籤管理

  • 建立標籤
  • 更新標籤名字
  • 刪除標籤
  • 取得標籤成員
  • 增加標籤成員
  • 刪除標籤成員
  • 取得標籤列表

• 非同步批量介面

  • 增量更新成員
  • 全量覆蓋成員
  • 全量覆蓋部門
  • 取得非同步任務結果

• 通訊錄回呼通知

身份認證

• [✓] 網頁授權登入時取得存取使用者身份
• [✓] 掃碼授權登入時取得存取使用者身份

應用程式管理

• [✓] 取得應用
• [✓] 設定應用
• [✓] 自訂選單
  • [✓] 建立選單
  • [✓] 取得選單
  • [✓] 刪除選單

訊息推播

• [✓] 推播訊息到應用程式
• [✓] 發送訊息到群組聊天會話
  • [✓] 建立群組聊天會話
  • [✓] 修改群聊會話
  • [✓] 取得群組聊天會話
  • [✓] 推播訊息到群組聊天會話
• 互聯企業訊息推播
  • 發送應用程式訊息

素材管理

• 素材管理
  • 上傳臨時素材
  • 上傳永久圖片
  • 取得臨時素材
  • 取得高清語音素材

TODO(以下介面個人暫時用不到， 暫時不開發)

• 外部聯絡人管理
• OA 資料介面
• 企業支付
• 電子發票

使用

企業微信是分應用的， 一個企業（一個corpid）中有多個app （對應的一套corpsecret，agentid）

所以使用的時候先創建一個企業的client，然後用這個client創建不同的app對象

 import (
    wechatwork "github.com/dfang/wechat-work-go" // package wechatwork
)

corpID := os . Getenv ( "CORP_ID" )
corpSecret := os . Getenv ( "CORP_SECRET" )
agentID , _ := strconv . ParseInt ( os . Getenv ( "AGENT_ID" ), 10 , 64 )

corp := wechatwork . New ( corpID )
app = corp . NewApp ( corpSecret , agentID )
    

要使用哪個模組的功能，就建立哪個模組的實例

 import "github.com/dfang/wechat-work-go/message"

msg := message.WithApp(app)

msg.SendAppChatMessage(....)

開發

對照API文檔, 運行測試, 快速了解API

 export CORP_ID=xxxxxx
export CORP_SECRET=yyyyyy
export AGENT_ID=zzzzzz

运行单个测试，比如只运行access_token_test.go的测试
ginkgo -v -focus='access_token'

或者
go test -v wechat_work_go_suite_test.go client_test.go

watch mode  
ginkgo watch -v -focus='access_token*'