subscribe.go 1.9 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152
  1. package subscribe
  2. import (
  3. "fmt"
  4. "github.com/silenceper/wechat/v2/miniprogram/context"
  5. "github.com/silenceper/wechat/v2/util"
  6. )
  7. const (
  8. //发送订阅消息
  9. //https://developers.weixin.qq.com/miniprogram/dev/api-backend/open-api/subscribe-message/subscribeMessage.send.html
  10. subscribeSendURL = "https://api.weixin.qq.com/cgi-bin/message/subscribe/send"
  11. )
  12. // Subscribe 订阅消息
  13. type Subscribe struct {
  14. *context.Context
  15. }
  16. // NewSubscribe 实例化
  17. func NewSubscribe(ctx *context.Context) *Subscribe {
  18. return &Subscribe{Context: ctx}
  19. }
  20. // Message 订阅消息请求参数
  21. type Message struct {
  22. ToUser string `json:"touser"` //必选,接收者(用户)的 openid
  23. TemplateID string `json:"template_id"` //必选,所需下发的订阅模板id
  24. Page string `json:"page"` //可选,点击模板卡片后的跳转页面,仅限本小程序内的页面。支持带参数,(示例index?foo=bar)。该字段不填则模板无跳转。
  25. Data map[string]*DataItem `json:"data"` //必选, 模板内容
  26. MiniprogramState string `json:"miniprogram_state"` //可选,跳转小程序类型:developer为开发版;trial为体验版;formal为正式版;默认为正式版
  27. Lang string `json:"lang"` //入小程序查看”的语言类型,支持zh_CN(简体中文)、en_US(英文)、zh_HK(繁体中文)、zh_TW(繁体中文),默认为zh_CN
  28. }
  29. //DataItem 模版内某个 .DATA 的值
  30. type DataItem struct {
  31. Value string `json:"value"`
  32. }
  33. // Send 发送订阅消息
  34. func (s *Subscribe) Send(msg *Message) (err error) {
  35. var accessToken string
  36. accessToken, err = s.GetAccessToken()
  37. if err != nil {
  38. return
  39. }
  40. uri := fmt.Sprintf("%s?access_token=%s", subscribeSendURL, accessToken)
  41. response, err := util.PostJSON(uri, msg)
  42. return util.DecodeWithCommonError(response, "Send")
  43. }