Skip to content

Send Teams Notify

Description

發送 Microsoft Teams 頻道通知。支援背景非同步發送以提升效能,需帶入有效之系統或店家 Token。本 API 內建嚴格的權限防偽造機制(一般店家將強制鎖定為自身的 company_id,僅系統帳號允許跨公司代發)。

Resource

POST /common/notify/teams

Authorization

採用 OAuth 2.0 Bearer Token,詳細使用流程請參考 Auth Login

Request Body Parameters

Name Type Description
title string 通知標題
msg string 通知內容
notify_type string 通知類型名稱
ALLOWED VALUES:
  • NONE: 不需要
  • USER: 會員相關
  • TICKET: 票券相關
  • MIX: 混合通知
  • SYNC: 訂單同步
  • MOHIST: 墨攻儲值卡
  • BUYGOODAND8WAY: 買好與八方
  • MENUSYNC: 菜單同步
  • DEV: 開發測試
company_id string (optional) 指定通知的公司統編 (僅系統帳號帶入有效)
company_name string (optional) 公司名稱
vip_id string (optional) 會員 ID
coupon_id string (optional) 票券 ID
order_id string (optional) 訂單 ID
resource_id string (optional) 來源 ID

Request Example

{
  "title": "[系統排程] 同步失敗通知",
  "msg": "該店家的菜單同步程序發生逾時例外",
  "notify_type": "MENUSYNC",
  "company_id": "87654321",
  "order_id": "ORD-20260605-001"
}

Response

立即回傳 200 OK(實際發送交由背景子執行緒處理)。

{
  "message": "Teams 通知已排程發送"
}