HubSpot 整合常見問題

本文整理了 HubSpot 整合在設定、同步與疑難排解上的常見問題。整合設定本身可以交給代理處理：只要在聊天中告訴它「請協助我設定 HubSpot 整合」，它就會引導必要步驟並協助完成設定。若想手動確認或變更，請參考各段落的操作步驟。

HubSpot 的哪些資料會與 Lumo 同步？

HubSpot 的聯絡人資訊會匯入 Lumo，Lumo 的 LINE 相關資料則會寫入 HubSpot 的聯絡人屬性。由於採雙向同步，HubSpot 與 Lumo 兩邊都能掌握相同的顧客資訊。

剛完成整合時，會匯入名、姓、電子郵件與電話號碼。公司名稱與其他 HubSpot 聯絡人屬性，請於連接後從同步設定中只挑選需要的項目加入。Lumo 端則會將 LINE User ID、LINE 顯示名稱、LINE 追蹤狀態、LINE 標籤、最後發送日期等 LINE 相關屬性寫入 HubSpot。

同步項目的確認、新增與刪除，請在 HubSpot 整合的 「同步資料」 畫面進行。

同步項目可以事後再新增嗎？

可以。連接後可隨時在 「同步資料」 畫面新增或刪除。初始狀態的對象只有基本項目，需要的屬性請自行挑選加入。

新增步驟

1. 開啟 HubSpot 整合的 「同步資料」 畫面。
2. 點擊 「新增 HubSpot 屬性」 。
3. 選擇要同步的 HubSpot 屬性，點擊 「新增屬性」 。

若在群發、自動旅程、受眾中使用了 HubSpot 屬性，即使不走這些步驟也會自動加入同步對象。想只保留手動新增時，請把 「同步資料」 畫面的 「使用時自動新增」 關閉。能切換的只有工作區的管理員。

同步規則採用「以更新時間較新者為準」。當 HubSpot 與 Lumo 的值不同時，會以較晚更新的一方為準。

HubSpot 整合與 LINE 官方帳號的「連接」有什麼不同？

讓 LINE 官方帳號可以在 Lumo 使用的操作稱為 連接 ，將 HubSpot 等外部服務與 Lumo 串起來的操作則稱為 整合 。使用 HubSpot 的前提，是目標 LINE 官方帳號已連接至 Lumo。

HubSpot 整合是將已連接的 LINE 官方帳號與 HubSpot 帳戶綁定的操作。若 LINE 官方帳號尚未加入 Lumo，請先在 Lumo 完成 LINE 官方帳號的連接，再開始 HubSpot 整合。

可以從 HubSpot Marketplace 或 Lumo 哪一邊開始整合？

兩邊都可以。只是入口不同，整合後使用的設定是相同的。

從 HubSpot Marketplace 開始時

從 HubSpot 的應用程式安裝畫面進行。過程中登入 Lumo，選擇要整合的 LINE 官方帳號後，在 HubSpot 核准必要權限。

從 Lumo 開始時

從 Lumo 的整合精靈進行。選擇 LINE 官方帳號後，直接進入 HubSpot 的驗證流程。設定可以交給代理處理：在聊天中告訴它「請協助我設定 HubSpot 整合」，它就會提供引導。

HubSpot 的既有聯絡人會自動與 Lumo 的好友配對嗎？

只有在條件符合時才會自動比對。定期同步不會拿電子郵件對 HubSpot 的所有既有聯絡人逐一比對。

會自動比對的情況有以下 3 種。

其他好友請設定 ID 連結的方式來綁定。也可以從 HubSpot 的區隔（清單）中的聯絡人匯入 LINE User ID。詳情請參考「可以從 HubSpot 的區隔（清單）匯入 LINE User ID 嗎」。

可以從 HubSpot 的區隔（清單）匯入 LINE User ID 嗎？

可以。系統會讀取 HubSpot 區隔（清單）內聯絡人的 LINE User ID，並與 Lumo 的好友綁定。請在 HubSpot 整合的 「ID 連結」 分頁中的 「從受眾進行 ID 連結」 進行設定。

設定項目

指定同步來源受眾後，系統會定期從 HubSpot 匯入既有的 LINE User ID。移除指定後，匯入即會停止。

可以從 Marketing Email 進行 ID 連結嗎？

可以。將整合用 URL 放入 HubSpot 的 Marketing Email 發送後，收件人透過郵件內的按鈕完成 LINE 登入，ID 連結即告成立。

整合用 URL 由 QR Code 的 ID 連結設定產生，並加上 HubSpot 的 Personalization Token，使其替換為每位聯絡人的值。URL 請以按鈕或圖片的連結形式插入。Personalization Token 只會在 HubSpot 的 Marketing Email 中被替換，從外部郵件工具或測試發送無法完成連結。

可以從以 LINE 發送的 HubSpot 表單進行 ID 連結嗎？

可以。在訊息發送或自動發送訊息所傳送的 HubSpot 表單 URL 上，加上傳遞 LINE User ID 的查詢參數後，表單送出的同時 ID 連結即告成立。

在訊息的建立畫面輸入 HubSpot 表單的 URL 後，會自動顯示要加上的查詢參數範例。表單端請先加入 LINE User ID 屬性的隱藏欄位。由在 LINE 收到訊息的本人送出表單後，LINE User ID 會寫入聯絡人，Lumo 會自動完成綁定。

可以從網站上設置的 HubSpot 表單送出進行 ID 連結嗎？

可以。網站上的 HubSpot 表單送出後，可在完成訊息或完成頁面顯示 LINE 連結的 QR Code 或按鈕，並以送出的電子郵件與聯絡人進行 ID 連結。請在 HubSpot 整合的 「ID 連結」 中，將 「從表單送出進行 ID 連結」 的 「啟用」 切換為開啟，並將 「LP 安裝程式碼」 加入表單的頁面。

若表單送出後會移動到其他頁面，也請將 「完成頁面安裝程式碼」 加入完成頁面（僅限與表單頁面相同網域）。連結完成時的回覆訊息與前往頁面，可在自動建立的 QR Code 「HubSpotフォーム連携」 （HubSpot 表單連結）的設定中變更。新版 HubSpot 表單（iframe 嵌入）請使用 HubSpot 端的 「Developer code」 嵌入程式碼。以此方式連結的好友，其加入好友的來源會記錄為 「HubSpot 表單」 。

發送對象選了 HubSpot 的區隔（清單），收件人卻是 0 人

因為剛選好的區隔（清單）還沒匯入成員。等同步結束後就會顯示人數。

剛選為發送對象的 HubSpot 區隔（清單）會標上 「（未同步）」 ，收件人預覽會顯示 「正在同步 HubSpot 受眾成員…」 。這段期間人數會一直是 0 人。等同步結束後重新開啟畫面，就能確認收件人的人數。

若等了一陣子仍是 0 人，請確認 HubSpot 端的區隔（清單）中是否有聯絡人。若仍未改變，請在 HubSpot 整合的儀表板確認同步記錄與錯誤內容。

發生同步錯誤時該怎麼辦？

請在整合畫面確認錯誤內容，排除原因後手動重新同步。若錯誤持續發生，請聯絡客服。

確認與重新同步的步驟

1. 在 HubSpot 整合的畫面確認同步狀態與同步記錄。同步失敗時，狀態會顯示為 「失敗」 ，同步記錄中會留下錯誤內容。
2. 排除錯誤的原因。
3. 點擊 「重新同步屬性」 ，並在確認對話框中選擇 「重新同步」 。

提出重新同步請求後，資料可能需要幾分鐘才會反映。

在 HubSpot 需要哪些權限？

需要可安裝 HubSpot 應用程式的權限。要核准的權限分為必定核准的項目，以及依所用功能選擇性核准的項目。

必定核准的是聯絡人、公司、區隔（清單）、交易結構的讀取與寫入，交易與客服工單的讀取與寫入，負責人與使用者、團隊的讀取，Workflow（自動化），以及時間軸的寫入。交易與客服工單的權限用於在收件匣顯示這些紀錄、當場建立與編輯，以及自動指派負責人。自動同步不會從 Lumo 端改寫交易或客服工單。

選擇性核准的是收件匣同步所用的對話與檔案權限，以及使用 HubSpot 產品建立內容饋給、或以未結帳購物車與訂單為契機發送時所用的產品、購物車、明細、訂單讀取權限。用不到的功能不核准也沒問題。

選擇帳戶後，HubSpot 端會要求核准必要權限。即使從 HubSpot Marketplace 開始，要作為整合對象的 LINE 官方帳號也必須事先連接至 Lumo。

可整合的 LINE 官方帳號數量有上限嗎？

一個 HubSpot 帳戶最多可整合 30 個 LINE 官方帳號。整合多個 LINE 官方帳號時，各帳號會分別獨立管理。

從 CONNECT 遷移時的 HubSpot 整合切換，我們會依個別狀況提供協助，請洽詢客服窗口。全新開始的話可直接進行整合。

可以從 HubSpot 的 Workflow 發送 LINE 訊息嗎？

可以。您可以在 HubSpot 的 Workflow 中加入 LINE 動作。可用的動作有 4 個： 「Send LINE message」（發送 LINE 訊息）、 「Send LINE notification message」（發送 LINE 通知訊息）、 「Update LINE rich menu」（更新 LINE 圖文選單）與 「ID linkage by form submission」（透過表單送出進行 ID 連結）。LINE 訊息的發送內容可從已儲存在 Lumo 的自動化訊息，或在 HubSpot 上輸入的內容中擇一。

使用自動化訊息時，請先選擇發送來源的 LINE 官方帳號。系統會依所選帳號，顯示可使用的自動化訊息選項。LINE 訊息也能從交易或工單的 Workflow，發送給關聯的聯絡人。各動作的設定項目，請參考HubSpot 工作流程可用的 LINE 動作一文。

HubSpot 的收件匣同步是必須的嗎？

不是，並非必須。即使不使用收件匣同步，聯絡人同步、區隔（清單）同步與 Workflow 的 LINE 動作仍可使用。

只有在想於 HubSpot 的收件匣或客服中心接收 LINE 對話並直接回覆時，才需要設定收件匣同步。圖片與檔案的收發也都支援。連接從 HubSpot 的收件匣設定開始，完成後在 Lumo 「設定」 的 「同步與自動化」 中的 「收件匣同步」 確認連接狀態。在 Lumo 端解除後，新的對話同步會停止，但 HubSpot 端的通道設定不會自動刪除。

為什麼在 HubSpot 內開啟畫面時會被要求登入 Lumo？

在 HubSpot 內開啟 Lumo 的畫面時，Lumo 端也需要確認驗證狀態。若工作階段已逾期，就會被要求登入。

此時請重新登入 Lumo，再重新開啟畫面。在收件匣連接的畫面也相同，登入後再選擇要連接的 LINE 官方帳號。

也會寫入 HubSpot 的交易或客服工單嗎？

不會。目前的整合不會寫入交易（Deal）或客服工單（Ticket）。寫入對象是聯絡人屬性（以及啟用公司物件同步時的公司物件）。

必要時可能會參照相關資訊，但不會更新交易或客服工單的內容。

任務則另當別論。啟用 「自動建立任務」 後，會以收到好友訊息為契機，自動建立指派給聯絡人負責人的 HubSpot 任務。預設為關閉。未設定負責人的聯絡人不會建立任務。AI 代理或 Lumo 自動旅程自動回覆的訊息不會建立任務。若想在加入好友等任意時機建立任務，也可以使用 Lumo 自動旅程的動作 「建立HubSpot任務」 。

解除整合或移除安裝後，HubSpot 的資料會自動刪除嗎？

Lumo 端的整合解除，與 HubSpot 端殘留資料的刪除是不同的操作。即使解除整合，已在 HubSpot 建立的資料也不會自動消失。

解除整合後，從 HubSpot 同步的聯絡人資料與顧客的 ID 連結資訊會被刪除，新的同步與 Workflow 執行也會停止。另一方面，已在 HubSpot 建立的自訂屬性、已寫入的值與過去的對話紀錄會保留在 HubSpot 端。若不需要，請在 HubSpot 端手動刪除。重新整合後，當顧客再次進行 ID 連結時，綁定會重新建立。

LINE User ID 的匯入中途停止時該怎麼辦？

請確認匯入狀況，若顯示錯誤，請先確認內容再重新執行。

請在 HubSpot 整合的畫面確認同步記錄與錯誤內容，排除原因後重新執行匯入。若問題仍未解決，請聯絡客服。

連接中斷、被要求重新連接時該怎麼辦？

HubSpot 的授權失效時，畫面會顯示重新連接的通知。從按鈕重新連接後，同步會自動恢復。

HubSpot 的授權失效時，聯絡人同步與 ID 連結等自動同步會停止，並顯示 「需要重新連接HubSpot」 的通知。從 「重新連接HubSpot」 重新連接後，同步會自動恢復。在整合的 「設定」 執行 「連接檢查」 的 「重新檢查」 並通過時，這則通知也會自動消失。若重新連接後仍未解決，請聯絡客服。

如何聯絡客服？

請利用 Lumo 說明中心或聯絡窗口。