從 Coexistence 號碼將 WhatsApp 訊息記錄到 HubSpot

WhatsApp 訊息如何記錄到 HubSpot 聯絡人上？

分三個步驟。Meta 將訊息傳送到您為該號碼設定的 Webhook 目的地，在這裡就是 n8n 的 Webhook 節點。工作流程會在 HubSpot 中以發送者的電話號碼搜尋聯絡人，找不到就建立新的。接着建立一筆通訊記錄，寫入訊息文字，並與該聯絡人建立關聯。

HubSpot 正是為這種情況設計了 Communications 物件。它代表在 HubSpot 以外收發的 WhatsApp、LinkedIn 或 SMS 訊息，並像已記錄的通話或電郵一樣顯示在記錄的時間軸上。必填屬性包括頻道類型、設為 CRM 的 hs_communication_logged_from、內文、擁有者和時間戳記。

整個做法無須安裝 HubSpot 市集的應用程式。n8n 的 HTTP Request 節點可直接沿用您為 HubSpot 節點設定好的 HubSpot 憑證，每則訊息只需一次 POST 呼叫。

{
  "properties": {
    "hs_communication_channel_type": "WHATS_APP",
    "hs_communication_logged_from": "CRM",
    "hs_communication_body": "do you have anything friday?",
    "hubspot_owner_id": "75480934",
    "hs_timestamp": "2026-10-11T14:20:00.000Z"
  }
}

在手機上輸入的回覆也會被記錄嗎？

可以，而這正是 Coexistence 號碼帶來的好處。當團隊成員從 WhatsApp Business 應用程式回覆時，Meta 會將該則發出訊息的回顯傳送到同一個 Webhook 目的地。工作流程同時處理收到的訊息和回顯，就能把對話的雙方都寫入時間軸，業務人員在 HubSpot 打開聯絡人時，既看到客戶的提問，也看到商戶的回覆。

按 Webhook 欄位分流。收到的訊息出現在 messages 之下，手機上的回覆則出現在 smb_message_echoes 之下。把前者記錄為已接收，後者記錄為已傳送，時間軸便會依序顯示。

工作流程本身透過 Cloud API 傳送的回覆，它自己已經知道內容，因此請在傳送的當下記錄，無須等待 Webhook。

HubSpot 自家的 WhatsApp 收件匣頻道又如何？

那是另一種整合。HubSpot 的對話收件匣會將 WhatsApp 號碼直接連接到 HubSpot，而其知識庫指明，該號碼不得連接到其他 WhatsApp 整合。此功能適用於 Marketing Hub 或 Service Hub 的 Professional 及 Enterprise。

透過 EasyCoexistence 連接的號碼則走相反的路徑：Meta 將 Webhook 傳送到您自己擁有的 URL，HubSpot 則透過 API 接收記錄。對話由手機或您的工作流程回覆，HubSpot 作為記錄系統，把歷史紀錄保存在聯絡人、交易或工單之下。

發出呼叫的私人應用程式或憑證，需要具備聯絡人的寫入權限範圍。工作流程本來就需要這個權限才能建立聯絡人，所以不必額外申請。

工作流程應如何將發送者配對到聯絡人？

以電話號碼配對，並在搜尋前先標準化。Meta 傳來的發送者是含國碼、不含加號的純數字，例如 14155550188。HubSpot 的聯絡人由人手輸入，同一個人可能存成 +1 415 555 0188 或 (415) 555-0188。

可靠的做法是另設一個聯絡人屬性，專門存放純數字號碼，在工作流程建立聯絡人時寫入，並以該屬性搜尋。直接搜尋自由文字的電話欄位，只對工作流程建立的聯絡人有效，會漏掉許多人手建立的聯絡人，結果就產生重複。

如果搜尋沒有結果，就建立聯絡人，以 Webhook 負載中的個人檔案名稱作為名字，並在兩個欄位都填入純數字號碼。之後可由人手合併或改名，而對話已經附在聯絡人上了。

常見錯誤

• 只記錄收到的訊息。時間軸上只有提問而沒有回答，因為在手機上輸入的回覆是以 smb_message_echoes 事件送達的。
• 沒有設定 hs_communication_logged_from。透過 API 建立通訊記錄時，HubSpot 要求它必須為 CRM。
• 以原始電話欄位搜尋聯絡人。Meta 的純數字格式很少與人手輸入的內容相符，每次找不到都會產生重複的聯絡人。

常見問題

繼續閱讀