連接 Neat Pulse

在 Neat Pulse 建立 API 金鑰並填入 Offision,即可同步房間與 Neat 裝置。 設定約需 10 分鐘,完成後請一併檢查感測器讀數與測量時間。

更新於 2026年11月4日
開啟系統整合

在 Neat Pulse 管理主控台建立一組 API 金鑰並貼入 Offision,即可選擇要同步的房間與 Neat 裝置。連線建立後,Offision 會自動向 Neat Pulse 輪詢感測器數據。

事前準備

  • 已註冊 Neat 裝置且正常回報數據的 Neat Pulse 組織
  • 可管理該組織設定的 Neat Pulse 登入帳戶
  • 用來安全保存 API 金鑰與 Organization ID 的密碼管理工具
  • 設定約需 10 分鐘;待 Neat 提供數據且 Offision 完成擷取後,畫面才會顯示感測器讀數

1. 在 Neat Pulse 建立 API 金鑰

登入 signin.pulse.neat.no,從左側選單開啟 Settings,再捲動至組織設定底部開啟 API keys。

Neat Pulse 組織設定畫面,API keys 位於頁面下方。

Neat Pulse 組織設定畫面,API keys 位於頁面下方。

選擇 Create API key,輸入清楚識別用途的名稱(例如 Offision)。在 Scope 下方同時勾選 Read 與 Write:

  • Read:讓 Offision 讀取房間、裝置與感測器數據。
  • Write:讓 Offision 日後可遠端重新啟動裝置。

保持不勾選 Api.Rotate,接著點擊 Create。

在 Scope 勾選 Read 與 Write,再點擊 Create。

在 Scope 勾選 Read 與 Write,再點擊 Create。

下一個確認畫面是 Neat 唯一一次顯示完整金鑰的地方。關閉視窗前,請務必同時複製 Key 與上方的 Organization ID,Offision 需要這兩個欄位才能建立連線。

關閉確認畫面前,請將 API Key 與 Organization ID 一併複製保存。

關閉確認畫面前,請將 API Key 與 Organization ID 一併複製保存。

2. 在 Offision 開啟 Neat Pulse

前往 應用市集,在 IoT 監控 分類下開啟 Neat Pulse 圖磚。你也可以從 設備 › 平台整合 開啟同一個設定視窗。

應用市集「IoT 監控」分類下的 Neat Pulse 圖磚。

應用市集「IoT 監控」分類下的 Neat Pulse 圖磚。

3. 新增 Neat Pulse 連接

點擊 新增連接。表單預設開啟 指引 分頁,內附步驟 1 的圖文說明與可轉交 Neat 管理員的 PDF 檔案。切換至 設定 分頁並填寫以下欄位:

欄位填寫內容
名稱用來辨識此連接的名稱(例如 Neat 組織名稱)
組織單位在 Offision 中負責管理這批同步設備的組織單位
API 基本網址除非 Neat 另有指示,請保留預設網址
組織 ID步驟 1 複製的 Organization ID
API 金鑰步驟 1 複製的 Key
輪詢間隔(分鐘)保留預設值。感測器請求間隔會自動調整,此數值不保證讀數的最長經過時間
新增 Neat Pulse 平台表單,貼上的 API 金鑰會自動隱藏。

新增 Neat Pulse 平台表單,貼上的 API 金鑰會自動隱藏。

儲存後,這條連接會顯示在 連接 清單中並亮起綠燈。

4. 同步 Space 與設備

開啟剛建立的連接並點擊 同步。對話框會將該把金鑰可讀取的項目分為兩個區塊:

  • Spaces:Neat Pulse 中的房間清單。
  • 設備:各台裝置的型號、序號、所屬房間與是否在線。執行同步時也會一併寫入每台設備的 IP 與 MAC 位址。

勾選要匯入的房間,並在 連接到 下拉選單指定數據的連結目標:

  • 建立新 IoT 空間:建立獨立的 IoT Space。
  • 使用現有 Space:將讀數併入既有的 IoT Space。
  • 可預約資源:將房間的感測器讀數直接連結至 Offision 的可預約房間。

接著勾選房間內的設備,點擊 同步。

Neat Pulse 同步視窗:上方選擇 Spaces 與連接目標,下方勾選設備。

Neat Pulse 同步視窗:上方選擇 Spaces 與連接目標,下方勾選設備。

5. 檢查設備狀態與感測器數據

在視窗左側切換至 設備,點選任一台已同步設備,確認狀態顯示為 在線。開啟 狀態 分頁,檢查 感測器數據 圖磚是否顯示該型號支援的讀數與測量時間。即使設備顯示 在線,感測器樣本仍可能是較早之前的數據;詳情請參閱讀數更新時機與測量時間。

已同步 Neat 裝置的「狀態」分頁,顯示支援的感測器數據圖磚。

已同步 Neat 裝置的「狀態」分頁,顯示支援的感測器數據圖磚。

點擊同一頁面的 在 Neat Pulse 中開啟,確認能直接開啟 Neat Pulse 主控台中的同一台裝置。若要了解感測器數據如何顯示於房間、預約日曆與看板,請參閱在 Offision 各處查看 Neat 感測器數據。

疑難排解

狀況原因與處理方式
同步預覽載入失敗API 金鑰僅勾選了 Write 權限。請在 Neat Pulse 重新建立同時包含 Read 與 Write 的新金鑰。
Spaces 或 設備 底下沒有任何項目組織 ID 填錯,連到了另一個空白組織。請確認並更新 組織 ID。
已勾選設備卻顯示略過該設備所屬的房間未在 Spaces 中勾選。請一併勾選房間與設備後重新同步。
連接狀態顯示已暫停連續多次輪詢失敗(通常是金鑰已在 Neat Pulse 被撤銷)。請點擊 編輯 貼上有效的新金鑰,儲存後點擊 恢復。
編輯連接時 API 金鑰 欄位顯示空白基於安全考量,系統不會明文顯示已儲存的金鑰。畫面提示留空以保留目前的金鑰。,不需更換時保持空白即可。
設備顯示在線,但缺少預期的感測器圖磚該 Neat 硬體型號未配備該項感測器。請對照各 Neat 型號支援的感測讀數。
感測器圖磚為空白或讀數停止更新請先確認裝置仍在 Neat Pulse 正常回報,且 Offision 連接處於啟用狀態。輪詢成功時未必會有新樣本回傳,請直接檢查讀數的測量時間,而非只等待固定間隔。