啟用 HubSpot 整合後，會將 HubSpot 的聯絡人、公司與區隔（清單）取入 Lumo，並將 Lumo 的 LINE 好友資料寫入 HubSpot 的聯絡人。同步由 Lumo 自動執行，平常只需留意設定狀態即可運作。無論整合是從 HubSpot Marketplace 還是從 Lumo 的整合精靈開始，同步機制都相同。
資料同步的整體樣貌
HubSpot 與 Lumo 會以互補的方式，同步彼此擅長的資訊。HubSpot 端的聯絡人與公司更新會匯入 Lumo，Lumo 端的 LINE 營運資料則會寫入 HubSpot 的屬性。
| 方向 | 主要內容 |
|---|---|
| HubSpot→Lumo | 姓名、電子郵件、電話號碼等聯絡人資訊、公司資訊、HubSpot 的區隔（清單） |
| Lumo→HubSpot | LINE 的個人資料、標籤、發送狀況等 LINE 營運資料 |
整合後的同步由 Lumo 自動執行。設定的確認與項目的新增，可在 Lumo 的 HubSpot 整合畫面（儀表板、同步資料、設定）進行。
從 HubSpot 匯入 Lumo 的資料
從 HubSpot 匯入 Lumo 的，是用於好友屬性與受眾建立的資訊。
| 資料 | 說明 |
|---|---|
| 名 | 將名字反映至好友資訊 |
| 姓 | 將姓氏反映至好友資訊 |
| 電子郵件 | 同步電子郵件 |
| 電話號碼 | 同步電話號碼 |
| 公司名稱 | 同步聯絡人所屬的公司資訊 |
| HubSpot 的區隔（清單） | 同步後可作為 Lumo 的受眾條件使用 |
預設除了名與姓之外，也會匯入電子郵件與電話號碼。若不需要電子郵件與電話號碼，可在 同步資料 畫面把它們移出同步對象。其他屬性則可於整合後在 同步資料 畫面中個別新增。
電子郵件與電話號碼只會從 HubSpot 匯入，不會從 Lumo 回寫到 HubSpot，因此不必擔心 Lumo 覆蓋 CRM 端的顧客資訊。
這裡匯入的 HubSpot 區隔（清單），可作為群發訊息的受眾條件使用。HubSpot 的區隔（清單）是 HubSpot 端的顧客群組，Lumo 的 受眾 則是篩選發送對象的條件；在 Lumo 的受眾條件中，以 「HubSpot 受眾」 選取。兩者都與好友身上的 標籤 是不同的概念。
從 Lumo 寫入 HubSpot 的資料
為了讓 HubSpot 端也能掌握 LINE 的營運狀況，Lumo 會將 LINE 相關屬性寫入 HubSpot。
| Lumo 的屬性 | 說明 |
|---|---|
| LINE User ID | 將 LINE 的用戶識別碼記錄至聯絡人 |
| LINE 顯示名稱 | 同步 LINE 的顯示名稱 |
| LINE 個人頭像 | 同步 LINE 的個人資料圖片 |
| LINE 加入好友日期 | 記錄成為好友的日期 |
| LINE 追蹤狀態 | 同步加入好友（追蹤）的狀態 |
| LINE 標籤 | 同步好友身上的標籤。在 HubSpot 端改寫的內容也會回到 Lumo |
| LINE Traffic Source | 記錄加入好友的契機。若是透過自訂 QR 碼，會填入該 QR 碼的名稱 |
| LINE Acquisition Route | 記錄首次加入好友的來源（QR 碼、加好友 CTA、Klaviyo 表單、Shopify 顧客帳號等） |
| LINE Acquisition Page | 記錄首次加好友開始的頁面 URL |
| 最後發送名稱、最後發送日期 | 同步最近一次群發訊息的資訊 |
| 最後開啟日期、最後點擊日期 | 同步最近的開啟與點擊狀況 |
寫入的屬性會依整合的 LINE 官方帳號與啟用的功能而異。若啟用群組聊天同步，LINE 群組聊天會同步為 HubSpot 的公司物件。
這裡同步的「LINE 標籤」，是好友身上的 標籤 。它與用來篩選發送對象的 受眾 是兩回事，請避免混淆。
流入來源（LINE Traffic Source）的記錄
透過自訂 QR 碼成為好友的人，該 QR 碼的名稱會留在 HubSpot 的 「LINE Traffic Source」 屬性中。您可以在 HubSpot 端的區隔（清單）或報告中，追蹤好友是從哪個施策增加的。
只會記錄第一次。已經有值的聯絡人，之後即使掃描別的 QR 碼也不會被改寫。若是透過自訂 QR 碼以外的途徑成為好友，則會填入代表該途徑的共通值。
同時也會記錄 「LINE Acquisition Route」（首次加入好友的來源）與 「LINE Acquisition Page」（該次加好友開始的頁面 URL）。這兩者同樣只記錄第一次，之後不會改寫。
欄位回寫
Lumo 的欄位可以回寫到 HubSpot 的聯絡人屬性。會員等級、來店次數等在 Lumo 累積的資訊，也能用在 HubSpot 端的分析與 workflow。
- 在 HubSpot 整合設定的 「欄位回寫」 建立要回寫的欄位對應（mapping）
- 每個對應皆為 Lumo 至 HubSpot 的單向同步，數值變更時會自動更新
- 使用 「批次新增」 可以一次選擇多個欄位，並依前綴（預設值為
lumo_）批次產生 HubSpot 端的內部名稱。建立後會一次套用既有數值 - 文字、數字、日期、日期時間等各種類型的欄位都可以回寫
LINE 標籤的雙向同步
LINE 標籤會在 Lumo 與 HubSpot 之間雙向往來。在 Lumo 加上或移除的標籤會寫入 HubSpot，在 HubSpot 端改寫的內容也會回到 Lumo 的好友身上。
用來儲存標籤的 HubSpot 端屬性，是整合時自動建立的 「LINE user tags」 。若以逗號分隔改寫這個值，該好友在 Lumo 的標籤就會整組換成 HubSpot 的值。由於以 HubSpot 端的值為準，只加在 Lumo 的標籤會被移除。
- 若寫入 Lumo 還沒有的名稱，就會新建該標籤並加上
- 若寫入已停用的標籤名稱，就會讓該標籤重新啟用
- 若一位聯絡人同時連結到多個 LINE 官方帳號的好友，由於無法判斷指的是哪一位好友，因此不會反映
- 標籤名稱中含有逗號的好友也不會反映。因為在以逗號分隔的值中，無法把該名稱還原回去
想在 HubSpot 的區隔（清單）或工作流程中批次更新標籤時很方便。更新後的結果，可以直接用在 Lumo 的受眾與群發篩選上。
檢視同步項目
匯入的項目可於整合後在 同步資料 畫面隨時調整。建議一開始只保留基本項目，再依營運需求逐步增加。
新增項目
- 在 Lumo 的 HubSpot 整合畫面開啟 同步資料
- 從 「新增 HubSpot 屬性」 選擇要同步的屬性
- 新增後，HubSpot 與 Lumo 何者的值優先，由同步規則自動決定
用過的屬性會自動加入同步對象
在群發、自動旅程、受眾中使用 HubSpot 屬性時，該屬性會自動加入同步對象。即使沒有先在同步資料畫面新增，從開始使用的那一刻起就會收到值。
直接寫在訊息內文中的 {{ hubspot.屬性名稱 }} 這類插入項目，也會在儲存時讀取並加入對象。新增的屬性會連同已存在的聯絡人一起回溯匯入，數值到齊約需數分鐘至 15 分鐘。
若想由管理端統一管理同步項目，請把 同步資料 畫面的 「使用時自動新增」 關閉。關閉後，同步屬性就只剩下從這個畫面手動新增這一種方式，已在同步中的屬性會照舊保留。能切換這個開關的只有工作區的管理員。
同步資料畫面可掌握的資訊
| 欄位 | 說明 |
|---|---|
| HubSpot 屬性 | HubSpot 端的屬性名稱 |
| Lumo | 對應的 Lumo 端項目 |
| 同步規則 | 以哪一邊的值為準（以更新時間較新者為準） |
| 使用位置 | 使用該屬性的群發、自動旅程、受眾、提問動作與收件匣卡片。若哪裡都沒用到，會顯示 「未使用」 |
| 狀態 | 該項目的同步狀態 |
想刪除使用中的屬性時，會出現確認訊息。刪除後，使用該屬性的群發或自動旅程就不會顯示值。刪除前請先確認 「使用位置」 。
HubSpot 區隔（清單）的同步
HubSpot 的區隔（清單）會同步到 Lumo，可作為群發訊息的受眾條件使用。HubSpot 已將原本的「清單」改稱為「區隔（清單）」。
| 區隔（清單）的種類 | 說明 |
|---|---|
| 依條件自動更新（主動） | 同步依條件自動更新成員的區隔（清單） |
| 手動登錄（靜態） | 手動登錄的區隔（清單）也會同步 |
同步後的區隔（清單），可在 Lumo 的受眾條件 「HubSpot 受眾」 中選取。只要先在 HubSpot 端整理好區隔（清單），在 Lumo 設定發送目標時就能直接沿用。
剛選為發送對象的區隔（清單）會標上 「（未同步）」 ，收件人預覽也可能一直是 0 人。這只是還沒匯入成員而已，顯示 「正在同步 HubSpot 名單成員…」 的期間請稍等一下。同步完成後就會顯示人數。
同步的時機
同步會在首次、自動、手動 3 種時機執行。首次之後 Lumo 會持續自動更新，基本上不需要手動操作。
| 時機 | 說明 |
|---|---|
| 首次同步 | 整合完成後，一次匯入目標資料 |
| 自動同步 | 整合後由 Lumo 定期同步聯絡人與區隔（清單） |
| 手動重新同步 | 透過 儀表板 的 「重新同步屬性」 按鈕，可在任意時機執行 |
資料量較多時，首次同步與重新同步可能需要幾分鐘才能完成。
確認同步狀態
同步是否順利，可在 儀表板 的同步狀態確認。各狀態的顯示與意義如下。
| 顯示 | 意義 |
|---|---|
| 正常 | 已同步最新的資料 |
| 同步中 | 正在同步資料 |
| 套用中 | 正在套用同步結果 |
| 失敗 | 上次同步失敗。請於同步記錄查看詳細資訊 |
儀表板 也提供 「重新同步屬性」 按鈕，調整設定後可手動重新執行。
同步記錄
過去的同步結果可在 儀表板 的同步記錄確認，以列表回顧每一次的執行內容。
| 項目 | 說明 |
|---|---|
| 時間 | 執行同步的日期時間 |
| 狀態 | 同步完成、重新同步中、重新同步失敗等狀態 |
| 聯絡人 | 同步的聯絡人筆數 |
| 清單 | 同步的區隔（清單）數量 |
| 錯誤 | 失敗時的訊息 |
若錯誤持續發生，請先確認同步記錄中的訊息，再嘗試重新同步。
收件匣同步處理的資料
收件匣同步是選用功能。只有在需要使用時額外連接，即可在 HubSpot 的收件匣與客服中心接收 LINE 的對話並直接回覆。即使不連接，聯絡人與區隔（清單）的同步仍可正常使用。
| 資料 | 說明 |
|---|---|
| 訊息內容 | 將 LINE 的對話同步至 HubSpot 的收件匣 |
| 圖片與檔案附件 | 將 LINE 收到的圖片與檔案附加到 HubSpot 的對話，並將從 HubSpot 送出的圖片與檔案傳送到 LINE |
| 收發時間 | 反映在 HubSpot 端的對話紀錄 |
| 連接通道資訊 | 保留對話來自哪個 LINE 官方帳號 |
收件匣同步的連接從 HubSpot 端的收件匣設定開始，連接後的狀態可在 Lumo 的 設定 畫面確認。
停止同步後的處理
解除整合或移除應用程式後，新的同步會停止，但已建立的資料會保留下來。
- 解除整合後，新的聯絡人同步、區隔（清單）同步與 HubSpot Workflow 的 LINE 動作會停止
- 只解除收件匣同步時，新的對話同步會停止。HubSpot 端的通道設定不會自動刪除
- 已在 HubSpot 建立的屬性、屬性值與過去的對話紀錄不會自動刪除
- 若想清除不需要的資料，請在 HubSpot 端手動刪除
遇到問題時
同步沒有反映時，先確認資料量與整合狀態，比較容易釐清原因。
| 症狀 | 確認事項 |
|---|---|
| 同步很慢 | 聯絡人數量多時，首次同步需要較長時間。請稍候片刻再查看 儀表板 |
| 聯絡人沒有同步 | 確認 HubSpot 帳戶中是否已登錄聯絡人 |
| 錯誤持續發生 | 查看同步記錄的訊息，並嘗試 「重新同步屬性」 。若仍未改善，請聯絡客服 |
| 收件匣沒有顯示對話 | 在 設定 畫面確認收件匣同步是否已連接、連接的 LINE 官方帳號是否正確 |
說明中心：https://guide.lumo.cx/hc/ja
聯絡我們：https://www.littlehelp.co.jp/contact