在 Coexistence 號碼上將 WhatsApp 連接到 Bitrix24 CRM

n8n 如何與 Bitrix24 溝通？

透過傳入 Webhook。在 Bitrix24 中，它不是接收端，而是一種憑證。您在 Bitrix24 的開發者資源中建立它，選擇它可使用的權限範圍，然後取得一個 URL，其中包含您的入口網站地址、建立者的用戶 id 和一組密鑰。在該 URL 後加上方法名稱，就會以該用戶的身分及權限呼叫 REST API。

因此在 n8n 中，每個 Bitrix24 步驟都是一個 HTTP Request 節點，向該 URL 加上 crm.lead.add.json 之類的方法發出 POST。您無須完成 OAuth 流程，也無須發布應用程式。請只給予 Webhook CRM 權限範圍，並使用其權限涵蓋工作流程所需潛在客戶和聯絡人的用戶來建立它，因為 Bitrix24 是以該用戶的身分檢查存取權限。

工作流程會呼叫哪些 Bitrix24 方法？

共三個，在 n8n 的 Webhook 節點收到來自 Meta 的訊息後依次執行。

以 type 為 PHONE 和發送者號碼呼叫 crm.duplicate.findbycomm，會回傳持有該號碼的所有潛在客戶、聯絡人和公司的 id。這是正確的查找方式，因為它同時搜尋三者，而且專為比對通訊方式而設計，不是比對文字欄位。

若沒有任何結果，crm.lead.add 會以 WhatsApp 個人檔案名稱作標題、號碼填入電話欄位，建立一個潛在客戶。接著 crm.timeline.comment.add 把訊息文字寫成該記錄的備註，需要 ENTITY_TYPE、ENTITY_ID 和 COMMENT。備註會與通話和電郵一同顯示在記錄的時間線上，正是銷售人員慣常查看的位置。

POST https://yourcompany.bitrix24.com/rest/1/<secret>/crm.duplicate.findbycomm.json
{ "type": "PHONE", "values": ["14155550188"] }

POST .../crm.lead.add.json
{ "fields": { "TITLE": "WhatsApp: Maria", "PHONE": [{ "VALUE": "14155550188", "VALUE_TYPE": "MOBILE" }] } }

POST .../crm.timeline.comment.add.json
{ "fields": { "ENTITY_TYPE": "lead", "ENTITY_ID": 4211, "COMMENT": "do you have anything friday?" } }

速率限制如何影響工作流程？

Bitrix24 以漏桶方式計算 REST 呼叫。每次請求都會增加計數器，計數器每秒按固定速率減少，一旦超過閾值，下一個請求就會收到 503 和 QUERY_LIMIT_EXCEEDED。在 Enterprise 方案中，計數器每秒減少 5，閾值為 250；其他方案每秒減少 2，閾值為 50。

每則傳入訊息需要兩到三次呼叫，所以穩定的少量訊息絕不會觸及限制。突發大量訊息則會：五十位客戶在一分鐘內回覆同一則訊息範本，最多就是 150 次呼叫。請將 HTTP Request 節點設為失敗時短暫等待後重試，並讓工作流程一次只執行一個，這樣突發的請求會逐步流入 Bitrix24，而不是被拒於門外。

在手機上輸入的回覆會傳到 Bitrix24 嗎？

可以。在 Coexistence 號碼上，WhatsApp Business 應用程式仍然正常運作。有人從該應用程式回覆時，Meta 會把發出訊息的回聲，以 smb_message_echoes 欄位傳送到同一個 Webhook 目的地。

工作流程中的第二個分支以處理傳入訊息的相同方式處理這些回聲，並把備註標記為外發。記錄上就能按順序看到完整對話，包括客戶的發言和商店的回覆。

至於工作流程自己透過 Cloud API 發出的回覆，在發出時已經在工作流程手上，所以請在那一刻就記錄下來，無須等待 Webhook 回傳。

常見錯誤

• 把傳入 Webhook URL 貼到用戶端程式碼或共用文件中。URL 內的密鑰擁有該 Webhook 獲授予的所有權限範圍。
• 使用看不到全部潛在客戶的用戶來建立 Webhook。這樣查找會漏掉記錄，工作流程便會建立重複的記錄。
• 突發大量呼叫卻不設重試。Bitrix24 會回應 503 QUERY_LIMIT_EXCEEDED，這些訊息就永遠不會進入時間線。

常見問題

繼續閱讀