連接 Neat Pulse

在 Neat Pulse 建立 API 金鑰,貼進 Offision,再同步會議室與裝置——約十分鐘, 外加一個輪詢週期後數據才會出現。

更新於 2026年8月19日

連接 Neat Pulse 只需要一組憑證和一個對話框:在 Neat 自己的主控台建立 API 金鑰, 貼進 Offision,再選擇要同步哪些會議室與裝置。其餘由 Offision 按排程完成。

需要準備

  • 一個 Neat Pulse 組織,裝置已註冊並正在回報
  • 一個能管理該組織設定的 Neat Pulse 登入帳戶
  • 一個安全存放金鑰的地方——密碼管理器,而不是聊天訊息
  • 約十分鐘,外加一個輪詢週期,第一批讀數才會到

1. 在 Neat Pulse 建立 API 金鑰

前往 signin.pulse.neat.no 登入,從左側選單開啟 Settings。在組織設定接近底部 的位置,開啟 API keys

Neat Pulse 的組織設定,API keys 在接近底部的位置。

Neat Pulse 的組織設定,API keys 在接近底部的位置。

選擇 Create API key,金鑰的名字照它將交給誰來取——一年後有人稽核這份清單時, OffisionTest 1 好懂得多。在 Scope 底下,把 Read 與 Write 兩個都勾選: Read 讓 Offision 拉取會議室與感測數據,Write 讓它之後能重新啟動裝置。Api.Rotate 保持不勾。然後選擇 Create

Read 與 Write 都勾,然後 Create。

Read 與 Write 都勾,然後 Create。

下一個畫面是 Neat 唯一一次顯示金鑰的地方。關閉之前要複製兩個值:Key,以及 它上方的 Organization ID——Offision 兩個都需要,而大家往往只存了金鑰。

唯一顯示金鑰的畫面。把它和 Organization ID 一起保存。

唯一顯示金鑰的畫面。把它和 Organization ID 一起保存。

2. 在 Offision 開啟 Neat Pulse

Neat Pulse 圖磚在應用市集的 IoT 監控分類下;同一個連接也出現在設備平台整合。兩邊開啟的是同一個對話框。

開啟系统集成
應用市集中的 Neat Pulse 圖磚。

應用市集中的 Neat Pulse 圖磚。

3. 新增連接

選擇新增連接。表單開在指引頁——就是步驟 1 那份建立金鑰的逐步教學,收在產品 裡,還附一份 PDF,可以直接交給掌管 Neat 帳戶的人。欄位在設定頁上:

欄位要填什麼
名稱任何能分辨連接的名字——用組織的名稱就很好
組織單位公司裡哪個部分擁有這批同步進來的裝置
API 基本網址除非 Neat 另有指示,保留預設值
組織 ID步驟 1 複製的值,就在金鑰旁邊
API 金鑰金鑰本身
輪詢間隔(分鐘)Offision 多久重讀一次 Neat Pulse——5 是合理的起點
新增 Neat Pulse 平台。貼上時金鑰欄位保持隱藏。

新增 Neat Pulse 平台。貼上時金鑰欄位保持隱藏。

儲存後,連接會出現在連接底下,帶著一顆綠點。

4. 同步 Space 與裝置

開啟連接並選擇同步。對話框列出這把金鑰看得到的一切,分成兩段:Spaces—— Neat 的會議室——與設備,每一項都顯示型號、序號房間,以及是否在線

勾選一間會議室,在連接到底下挑它的讀數要餵給什麼:新增 Space使用現有 Space,或者——讓數據真正派上用場的那個選項——可預約資源,把會議室的感測器 接上你的一間可預約會議室。接著勾選裝置,選擇同步

會議室在上,裝置在下。連接到就是會議室讀數獲得去處的地方。

會議室在上,裝置在下。連接到就是會議室讀數獲得去處的地方。

5. 確認是否成功

在對話框的側欄開啟設備,挑一台——它應該顯示在線。在它的狀態頁上,一個 輪詢間隔之內,感測器數據圖磚會填上那個型號擁有的讀數——bar 或 board 上的人數, 量得到的型號則有溫度與空氣質素。

一台已同步 Neat 裝置的狀態頁,回報著它的感測器組合。

一台已同步 Neat 裝置的狀態頁,回報著它的感測器組合。

接著測反方向:同一頁上的在 Neat Pulse 中開啟應該正好落在 Neat 主控台裡的這一台 裝置上——證明對得上的是識別碼,而不只是名字。讀數從這裡去哪——會議室、預約日曆、 看板——是另一篇文章:在 Offision 各處查看 Neat 感測器數據

出問題時

你看到的狀況常見原因
同步預覽載入失敗金鑰只有 Write——步驟 1 忘了勾 Read。建立一把兩者都有的新金鑰
Spaces 或設備底下什麼都沒列出組織 ID 錯了——這把金鑰開的是另一個空的組織
裝置勾了卻回報略過它們的會議室沒被勾選——會議室必須先同步,裡面的東西才會跟上
連接顯示暫停連續輪詢失敗——通常是金鑰在 Neat Pulse 被撤銷了。修好金鑰(編輯,貼上新的),再選擇恢復
編輯連接時金鑰好像不見了沒有——留空以保留目前的金鑰就是字面的意思
裝置在線,預期的圖磚卻沒有那個型號沒有這個感測器——見各型號對照表
剛同步完圖磚是空的第一次輪詢還沒跑——等一個輪詢間隔