核心功能
- 支援直接傳送文字、使用範本產生文字或 Markdown、傳送檔案，以及傳送原始 JSON 請求。
- 多個端口可以共用同一個企業微信連線，並分別配置接收人和傳送模式。
- 自動取得和快取存取權杖；權杖失效時重新整理並重試一次。
建立自建應用程式並取得憑證
開始前，需要有企業微信企業帳號，並具備管理後台的應用程式管理權限。已有自建應用程式時，可直接使用其憑證。- 使用管理員帳號登入企業微信管理後台。
- 進入應用管理 → 自建 → 建立應用，填寫應用程式名稱、Logo 和說明，並設定可見範圍。
- 開啟建立好的應用程式詳細資料頁，複製 AgentId，填入端口連線的應用 ID。
- 在同一應用程式詳細資料頁找到 Secret，按一下檢視，依提示在企業微信用戶端完成管理員確認並取得密鑰，填入連線的應用密鑰。
- 進入我的企業 → 企業資訊，複製企業 ID，填入連線的企業 ID。
端口配置
連線
在設定索引標籤中選擇或建立企業微信連線。以下憑證儲存在連線中。
按一下測試連線可檢查憑證是否能夠取得存取權杖。測試不會傳送訊息，也不驗證接收人是否能收到訊息。
設定索引標籤
進階索引標籤
使用方式
傳送文字
- 選擇企業微信連線並測試連線。
- 將接收人類型設為
User，填寫成員 ID，例如user001。 - 將傳送模式設為
Text，將 UTF-8 文字訊息傳入端口。 - 啟用自動化中的傳送，自動處理到達端口的訊息。
2048 位元組。
使用範本
將傳送模式設為Template，選擇訊息格式並填寫範本。例如，選擇 Markdown 後可使用：
2048 位元組，Markdown 最多為 4096 位元組。
傳送檔案
將傳送模式設為File，輸入訊息必須帶有檔案名稱。端口先上傳檔案，再使用傳回的媒體 ID 傳送檔案訊息；檔案大小必須在 5 位元組至 20 MiB 之間。
如需附帶說明，啟用傳送附帶訊息並填寫範本。檔案和說明分別傳送；如果檔案已傳送而說明失敗，重試該輸入訊息會再次傳送檔案。
傳送原始 JSON
將傳送模式設為原始 JSON，輸入訊息應為企業微信訊息請求的 JSON 物件，例如：msgtype，以及 touser、toparty、totag 中至少一個接收人欄位。此模式按原始 JSON 傳送，忽略端口的接收人、頭覆蓋和訊息格式設定。
端口會自動補充所選連線的 agentid 並提供身分驗證。輸入不得包含 access_token；如果填寫了 agentid，必須與連線中的值一致。其他訊息欄位應符合企業微信對應訊息類型的要求。