התחברותהתחילו תקופת ניסיון
Meta Tech Provider

שליחת שיחות WhatsApp ל-CRM באופן אוטומטי

כדי לשלוח שיחות WhatsApp ל-CRM באופן אוטומטי, מעבירים את ההודעות הנכנסות כוובהוקים חתומים (Webhook) לשרת שלכם או לכלי זרימת עבודה, מוצאים או יוצרים את איש הקשר לפי מספר הטלפון, ומתעדים את ההודעה כפעילות על איש הקשר. משתמשים במזהה ההודעה של WhatsApp כמפתח הייחודי של הפעילות, כך שמשלוח חוזר מעדכן את אותה רשומה במקום ליצור שנייה.

easyCoexistence מחבר את מספר העסק של WhatsApp שאתם מנהלים באפליקציה ל-Cloud API של Meta דרך Coexistence.

X-EC-Delivery

כותרת בבקשת POST שהועברה, הנושאת את מזהה המשלוח; היא זהה בכל ניסיון חוזר של אותו משלוח.

About 33 hours

טווח של 7 ניסיונות העברה, לאחר כ-1, 5, 30, 120, 360 ו-1,440 דקות.

1 attempt

שלב הוובהוק (Call my Webhook) קורא לכתובת ה-URL שלכם פעם אחת; זמן קצוב או שגיאה מכשילים את ההרצה ושולח לכם מייל.

BSUID

מזהה משתמש ברמת העסק, למשל US.13491208655302741918, נשלח ב-user_id וב-from_user_id לצד מספר הטלפון או במקומו.

30 days

כמה זמן יומן הרצת האוטומציה שומר את ההודעה המפעילה, את התשובה ואת כל שלב.

אילו אירועים צריכים להגיע ל-CRM?

לשיחה במספר Coexistence יש שלושה סוגי הודעות, ושני מסלולים נושאים אותן. כתובת ה-Forward URL, שנקבעת לכל מספר, שולחת את מה שהלקוחות כותבים ואת מה שהצוות מקליד באפליקציית WhatsApp Business, כאירועים המקוריים של Meta, ומנסה שוב עד שה-CRM משיב. תשובות שנשלחות על ידי אוטומציות מגיעות ל-Meta דרך ה-API, ו-Meta מדווחת עליהן רק כסטטוסים של מסירה, בלי טקסט. כדי לתעד את דבריהן, סיימו את האוטומציה בשלב הוובהוק, שההיסטוריה שלו כוללת את התשובה שההרצה שלחה זה עתה. נקודת קצה אחת יכולה לקבל את שניהם: הכותרת 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 בהעברות ובשדה contact.wa_id בשלב הוובהוק. רשומות ב-CRM שאנשים הקלידו מכילות +55 11 98765-4321 או (11) 98765-4321, לכן שמרו מאפיין ייעודי בצורת הספרות בלבד וחפשו לפיו. כשאין התאמה, צרו את איש הקשר עם שם הפרופיל ב-WhatsApp והמספר.

שמרו גם את מזהה המשתמש ברמת העסק. משתמש עם שם משתמש ב-WhatsApp שלא יצר קשר עם המספר שלכם במשך 30 ימים עשוי להגיע עם BSUID בלבד, בשדות from_user_id ו-contacts[].user_id. ההעברות נושאות אותו; שלב הוובהוק נושא את מספר הטלפון.

מה צריך להכיל כל רשומה ב-CRM?

איש קשר עם המזהים, ופעילות אחת לכל הודעה עם כיוון, טקסט, זמן ומפתח ייחודי. המפה שלהלן מראה איפה כל ערך נמצא בכל מסלול. זמני ההודעות בהעברות הם שניות Unix מ-Meta; שלב הוובהוק שולח תאריכי ISO. מדיה מגיעה כסוג ומזהה בהעברות, וכמציין מקום כמו [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

איך מונעים מניסיונות חוזרים ליצור כפילויות?

ענו מהר, ואז מפתחו הכול. העברה שלא קיבלה תשובה 2xx תוך 10 שניות נשלחת שוב עם אותו מזהה X-EC-Delivery, עד 7 ניסיונות; קריאה ל-CRM שנמשכת 12 שניות תרוץ לכן פעמיים, אלא אם הפעילות מבוצעת כ-upsert לפי ה-wamid. ענו 200 קודם, ובצעו את עבודת ה-CRM בתור או במשימת רקע.

שלב הוובהוק אינו נשלח שוב, וחזרות המשלוח של Meta מסוננות לפני שאוטומציה רצה, כך שהוא קורא לכם לכל היותר פעם אחת לכל הודעה. לרשומות ההיסטוריה שלו אין מזהה הודעה: מפתחו את התשובות האוטומטיות לפי run_id ולפי מיקומן. בדיקות מ-Try it מגיעות עם dry_run true ואיש הקשר לדוגמה 15550000000; דלגו עליהן כדי שבדיקות לעולם לא ייצרו רשומות ב-CRM.

איך נראה המקבל ב-Node.js?

נתיב Express אחד מקבל את שני סוגי האירועים. הוא קורא את הגוף הגולמי, בוחר את הסוד לפי הכותרת X-EC-Event, מאמת את X-EC-Signature, עונה 200 מיד ומעביר את העבודה לפונקציית רקע. האובייקט crm מייצג את לקוח ה-API של ה-CRM שלכם: 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 למד?

כן, בזרימת העבודה שלכם. השיחה שמגיעה עם שלב הוובהוק כוללת את השאלות ששאל ה-AI ואת תשובות הלקוח, כך שצומת מודל ב-n8n או קריאה בשרת שלכם יכולים לחלץ צורך, תקציב, תזמון או מיקום, לכתוב אותם לשדות הליד ואז להעביר את שלבו. אל תחזירו תשובה, כי הלקוח כבר קיבל את הודעת ה-AI. כשהזרימה מחליטה שליד ראוי לשיחה, היא יכולה ליצור משימה לאיש מכירות או להתריע לצוות. או שתנו ל-easyCoexistence לבצע את החילוץ: סוכן או שלב שמירת פרטים עם AI כותבים צורך, תקציב ותזמון לשדות איש הקשר, ושלב קריאה ל-API יכול לשלוח אותם ל-CRM שלכם עם טוקנים בסגנון {{contact.budget}} בגוף הבקשה. עמוד הערכת הליד כולל את הוראות הראיון ואת ה-payload להגדרה הזו.

איך מגדירים

  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 לנסות שוב, ובלי upsert לפי ה-wamid הפעילות נרשמת פעמיים.
  • תיעוד ההעברה בלבד וציפייה שתשובות אוטומטיות יופיעו בה. שליחות API חוזרות כסטטוסים בלי טקסט; שלב הוובהוק אחרי התשובה נושא את המילים.
  • לתת לבדיקות להגיע ל-CRM. Try it קורא באמת לכתובת שלכם עם dry_run true ואיש הקשר לדוגמה 15550000000; הסירו את האירועים האלה לפני כל upsert.
עושים את זה עם EasyCoexistence

ה-Forward URL שלו מעביר הודעות לקוחות ותשובות טלפון ל-CRM שלכם כאירועים המקוריים של Meta, חתומים לכל מספר ומנסים שוב במשך כ-33 שעות כשה-CRM לא זמין, ושלב הוובהוק מוסיף את התשובות האוטומטיות. העברה ואוטומציות כלולות בתוכנית. מ-US$ 9 ועד US$ 0.75 לכל מספר בחודש, ויורד ככל שמוסיפים מספרים, עם 3 הימים הראשונים בחינם.

שאלות נפוצות

אילו מערכות CRM עובדות עם זה?

כל מערכת CRM עם API, דרך השרת שלכם או דרך כלי זרימת עבודה כמו n8n, Make או Zapier שיש להם צמתים לכך. ל-HubSpot יש אובייקט Communications עם סוג ערוץ WhatsApp שנבנה לתיעוד הודעות אלה; דף HubSpot מציג את הקריאה.

האם הצוות שלי יכול להשיב ללקוחות מתוך ה-CRM?

רק אם ה-CRM שולח דרך Cloud API של Meta, עם נקודת הקצה לשליחה של המספר והאסימון שמתקבל מהפקודה get_api_credentials: טקסט חופשי בתוך 24 שעות מההודעה האחרונה של הלקוח, ותבנית מאושרת לאחר מכן. ההודעות האלה מופיעות גם בשרשור הצ'אט באפליקציה בטלפון.

האם אפשר לטעון שיחות קודמות ל-CRM?

רק דרך ייבוא ההיסטוריה של Meta, ששולח עד 6 חודשים של צ'אטים פרטיים אחד-על-אחד ליעד וובהוק ישיר שנשמר תוך 24 שעות מהחיבור, פעם אחת לכל חיבור. מספר שנמצא במצב Through easyCoexistence מתעד מהרגע שההעברה מתחילה.

מה easyCoexistence שומר בדרך?

שינויים שמועברים נכנסים לתור לניסיונות חוזרים ומוסרים אחרי 7 ימים. במספר שעובר דרך easyCoexistence, תוכן ההודעות נשמר גם עבור Conversations והקשר ה-AI למשך הזמן שבחרתם, 30, 90 או 365 ימים, ויומני ההרצה נשמרים 30 ימים. ה-CRM מחזיק את הרשומה הקבועה.

המשיכו לקרוא

שמירת הודעות WhatsApp ואנשי קשר ל-Google Sheets באופן אוטומטירישום הודעות WhatsApp ואנשי קשר ל-Google Sheets מהמספר שבאפליקציה, באמצעות העברה חתומה או וובהוק (Webhook) אל n8n, Make או Zapier.הודיעו לצוות כששיחה ב-WhatsApp צריכה אדםשלחו התראה לצוות ב-Slack או במייל כשלקוח ב-WhatsApp מבקש אדם או שה-AI מעביר שיחה, והאוטומציה נסוגה ברגע שמישהו עונה.רישום הודעות WhatsApp ב-HubSpot ממספר Coexistenceכל הודעת WhatsApp במספר Coexistence נרשמת בציר הזמן של איש הקשר ב-HubSpot דרך Communications API, עם n8n או Make. הצוות ממשיך לענות מהטלפון.סינון לידים ב-WhatsApp עם AIסינון לידים ב-WhatsApp עם ה-AI שלכם: הוא שואל את השאלות הראשונות, שולח את השיחה ל-CRM או ל-n8n, ואדם לוקח את הלידים החמים.שמות משתמש ב-WhatsApp ומזהי BSUID: מה משתנה בוובהוקים (Webhook) של Cloud APIאיך שמות משתמש ב-WhatsApp משנים את הוובהוקים של Cloud API: ה-BSUID בשדה user_id, מתי השדה wa_id נעלם, מענה לנמען ושינויים ב-Coexistence.איך הודעות WhatsApp מגיעות לשרת שלכם: ישירות או מנוהלות, ואימות החתימהישיר: Meta שולחת לשרת שלכם. מנוהל: אוטומציות עונות ועותק חתום נשלח ל-Forward URL. ה-payload, X-EC-Signature ב-Node ו-Python, וניסיונות חוזרים.

מוכנים להתחיל?

מגדירים WhatsApp Coexistence בתוך דקות, לא חודשים. האפליקציה ממשיכה לעבוד בטלפון.

התחילו תקופת ניסיון בחינם

נבדק ב-