أرسل محادثات WhatsApp إلى CRM تلقائيًا
لإرسال محادثات WhatsApp إلى CRM تلقائيًا، اجعل الرسائل الواردة تصل كخطافات الويب (webhook) الموقّعة إلى خادمك الخلفي أو إلى أداة سير عمل، وابحث عن جهة الاتصال برقم الهاتف أو أنشئها، ثم سجّل الرسالة كنشاط على جهة الاتصال تلك. استخدم معرّف رسالة WhatsApp مفتاحًا فريدًا للنشاط، حتى تحدّث عملية التسليم المعاد إرسالها السجل نفسه بدلًا من إنشاء سجل ثانٍ.
يربط easyCoexistence رقم WhatsApp Business الذي تحتفظ به في التطبيق بـ Cloud API من Meta عبر Coexistence.
ترويسة في طلب POST المُعاد توجيهه تحمل معرّف التسليم، وتكون متطابقة في كل إعادة محاولة لذلك التسليم.
المدة الزمنية للمحاولات السبع لإعادة التوجيه، بعد نحو 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)، التي تُبلغ عنها كحالات تسليم فقط دون نص. ولتسجيل كلماتها، أنهِ الأتمتة بخطوة Call my webhook، إذ يتضمن سجلها الرد الذي أرسله التشغيل للتو. ويمكن لنقطة نهاية (endpoint) واحدة أن تستقبل الاثنين: الترويسة X-EC-Event تحمل القيمة automation.step للخطوة، واسم حقل Meta للرسائل المُعاد توجيهها.
كيف تطابق مُرسِل WhatsApp مع جهة اتصال في CRM؟
برقم الهاتف بعد تطبيعه. يُرسل WhatsApp الأرقام كأرقام فقط مع رمز الدولة دون علامة الجمع، مثل 5511987654321، في messages[].from في التوجيهات، وفي contact.wa_id في خطوة Call my webhook. أما السجلات التي يكتبها الناس في CRM فتحمل مثلًا +55 11 98765-4321 أو (11) 98765-4321، لذلك احتفظ بخاصية مخصصة تحمل الصيغة الرقمية فقط وابحث بها. وعند عدم وجود تطابق، أنشئ جهة الاتصال باسم ملف WhatsApp الشخصي والرقم.
واحفظ كذلك معرّف المستخدم على نطاق النشاط التجاري. فقد يصل مستخدم له اسم مستخدم على WhatsApp ولم يتواصل مع رقمك منذ 30 يومًا بالـ BSUID وحده في from_user_id وcontacts[].user_id. تحمل التوجيهات المعرّف، أما خطوة Call my webhook فتحمل رقم الهاتف.
ماذا ينبغي أن يحمل كل سجل في CRM؟
جهة اتصال تحمل المعرّفات، ونشاط واحد لكل رسالة يتضمن الاتجاه والنص والوقت ومفتاحًا فريدًا. يوضّح الجدول أدناه موضع كل قيمة في كلا المسارين. أوقات الرسائل في التوجيهات هي ثوانٍ بتوقيت يونكس من Meta، أما خطوة Call my webhook فترسل تواريخ بصيغة ISO. وتصل الوسائط كنوع ومعرّف في التوجيهات، وكعناصر نائبة مثل [image] مع التعليق في خطوة Call my webhook، لذلك سجّل تسمية قصيرة بدل محاولة تخزين الملف.
| 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 في طابور أو مهمة خلفية.
لا تُعاد محاولة خطوة Call my webhook، كما أن التسليمات المتكررة من 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 تحديث العميل المحتمل بما تعلّمه الذكاء الاصطناعي؟
نعم، في سير عملك. تحمل المحادثة التي تصل مع خطوة Call my webhook الأسئلة التي طرحها الذكاء الاصطناعي وإجابات العميل، لذلك يمكن لعقدة نموذج في n8n أو استدعاء في خادمك الخلفي استخراج الاحتياج والميزانية والتوقيت والموقع، وكتابتها في حقول العميل المحتمل، ثم نقل مرحلته. لا تُرجع ردًا، فالعميل تلقى رسالة الذكاء الاصطناعي بالفعل. وعندما يقرر سير العمل أن العميل المحتمل يستحق مكالمة، يمكنه إنشاء مهمة لمندوب مبيعات أو تنبيه الفريق. أو دع easyCoexistence تتولى الاستخراج: تكتب خطوة وكيل أو خطوة AI saves details الاحتياج والميزانية والتوقيت في حقول جهة الاتصال، ويمكن لخطوة Call an API إرسالها إلى CRM الخاص بك باستخدام رموز بأسلوب {{contact.budget}} في جسمها. تتضمن صفحة تأهيل العملاء المحتملين تعليمات المقابلة والحمولة اللازمة لهذا الإعداد.
كيفية إعداده
- 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 الردود دون نص كحالات، أما خطوة Call my webhook بعد الرد فتحمل الكلمات.
- السماح للاختبارات بالوصول إلى CRM. يستدعي Try it عنوان URL الخاص بك فعلًا مع dry_run بقيمة true وجهة الاتصال النموذجية 15550000000، فأسقط تلك الأحداث قبل أي upsert.
يمرّر Forward URL رسائل العملاء والردود الهاتفية إلى CRM كأحداث Meta الأصلية، موقّعة لكل رقم، ويُعاد إرسالها لنحو 33 ساعة عندما يكون CRM متوقفًا، وتضيف خطوة Call my webhook الردود الآلية. التوجيه والأتمتة مشمولان في الخطة. من US$ 9 إلى US$ 0.75 لكل رقم شهريًا، ويتناقص السعر كلما أضفت أرقامًا، مع فترة تجريبية مجانية مدتها 3 أيام.
الأسئلة الشائعة
ما أنظمة CRM التي تعمل مع هذا؟
أي CRM لديه API، إما عبر خادمك الخلفي أو عبر أداة سير عمل مثل n8n أو Make أو Zapier التي تملك عقدًا لذلك. يتضمن HubSpot كائن Communications بنوع قناة WhatsApp مصمم لتسجيل هذه الرسائل، وتعرض صفحة HubSpot طريقة الاستدعاء.
هل يستطيع فريقي الرد على العملاء من داخل CRM؟
فقط إذا كان CRM يرسل عبر Cloud API من Meta باستخدام endpoint الإرسال الخاص بالرقم وtoken الخاص به من get_api_credentials: نص حر في غضون 24 ساعة من آخر رسالة للعميل، وقالب معتمد بعد ذلك. وتظهر هذه الرسائل أيضًا في سلسلة محادثة التطبيق على الهاتف.
هل يمكن تحميل المحادثات السابقة إلى CRM؟
فقط عبر استيراد السجل من Meta، الذي يرسل حتى 6 أشهر من المحادثات الفردية إلى وجهة webhook مباشرة محفوظة خلال 24 ساعة من الربط، مرة واحدة لكل اتصال. والرقم المضبوط على «Through easyCoexistence» يسجّل من لحظة بدء التوجيه.
ما الذي يحتفظ به easyCoexistence أثناء العملية؟
تُوضع التغييرات المُوجَّهة في قائمة انتظار لإعادة المحاولة وتُزال بعد 7 أيام. وعلى الرقم الذي يمر عبر easyCoexistence، يبقى نص الرسالة أيضًا من أجل Conversations وسياق الذكاء الاصطناعي للمدة التي تختارها، 30 أو 90 أو 365 يومًا، وتُحفظ سجلات التشغيل 30 يومًا. أما السجل الدائم فيحتفظ به CRM.
تابع القراءة
هل أنت مستعد للبدء؟
أعد إعداد WhatsApp Coexistence خلال دقائق، وليس أشهر. يواصل التطبيق العمل على الهاتف.
ابدأ الفترة التجريبية المجانيةتم التحقق في