整合
Webhook 與 API 金鑰
把叫號機、ERP 等自家系統接上 Nomi。技術性的一頁。
這一頁是給工程師看的
如果你沒有要串接自己的系統，可以跳過整章。 一般的店用不到這個。
左側選單的「整合」。需要集團管理權限才看得到。
兩個方向
出站 webhook——Nomi 主動打你的系統。 用在點餐流程的「呼叫外部系統」節點： 顧客走到某一步時，Nomi 呼叫你的叫號機／會員系統。
入站 API 金鑰——你的系統打 Nomi 查訂單。
V1 的權限固定是 order:read。
建立一個整合
點「新增整合」，填：
- 名稱——自己認得就好，例如「叫號機-1F」
- Webhook URL——出站的目標，必須是
https
建立後會顯示金鑰。
金鑰只顯示這一次
client secret 和 signing_secret 只會顯示一次，關掉就拿不回來了
（只能換一組新的）。
建立的當下就複製存進你的密碼管理器或環境變數。
驗證簽章
Nomi 送出的 webhook 會帶 X-Nomi-Signature 標頭，
用 signing_secret 做 HMAC。
你的接收端一定要驗簽——否則任何人都能假造請求打你的系統。
換金鑰
按「換金鑰」。舊金鑰還可以用 24 小時， 給你時間把新金鑰佈署上去，不會當場斷線。
同步還是非同步
在流程編輯器的節點設定裡選：
- 同步——等你的系統回應，可以把回傳的號碼顯示在畫面上（例如叫號機發的號）。逾時限 1000～10000 毫秒
- 非同步——送出就走，不等結果
同步節點的回傳值可以被下游的「顯示取餐碼」節點引用。
失敗的時候
節點設定裡選「失敗行為」：
- 繼續流程（fail-open）——你的系統掛了，顧客還是點得到餐
- 顯示錯誤請店員協助——擋住，等人來處理
大部分情況選 fail-open。顧客不該因為你的叫號機當機而點不了餐。
測試
整合列表有「測試」按鈕，可以確認 URL 打得通。
啟用 / 停用
停用中的整合不會被呼叫，流程裡引用它的節點在發佈時會被擋 （「引用的整合不存在或已停用」）。