جسر CRM
حين تُعرّف الجلسة، يصل التسجيل كملاحظة على الشخص في CRM — جهة اتصال موجودة لا جديدة.
1. ما يفعله بجملة واحدة
لحظة تعريف الجلسة، نبحث عن الشخص في CRM بمعرّفك المرسل ونرفق ملاحظة برابط التسجيل.
هذا كل شيء. لا جهات اتصال أو صفقات جديدة ولا تغييرات في مسار البيع. نظام CRM يضيف نسخة مكررة كل زيارة لصفحة الأسعار أسوأ من عدم وجود تكامل.
إن لم نجد الشخص فلا يحدث شيء. إنشاؤه يعني كتابة سجل في CRM من جلسة متصفح — والجلسات ليست مصدر حقيقة لهوية عملائك.
2. مفتاح المطابقة: كيف نجد الشخص
يستحق هذا عشر دقائق من انتباهك، لأنه الموضع المعتاد لفشل تكامل CRM بصمت.
نعرف الزائر بما أخبرنا به موقعك — MousePlayer.setUserId()، أو معرّف مميز من أداة تحليلاتك أو استدعاء identify من الخادم. يعرفه CRM بشيء أيضًا. يجب أن يتطابق الاثنان.
| نبحث عبر | يمكنك تغييره | |
|---|---|---|
| HubSpot | بريد جهة الاتصال | لا — نقطة البحث مبنية حوله |
| Pipedrive | الأشخاص بحسب عبارة، البريد أولًا | لا |
| Salesforce | حقل تسميه أنت، والافتراضي Email | نعم |
لماذا يسأل Salesforce تحديدًا
نادرًا ما تتخذ أنظمة Salesforce البريد مفتاحًا. قد يعتمد نظامك على Customer_Number__cأو معرّف خارجي من نظام الفوترة. لو بحثنا بالبريد لوجدنا لا شيء وأبلغنا بالنجاح — أسوأ إخفاق لأن التكامل يبدو حيًا.
لذا يسأل النموذج: أي حقل في Contact يحمل القيمة التي نرسلها؟ أدخل اسم API، بما فيه __c إن كان حقلًا مخصّصًا.
يُفحص اسم الحقل بنمط صارم قبل دخوله استعلامًا. اسم حقل CRM أحرف وأرقام وشرطات سفلية — يُرفض غيرها بدل تهريبه، إذ يمكن الخطأ في التهريب بدقة، بينما الرفض واضح.
3. متى يعمل ومتى لا يعمل عمدًا
عند التعريف: حين يستدعي موقعك MousePlayer.setUserId()، أو يقرأ جسر التحليلات معرّفًا من PostHog أو Mixpanel أو Amplitude، أو يستدعي خادمك نقطة identify.
مرة لكل جلسة لا لكل صفحة
شخص يسجّل الدخول ويتصفح إحدى عشرة صفحة ينتج ملاحظة واحدة لا إحدى عشرة. الخط الزمني في CRM موضع للقراءة.
ليس دون معرّف
الجلسة المجهولة بلا مفتاح للمطابقة. لا نخمن عبر IP ولا نرفق التسجيل بمن صادف اشتراكه في العنوان.
ليس إذا كان الشخص مجهولًا لـ CRM
تُحسب مكتملة لا فاشلة — وجود عميل محتمل خارج CRM طبيعي، ولن تغيّره إعادة المحاولة غدًا.
4. شكل الملاحظة ومكان الرمز
ملاحظة واحدة في الخط الزمني لجهة الاتصال: سطر يفيد بتسجيل جلسة والرابط. ينقره مندوب المبيعات ليشاهد ما فعله الشخص قبل مراسلته.
بيانات الاعتماد
تُخزّن بتشفير AES-256-GCM. لا تُعرض بعد الحفظ — يظهر الحقل نجومًا، وحفظها لا يغيّر القيمة المخزنة. تُستبعد عمدًا من قائمة المهام الداخلية: القائمة حالة مشتركة، وليست مكانًا لمفتاح.
يحتاج Salesforce ثلاثة أشياء والبقية اثنين
يصادق Salesforce عبر Connected App برمز تحديث، فيطلب consumer key والسر ورمز التحديث، مع URL نسختك. يستخدم HubSpot وPipedrive رمز API واحدًا. في الثلاثة التطبيق لك — لا يشغّل MousePlayer تطبيق متجر عليك الوثوق به.
5. Zoho CRM وFreshsales
نظاما CRM إضافيان، على طرفي جهد الإعداد.
| Zoho CRM | Freshsales | |
|---|---|---|
| ما تقدمه | مركز البيانات ومعرّف العميل وسره ورمز التحديث | مفتاح API ونطاق Freshworks |
| نبحث عبر | حقل تسميه، والافتراضي Email | حقل تسميه، والافتراضي email |
| تصل الملاحظة | على جهة الاتصال كسجل Note | على جهة الاتصال كملاحظة |
يوجد Zoho في أحد ستة مراكز بيانات
الحساب في com، eu، in، com.au، jp أو com.cn، ولا يخبرك المفتاح بأيها. اختر الخطأ فيجيب Zoho INVALID_TOKEN — فيبدو كمفتاح خاطئ ويدفعك للبحث في المكان الخطأ. لهذا بالضبط الحقل قائمة منسدلة.
Self Client، مرة واحدة
أنشئ Self Client في وحدة Zoho API وولّد رمز منح لـ ZohoCRM.modules.ALL و ZohoSearch.securesearch.READ، واستبدله مرة برمز تحديث. لا تنتهي صلاحيته؛ وتُجلب منه رموز الوصول كل ساعة ولا تُحفظ.
يجيب Zoho بـ 200 حين يقصد الرفض
قد يعيد تبادل الرموز وكتابة السجلات HTTP 200 مع خطأ أو حالة لكل سجل داخل الجسم. نقرأ الجسم — جسر يثق برمز الحالة سيبلغ بالنجاح لملاحظة لم تُنشأ قط.
كل العلامات التجارية المذكورة ملك لأصحابها. لا تربط MousePlayer علاقة تجارية بهؤلاء المزودين.