QiWe开放平台 · 个人名片
API驱动企微自动化，让开发更高效
核心能力：为开发者提供标准化接口、快速集成工具，助力产品高效拓展功能场景
官方站点：https://www.qiweapi.com
团队定位：专注企微API生态的技术服务团队
对接通道：搜「QiWe 开放平台」联系客服
核心理念：合规赋能，让企微开发更简单、更高效
GitHub Webhook 会在特定事件发生时向你的服务器发送POST请求，我们的目标是解析它，并调用企微add_msg_template接口。
1. 业务流程设计
GitHub 发起 Webhook：包含仓库名、操作者、事件类型。
Go 接口验证签名：确保请求真的来自 GitHub，防止恶意攻击。
构造卡片消息：根据不同事件（如 Star 或 New Issue）渲染不同的文案。
异步推送企微：避免阻塞 GitHub 的回调连接。
2. 代码实现：Go 语言版本
我们使用Gin框架来快速搭建服务。
package main import ( "crypto/hmac" "crypto/sha256" "encoding/hex" "fmt" "io" "net/http" "github.com/gin-gonic/gin" ) const ( githubSecret = "your_github_webhook_secret" qwToken = "your_qywx_access_token" ) func main() { r := gin.Default() r.POST("/github/webhook", func(c *gin.Context) { // 1. 验证 GitHub 签名 body, _ := io.ReadAll(c.Request.Body) signature := c.GetHeader("X-Hub-Signature-256") if !verifySignature(githubSecret, signature, body) { c.JSON(403, gin.H{"error": "Invalid signature"}) return } // 2. 获取事件类型 event := c.GetHeader("X-GitHub-Event") // 3. 异步处理消息发送，不影响 GitHub 的回调响应 go processGithubEvent(event, body) c.JSON(200, gin.H{"status": "accepted"}) }) r.Run(":8080") } // verifySignature 验证签名安全性 func verifySignature(secret, signature string, body []byte) bool { h := hmac.New(sha256.New, []byte(secret)) h.Write(body) expected := "sha256=" + hex.EncodeToString(h.Sum(nil)) return hmac.Equal([]byte(expected), []byte(signature)) } func processGithubEvent(event string, body []byte) { // 解析 JSON 并调用之前写的 SendExternalGroupMsg 接口 // 如果是 "watch" (Star) 事件 -> 发送：🌟 新增一个 Star！ // 如果是 "issues" 事件 -> 发送：🛠 有人提了新 Issue。 fmt.Printf("处理 GitHub 事件: %s\n", event) }3. 如何配置 GitHub 端？
进入你的 GitHub 仓库设置 ->Settings->Webhooks->Add webhook。
Payload URL: 填写你的服务器地址（如
http://your-ip:8080/github/webhook）。Content type: 选择
application/json。Secret: 填写你在代码中定义的
githubSecret。Which events: 选择
Let me select individual events，勾选Stars和Issues。
4. 关键避坑点
公网地址问题：GitHub 无法访问你的
localhost。开发调试时，可以使用ngrok或crawlee等工具做内网穿透。Star 事件的特殊性：在 Webhook 中，Star 事件对应的名称是
watch，而不是star。内容去重：GitHub 有时会因为网络问题重发 Webhook。建议在 Go 中对
X-GitHub-Delivery（唯一请求 ID）做 1 分钟内的去重处理。
