自動把 WhatsApp 對話傳送到您的 CRM
要自動把 WhatsApp 對話傳送到 CRM,可讓收到的訊息以已簽署的 webhook 傳送到您的後端或工作流程工具,依電話號碼找到或建立聯絡人,再把該訊息以活動形式記錄在該聯絡人之下。請以 WhatsApp 訊息 ID 作為活動的唯一鍵,這樣重試的傳送便會更新同一筆記錄,而不會建立第二筆。
easyCoexistence 透過 Coexistence,把您在應用程式中保留的 WhatsApp Business 號碼連接到 Meta 的 Cloud API。
已轉發 POST 的標頭載有傳送 ID,每次重試該傳送時都相同。
7 次轉發嘗試的時間跨度,大約在 1、5、30、120、360 及 1,440 分鐘後。
「Call my webhook」步驟只會呼叫您的 URL 一次;超時或錯誤會令執行失敗,並電郵通知您。
業務範圍內的用戶 ID,例如 US.13491208655302741918,會放在 user_id 及 from_user_id 中,與電話號碼並列或取代電話號碼。
自動化執行記錄會保留多久,涵蓋觸發訊息、回覆及每一步驟。
哪些事件應傳送至 CRM?
在 Coexistence 號碼上,一段對話由三類訊息組成,並經由兩條路徑傳送。每個號碼設定的 Forward URL 會傳送客戶發出的訊息,以及您的團隊在 WhatsApp Business 應用程式中輸入的訊息,格式為 Meta 的原始事件,並會重試直至 CRM 回應為止。自動化發出的回覆會經 API 送到 Meta,Meta 只回報傳送狀態,不附文字;要記錄其內容,請以「Call my webhook」步驟結束自動化,該步驟的歷史記錄會包括自動化剛發送的回覆。一個端點可同時接收兩者:X-EC-Event 標頭對步驟回報 automation.step,對轉發則回報 Meta 的欄位名稱。
如何把 WhatsApp 發送者配對到 CRM 聯絡人?
以電話號碼配對,並先作標準化處理。WhatsApp 傳送的是帶國家區號、不含加號的數字,例如 5511987654321,轉發時位於 messages[].from,webhook 步驟則位於 contact.wa_id。人手輸入的 CRM 記錄可能是 +55 11 98765-4321 或 (11) 98765-4321,因此請另設一個屬性存放純數字格式,並以此搜尋。若無任何配對,則以 WhatsApp 個人資料名稱及號碼建立聯絡人。
也請儲存業務範圍內的用戶 ID。擁有 WhatsApp 用戶名稱、且 30 天內未與您的號碼聯絡的用戶,可能只會在 from_user_id 及 contacts[].user_id 中帶有 BSUID。轉發會帶有該 ID;webhook 步驟則帶有電話號碼。
每筆 CRM 記錄應包含什麼?
一個附有識別碼的聯絡人,以及每則訊息一筆活動,內含方向、文字、時間及唯一鍵。下方的對照表顯示兩條路徑中各值的位置。轉發中的訊息時間是 Meta 提供的 Unix 秒數;webhook 步驟則傳送 ISO 日期。媒體在轉發時以類型及 ID 送達,在 webhook 步驟則以 [image] 等佔位符配以說明文字送達,因此請記錄簡短標籤,而不必嘗試儲存檔案。
| Forwarded event (value is Meta's) | Call my webhook step | |
|---|---|---|
| Contact phone | messages[].from | contact.wa_id |
| Contact name | contacts[].profile.name | contact.name |
| BSUID | contacts[].user_id, messages[].from_user_id | Not sent |
| Activity text | text.body, or the media type | message.text and history[].text |
| Direction | messages = in, smb_message_echoes = out | history[].direction: in, out or echo |
| Time | timestamp, Unix seconds | message.at and history[].at, ISO 8601 |
| Unique key | messages[].id (wamid) | message.id; run_id for history entries |
如何避免重試造成重複記錄?
先快速回應,再為所有記錄加上鍵。若轉發在 10 秒內未收到 2xx 回應,會以相同的 X-EC-Delivery ID 重試,最多 7 次;因此若 CRM 呼叫需時 12 秒,除非活動是以 wamid 進行 upsert,否則會執行兩次。請先回覆 200,再於佇列或背景工作中處理 CRM 作業。
webhook 步驟不會重試,而 Meta 自身的重複傳送會在自動化執行前被過濾,因此每則訊息最多只會呼叫您一次。其歷史記錄項目不含訊息 ID:自動化回覆請以 run_id 加上其位置作鍵。來自 Try it 的測試會帶有 dry_run true 及範例聯絡人 15550000000;請略過這些事件,使測試執行不會建立任何 CRM 記錄。
Node.js 中的接收端是怎樣的?
一條 Express 路由同時處理兩種事件。它讀取原始主體,依 X-EC-Event 標頭選擇密鑰,驗證 X-EC-Signature,立即回覆 200,並把工作交給背景函式。crm 物件代表您的 CRM API 客戶端:以純數字電話號碼對聯絡人進行 upsert,並以其唯一鍵對活動進行 upsert。同一結構亦適用於 n8n 工作流程,以 Code 節點處理簽名,之後接上您的 CRM 節點。
import express from "express";
import crypto from "node:crypto";
const FORWARD_SECRET = process.env.EC_FORWARD_SECRET; // the number's, shown once with the Forward URL
const STEP_SECRET = process.env.EC_STEP_SECRET; // the automation's Signing secret
function signed(req, secret) {
const m = /^t=(\d+),v1=([0-9a-f]{64})$/.exec(req.get("X-EC-Signature") || "");
if (!m || Math.abs(Date.now() / 1000 - Number(m[1])) > 300) return false;
const mac = crypto.createHmac("sha256", secret).update(m[1] + "." + req.body).digest();
return crypto.timingSafeEqual(mac, Buffer.from(m[2], "hex"));
}
const app = express();
app.post("/whatsapp/crm", express.text({ type: "application/json" }), (req, res) => {
const kind = req.get("X-EC-Event"); // automation.step, or Meta's field name for a forward
if (!signed(req, kind === "automation.step" ? STEP_SECRET : FORWARD_SECRET)) return res.status(401).end();
res.json({}); // no reply field: nothing is sent to the customer
handle(kind, JSON.parse(req.body)).catch(console.error);
});
async function handle(kind, body) {
if (kind === "messages") {
for (const m of body.value.messages ?? []) { // statuses are skipped
const c = (body.value.contacts ?? []).find((x) => x.wa_id === m.from);
const contact = await crm.upsertContact({ phone: m.from, bsuid: m.from_user_id, name: c?.profile?.name });
await crm.upsertActivity({ key: m.id, contact, direction: "in", text: m.text?.body ?? "[" + m.type + "]", at: new Date(m.timestamp * 1000) });
}
} else if (kind === "smb_message_echoes") {
for (const m of body.value.message_echoes ?? []) {
const contact = await crm.upsertContact({ phone: m.to, bsuid: m.to_user_id });
await crm.upsertActivity({ key: m.id, contact, direction: "out", text: m.text?.body ?? "[" + m.type + "]", at: new Date(m.timestamp * 1000) });
}
} else if (kind === "automation.step" && !body.dry_run) {
const contact = await crm.upsertContact({ phone: body.contact.wa_id, name: body.contact.name });
const sentAfter = body.history.filter((h) => h.direction === "out" && h.at >= body.message.at);
for (const [i, h] of sentAfter.entries()) {
await crm.upsertActivity({ key: body.run_id + ":" + i, contact, direction: "out", text: h.text, at: new Date(h.at) });
}
}
}
app.listen(3000);CRM 能否根據 AI 所得資料更新潛在客戶?
可以,在您的工作流程中實現。隨「Call my webhook」步驟送達的對話,包含您的 AI 提出的問題及客戶的回答,因此 n8n 中的模型節點或後端的呼叫,可以提取需求、預算、時間或地點,寫入潛在客戶的欄位,再更新其階段。不要回傳回覆,因為客戶已收到 AI 的訊息。當工作流程判定某潛在客戶值得致電,即可為業務人員建立任務,或通知團隊。也可以讓 easyCoexistence 來提取:代理或「AI 儲存詳細資料」步驟會把需求、預算和時間寫入聯絡人的欄位,而「Call an API」步驟可以在其內容中使用 {{contact.budget}} 這類 token,把它們發送到您的 CRM。潛在客戶資格評估頁面載有該設定的訪談指示及負載格式。
設定方法
- Send the number's messages through easyCoexistenceOn the number's page, the Where incoming messages go card must be set to Through easyCoexistence; choose it if it shows Straight to your system.
- Deploy the receiverPublish the endpoint or n8n workflow on public HTTPS, with the CRM upserts keyed on the phone and the message id.
- Save the Forward URLPaste the receiver's URL into Forward URL (optional), click Save forward URL and store the signing secret shown once.
- Log automated repliesIn each automation that replies, add Call my webhook as the last step with the same URL, save, and copy that automation's Signing secret.
- Check one real conversationWrite to the number from another phone, let the automation answer, reply from the app, and confirm three activities on the contact: in, automated out and phone out.
常見錯誤
- 以非標準化的自由文字電話欄位搜尋 CRM。WhatsApp 的純數字格式很少與人手輸入的內容一致,每次配對失敗都會建立重複聯絡人;請改為搜尋已標準化的純數字屬性。
- 在回覆轉發前呼叫 CRM。若 CRM 處理超過 10 秒,easyCoexistence 便會重試;若沒有以 wamid 進行 upsert,活動就會被記錄兩次。
- 只記錄轉發,卻期望自動化回覆也在其中。API 發送的內容會以無文字的狀態回報;請在回覆後加上「Call my webhook」步驟,才會帶有回覆文字。
- 讓測試觸及 CRM。Try it 會以 dry_run true 及範例聯絡人 15550000000 真正呼叫您的 URL;在任何 upsert 之前請先捨棄這些事件。
其 Forward URL 會把客戶訊息及電話回覆,以 Meta 的原始事件形式傳送到您的 CRM,每個號碼各自簽署,並在 CRM 離線時重試約 33 小時;「Call my webhook」步驟則加入自動化回覆。轉發與自動化已包含在方案內。每個已連接號碼每月 US$ 9 起,號碼越多越便宜,最低降至 US$ 0.75,首 3 天免費。
常見問題
這套方案可與哪些 CRM 配合使用?
任何提供 API 的 CRM,無論是透過您自己的後端,還是透過 n8n、Make 或 Zapier 等設有相應節點的工作流程工具。HubSpot 設有 Communications 物件,並帶有專為記錄此類訊息而設的 WhatsApp 頻道類型;HubSpot 頁面顯示了相關呼叫方式。
團隊可否從 CRM 回覆客戶?
可以,前提是 CRM 透過 Meta 的 Cloud API,使用該號碼的發送端點及 get_api_credentials 取得的權杖發送:客戶最後一則訊息後 24 小時內可發送自由格式訊息,之後則須使用已核准的訊息範本。這些訊息也會顯示在手機應用程式的對話串中。
過往對話能否載入 CRM?
只能透過 Meta 的歷史記錄匯入功能進行,該功能會把最多 6 個月的一對一對話,送到連接後 24 小時內儲存的直接 webhook 目的地,每個連接一次。設為「Through easyCoexistence」的號碼,則會從轉發開始時起記錄。
easyCoexistence 在過程中會保留什麼?
轉發的變更會排入佇列以供重試,並在 7 天後移除。若號碼經由 easyCoexistence 處理,訊息文字也會依您選擇的期限(30、90 或 365 天)保留,供「對話」及 AI 上下文使用;執行記錄則保留 30 天。永久記錄由 CRM 保存。
繼續閱讀
準備開始嗎?
幾分鐘內設定 WhatsApp Coexistence,而非幾個月。應用程式在手機上仍可繼續運作。
開始免費試用驗證日期