שליחת שיחות WhatsApp ל-CRM באופן אוטומטי
כדי לשלוח שיחות WhatsApp ל-CRM באופן אוטומטי, מעבירים את ההודעות הנכנסות כוובהוקים חתומים (Webhook) לשרת שלכם או לכלי זרימת עבודה, מוצאים או יוצרים את איש הקשר לפי מספר הטלפון, ומתעדים את ההודעה כפעילות על איש הקשר. משתמשים במזהה ההודעה של WhatsApp כמפתח הייחודי של הפעילות, כך שמשלוח חוזר מעדכן את אותה רשומה במקום ליצור שנייה.
easyCoexistence מחבר את מספר העסק של WhatsApp שאתם מנהלים באפליקציה ל-Cloud API של Meta דרך Coexistence.
כותרת בבקשת POST שהועברה, הנושאת את מזהה המשלוח; היא זהה בכל ניסיון חוזר של אותו משלוח.
טווח של 7 ניסיונות העברה, לאחר כ-1, 5, 30, 120, 360 ו-1,440 דקות.
שלב הוובהוק (Call my Webhook) קורא לכתובת ה-URL שלכם פעם אחת; זמן קצוב או שגיאה מכשילים את ההרצה ושולח לכם מייל.
מזהה משתמש ברמת העסק, למשל US.13491208655302741918, נשלח ב-user_id וב-from_user_id לצד מספר הטלפון או במקומו.
כמה זמן יומן הרצת האוטומציה שומר את ההודעה המפעילה, את התשובה ואת כל שלב.
אילו אירועים צריכים להגיע ל-CRM?
לשיחה במספר Coexistence יש שלושה סוגי הודעות, ושני מסלולים נושאים אותן. כתובת ה-Forward URL, שנקבעת לכל מספר, שולחת את מה שהלקוחות כותבים ואת מה שהצוות מקליד באפליקציית WhatsApp Business, כאירועים המקוריים של Meta, ומנסה שוב עד שה-CRM משיב. תשובות שנשלחות על ידי אוטומציות מגיעות ל-Meta דרך ה-API, ו-Meta מדווחת עליהן רק כסטטוסים של מסירה, בלי טקסט. כדי לתעד את דבריהן, סיימו את האוטומציה בשלב הוובהוק, שההיסטוריה שלו כוללת את התשובה שההרצה שלחה זה עתה. נקודת קצה אחת יכולה לקבל את שניהם: הכותרת X-EC-Event מחזירה automation.step עבור השלב, ושם השדה של Meta עבור העברות.
איך מתאימים שולח 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 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 |
איך מונעים מניסיונות חוזרים ליצור כפילויות?
ענו מהר, ואז מפתחו הכול. העברה שלא קיבלה תשובה 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 אחריו.
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 להגדרה הזו.
איך מגדירים
- 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 לנסות שוב, ובלי upsert לפי ה-wamid הפעילות נרשמת פעמיים.
- תיעוד ההעברה בלבד וציפייה שתשובות אוטומטיות יופיעו בה. שליחות API חוזרות כסטטוסים בלי טקסט; שלב הוובהוק אחרי התשובה נושא את המילים.
- לתת לבדיקות להגיע ל-CRM. Try it קורא באמת לכתובת שלכם עם dry_run true ואיש הקשר לדוגמה 15550000000; הסירו את האירועים האלה לפני כל upsert.
ה-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 Coexistence בתוך דקות, לא חודשים. האפליקציה ממשיכה לעבוד בטלפון.
התחילו תקופת ניסיון בחינםנבדק ב-