簡訊通知設定

除了 LINE 與團隊頻道之外,OrderNotify 也能透過簡訊把訂單與事件通知直接發送到顧客手機。外掛內建支援台灣常見的簡訊商三竹與 Every8D,並新增整合漸強實驗室(MAAC)的 MAAC Go 簡訊服務。本篇說明如何設定 MAAC Go。

MAAC Go 以 API 金鑰驗證,不需要設定 IP 白名單,因此更換主機或機房時無需重新申請;同時支援送達狀態回報(sms.sentsms.deliveredsms.failed),並以 HMAC-SHA256 對 Webhook 進行驗簽,確保通知確實來自 MAAC Go。

步驟一:取得並填入 API 金鑰

  1. 登入 MAAC Go 後台,前往「MCP / API」頁面取得 API 金鑰。正式環境的金鑰以 sk_live_ 開頭,測試環境則以 sk_test_ 開頭。
  2. 複製金鑰後,進入 OrderNotify 外掛設定頁,找到「MAAC Go」區域。
  3. 將金鑰貼入「API Key」欄位。

步驟二:交換 Webhook 網址與簽章金鑰

  1. 複製 OrderNotify 設定頁中唯讀的「Webhook URL」欄位內容。
  2. 將此網址貼入 MAAC Go 後台的「Webhooks」設定,讓 MAAC Go 能把送達狀態回報到你的網站。
  3. MAAC Go 會產生一組「簽章金鑰(Webhook Signing Secret)」,將它複製回 OrderNotify 的「Webhook Signing Secret」欄位並儲存。

步驟三:驗證設定

設定完成後,點擊設定頁的「查詢餘額」按鈕,確認 MAAC Go 錢包中有可用餘額。能正確顯示餘額即代表 API 金鑰與連線設定無誤,之後就能在推播通知中選用簡訊管道發送。

注意事項

  • 測試簡訊時,請避免發送 test 這類無意義的內容。建議改用包含品牌名稱、訂單編號等正當用途的訊息,以免被 NCC 防詐審查機制攔截(回報 ncc_blocked)。
  • API 金鑰與簽章金鑰等同於發送簡訊與接收回報的鑰匙,請妥善保管,勿公開於前台或版本控制中。
  • 簡訊為計費服務,發送前請確認 MAAC Go 錢包餘額充足,避免通知因餘額不足而發送失敗。