تسجيل الدخولابدأ الفترة التجريبية المجانية
Meta Tech Provider

أرسل محادثات WhatsApp إلى CRM تلقائيًا

لإرسال محادثات WhatsApp إلى CRM تلقائيًا، اجعل الرسائل الواردة تصل كخطافات الويب (webhook) الموقّعة إلى خادمك الخلفي أو إلى أداة سير عمل، وابحث عن جهة الاتصال برقم الهاتف أو أنشئها، ثم سجّل الرسالة كنشاط على جهة الاتصال تلك. استخدم معرّف رسالة WhatsApp مفتاحًا فريدًا للنشاط، حتى تحدّث عملية التسليم المعاد إرسالها السجل نفسه بدلًا من إنشاء سجل ثانٍ.

يربط easyCoexistence رقم WhatsApp Business الذي تحتفظ به في التطبيق بـ Cloud API من Meta عبر Coexistence.

X-EC-Delivery

ترويسة في طلب POST المُعاد توجيهه تحمل معرّف التسليم، وتكون متطابقة في كل إعادة محاولة لذلك التسليم.

About 33 hours

المدة الزمنية للمحاولات السبع لإعادة التوجيه، بعد نحو 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)، التي تُبلغ عنها كحالات تسليم فقط دون نص. ولتسجيل كلماتها، أنهِ الأتمتة بخطوة Call my webhook، إذ يتضمن سجلها الرد الذي أرسله التشغيل للتو. ويمكن لنقطة نهاية (endpoint) واحدة أن تستقبل الاثنين: الترويسة 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 في خطوة 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 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 في طابور أو مهمة خلفية.

لا تُعاد محاولة خطوة 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 بعدها.

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 تحديث العميل المحتمل بما تعلّمه الذكاء الاصطناعي؟

نعم، في سير عملك. تحمل المحادثة التي تصل مع خطوة Call my webhook الأسئلة التي طرحها الذكاء الاصطناعي وإجابات العميل، لذلك يمكن لعقدة نموذج في n8n أو استدعاء في خادمك الخلفي استخراج الاحتياج والميزانية والتوقيت والموقع، وكتابتها في حقول العميل المحتمل، ثم نقل مرحلته. لا تُرجع ردًا، فالعميل تلقى رسالة الذكاء الاصطناعي بالفعل. وعندما يقرر سير العمل أن العميل المحتمل يستحق مكالمة، يمكنه إنشاء مهمة لمندوب مبيعات أو تنبيه الفريق. أو دع easyCoexistence تتولى الاستخراج: تكتب خطوة وكيل أو خطوة AI saves details الاحتياج والميزانية والتوقيت في حقول جهة الاتصال، ويمكن لخطوة Call an API إرسالها إلى CRM الخاص بك باستخدام رموز بأسلوب {{contact.budget}} في جسمها. تتضمن صفحة تأهيل العملاء المحتملين تعليمات المقابلة والحمولة اللازمة لهذا الإعداد.

كيفية إعداده

  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 الردود دون نص كحالات، أما خطوة Call my webhook بعد الرد فتحمل الكلمات.
  • السماح للاختبارات بالوصول إلى CRM. يستدعي Try it عنوان URL الخاص بك فعلًا مع dry_run بقيمة true وجهة الاتصال النموذجية 15550000000، فأسقط تلك الأحداث قبل أي upsert.
إنجاز ذلك باستخدام EasyCoexistence

يمرّر 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 وجهات الاتصال في Google Sheets تلقائياًسجّل رسائل WhatsApp وجهات الاتصال في Google Sheets من رقمك في التطبيق، عبر تحويل موقّع أو خطاف الويب (webhook) إلى n8n أو Make أو Zapier.إشعار فريقك حين تحتاج محادثة WhatsApp إلى شخصنبّه فريقك عبر Slack أو البريد عندما يطلب عميل WhatsApp شخصًا أو يسلّم الذكاء الاصطناعي المحادثة، وتتوقف الأتمتة حين يرد أحد.تسجيل رسائل WhatsApp في HubSpot من رقم Coexistenceاكتب كل رسالة WhatsApp على رقم Coexistence في الجدول الزمني لجهة اتصال HubSpot عبر Communications API وn8n أو Make، ويبقى الفريق على الهاتف.تأهيل العملاء المحتملين على WhatsApp بالذكاء الاصطناعيأهّل عملاء WhatsApp المحتملين بذكائك الاصطناعي: يطرح الأسئلة الأولى، ويرسل المحادثة إلى CRM أو n8n، ويتولى شخص العملاء الذين يستحقون اتصالًا.أسماء مستخدمي WhatsApp ومعرّفات BSUID: ما يتغيّر في خطّاف الويب (webhooks) لـ Cloud APIكيف تغيّر أسماء مستخدمي WhatsApp مضمون webhooks في Cloud API: معرّف BSUID في user_id، ومتى يختفي wa_id وfrom، والرد عبر recipient، وتغييرات Coexistence.كيف تصل رسائل WhatsApp إلى خادمك: مباشرة أو مُدارة، والتحقق من التوقيعمباشرة: تنشر Meta إلى خادمك. مُدارة: ترد الأتمتة، وتصل نسخة موقّعة إلى عنوان URL للتوجيه. الحمولة، وتوقيع X-EC-Signature في Node وPython، وإعادة المحاولة.

هل أنت مستعد للبدء؟

أعد إعداد WhatsApp Coexistence خلال دقائق، وليس أشهر. يواصل التطبيق العمل على الهاتف.

ابدأ الفترة التجريبية المجانية

تم التحقق في