登入開始免費試用
Meta Tech Provider

自動把 WhatsApp 對話傳送到您的 CRM

要自動把 WhatsApp 對話傳送到 CRM,可讓收到的訊息以已簽署的 webhook 傳送到您的後端或工作流程工具,依電話號碼找到或建立聯絡人,再把該訊息以活動形式記錄在該聯絡人之下。請以 WhatsApp 訊息 ID 作為活動的唯一鍵,這樣重試的傳送便會更新同一筆記錄,而不會建立第二筆。

easyCoexistence 透過 Coexistence,把您在應用程式中保留的 WhatsApp Business 號碼連接到 Meta 的 Cloud API。

X-EC-Delivery

已轉發 POST 的標頭載有傳送 ID,每次重試該傳送時都相同。

About 33 hours

7 次轉發嘗試的時間跨度,大約在 1、5、30、120、360 及 1,440 分鐘後。

1 attempt

「Call my webhook」步驟只會呼叫您的 URL 一次;超時或錯誤會令執行失敗,並電郵通知您。

BSUID

業務範圍內的用戶 ID,例如 US.13491208655302741918,會放在 user_id 及 from_user_id 中,與電話號碼並列或取代電話號碼。

30 days

自動化執行記錄會保留多久,涵蓋觸發訊息、回覆及每一步驟。

哪些事件應傳送至 CRM?

在 Coexistence 號碼上,一段對話由三類訊息組成,並經由兩條路徑傳送。每個號碼設定的 Forward URL 會傳送客戶發出的訊息,以及您的團隊在 WhatsApp Business 應用程式中輸入的訊息,格式為 Meta 的原始事件,並會重試直至 CRM 回應為止。自動化發出的回覆會經 API 送到 Meta,Meta 只回報傳送狀態,不附文字;要記錄其內容,請以「Call my webhook」步驟結束自動化,該步驟的歷史記錄會包括自動化剛發送的回覆。一個端點可同時接收兩者:X-EC-Event 標頭對步驟回報 automation.step,對轉發則回報 Meta 的欄位名稱。

Customer messagesForward URL, event messages, in value.messages
Replies typed on the phoneForward URL, event smb_message_echoes, in value.message_echoes
Automated repliesCall my webhook as the last step: history entries with direction out
Lead detailsSaved by an agent or an AI saves details step, or extracted by your workflow from the chat; see lead qualification

如何把 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 phonemessages[].fromcontact.wa_id
Contact namecontacts[].profile.namecontact.name
BSUIDcontacts[].user_id, messages[].from_user_idNot sent
Activity texttext.body, or the media typemessage.text and history[].text
Directionmessages = in, smb_message_echoes = outhistory[].direction: in, out or echo
Timetimestamp, Unix secondsmessage.at and history[].at, ISO 8601
Unique keymessages[].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 節點。

Express receiver: forwards and Call my webhook steps into a 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。潛在客戶資格評估頁面載有該設定的訪談指示及負載格式。

設定方法

  1. 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.
  2. Deploy the receiverPublish the endpoint or n8n workflow on public HTTPS, with the CRM upserts keyed on the phone and the message id.
  3. Save the Forward URLPaste the receiver's URL into Forward URL (optional), click Save forward URL and store the signing secret shown once.
  4. 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.
  5. 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 之前請先捨棄這些事件。
使用 EasyCoexistence 完成這項設定

其 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,而非幾個月。應用程式在手機上仍可繼續運作。

開始免費試用

驗證日期