go message

go-message

使用微信測試號碼和企業微信應用程式建立自己的訊息推播服務。只要向自己的伺服器發送簡單的GET 請求，即可將訊息推送至你的手機微信上。

配置

在推送之前，需要先在系統上設定微信相關的設定。登入系統後台（主頁， http://你的域名/ ），註冊一個新用戶，然後參考以下資訊配置。

微信測試號碼和企業微信應用程式可以只配置其中一個，但必須填寫所有字段，否則無法推送。

使用者資訊

• 使用者名稱：隨意，同時用於在推播訊息時URL 中辨識用戶。例如： GET http://你的域名/template/用户名
• 密碼：隨意，僅用於登入後台系統。
• 訊息推送Token：隨意，在推播訊息時攜帶，用於驗證推播者身分。例如： GET http://你的域名/template/用户名?token=hello

微信測試號

1. 前往微信公眾平台
2. 在測試號碼資訊一欄中取得appID 和appsecret。
3. 在測試號二維碼一欄中掃描二維碼關注自己的測試號，並在右側列表中獲取自己的微訊號，作為接收者ID。
4. 在範本訊息介面 一欄新增模板，範本標題隨意填寫，範本內容填入： From: {{from.DATA}} {{description.DATA}} {{remark.DATA}} ，提交後取得範本ID 。
5. 在介面設定資訊一欄中，URL 填入自己伺服器的網域/ IP 加上後綴，例如： http://你的域名/verify/用户名；填入任意Token 作為介面設定Token。填完先不要點選驗證，先在回到推播系統中填好介面設定Token 並成功修改後，再點選驗證。

企業微信應用

1. 在企業微信註冊一個企業微訊號（不需要企業資質）。
2. 在企業資訊頁面最下方取得企業ID。
3. 在微信外掛頁面用微信掃碼關注，這樣訊息才會直接推送到微信上。
4. 在應用程式管理頁面建立一個新應用，並取得應用程式的AgentId 和Secret。訊息將透過這個應用程式推送。
5. 在通訊錄頁面右側清單中，點選自己進入詳情，取得自己的帳號作為接收者ID（一般是自己名字的拼音）。
6. 卡片訊息預設URL 可以隨意填寫，用於卡片訊息點進去的頁面，但是必須要有而且要保證是合法URL，否則微信伺服器會報錯。可以使用系統的主頁作為URL。

附註：企業微信應用程式支援推送至多個企業成員，配置頁面的接收者ID 填入成員ID 清單（多個接收者以'|'分隔，最多支援1000個），或填入"@all" 直接通知所有企業成員。

推播

發送簡單GET 或POST 請求到自己伺服器即可完成推播。

注意：所有推送必須攜帶token參數來驗證身份，值為使用者資訊配置中的消息推送Token。可以在URL 中用query params 的方式，也可以用form data 的方式。

推送至微信測試號

微信測試號僅支援範本訊息。

範本訊息

推播網址（GET / POST）： http://你的域名/template/用户名

可選參數欄位（用於顯示在模板的不同位置）：

• from
• desc
• remark

註：如果用GET 請求，參數需要全部用query params 的方式。如果使用POST 請求，需要全部用form data 的方式。

範例： http://你的域名/template/用户名?token=token&from=webpage&desc=Hello%20Wrold&remark=这是一条测试消息

效果：

推播至企業微信應用

企業微信應用程式支援純文字訊息、文字卡片訊息。

純文字訊息

推播URL（GET / POST）： http://你的域名/plaintext/用户名

必需參數欄位：

• content

註：如果用GET 請求，參數需要全部用query params 的方式。如果使用POST 請求，需要全部用form data 的方式。

範例： http://你的域名/plaintext/用户名?token=token&content=Hello,%20traveller

文字卡片訊息

推播網址（GET / POST）： http://你的域名/textcard/用户名

必需參數欄位：

• title
• desc
• url（如果不填，則會使用設定時的預設URL）

註：如果用GET 請求，參數需要全部用query params 的方式。如果使用POST 請求，需要全部用form data 的方式。

範例： http://你的域名/textcard/用户名?token=token&title=Hello&desc=World

效果：

部署

直接運行打包好的二進位檔案即可。初次運作會產生一個設定文件，裡面可以配置JWT 簽發相關設置，是否啟用Redis 作為快取（預設否），服務運行的連接埠（預設80）。重啟程序後生效。

編譯

Windows

 set GOPROXY= ` https://goproxy.cn,direct ` GOOS=windows GOARCH=amd64 | go build -o go-message.exe go-message-pusher

Linux

GOPROXY=https://goproxy.cn,direct CGO_ENABLED=1 GOOS=linux GOARCH=amd64 go build -o go-message go-message-pusher