محمود عبدالنبي
التقارير والتحليلات · مخطط مشروع · 3

دليل المستودع: مخطط ربط إسناد نقرات WhatsApp بملفات العملاء في CRM

صفحة تعريفية مستقلة بمستودع مخطط ربط إسناد نقرات WhatsApp بملفات العملاء في CRM. توضّح ما الذي يحاول حله، ولمن يناسب، وما الملفات التي ستجدها قبل الانتقال إلى المصدر.

المشكلة التي يعالجها

يوضح التوثيق الأصلي نطاق المشكلة بهذا الوصف:

Build an open-source WhatsApp attribution bridge blueprint: 1) System architecture specification for passing encoded tracking tokens in wa.me/?text= pre-filled messages, 2) Python webhook receiver script (whatsapp_webhook_parser.py) extracting lead parameters into CRM format, 3) Offline conversion upload formatting for Meta CAPI, 4) Sales representative logging SOP.

لمن صُمم؟

الجمهور المحدد في README: BOTH operating in high-growth e-commerce, digital publishing, and direct-response marketing across Saudi Arabia, UAE, and Egypt.

محتويات المستودع

الملفات الأساسية التي يسردها قسم بنية المستودع في README:

  • architecture/system-architecture.md
  • ARCHITECTURE.md
  • crm-templates/sales-rep-logging-sheet.md
  • DATA_MODEL.md
  • LICENSE
  • MONETIZATION.md
  • PRD.md
  • PROBLEM.md
  • README.md
  • ROADMAP.md
  • scripts/generate_tracking_links.py
  • scripts/whatsapp_webhook_parser.py

طريقة مراجعته واستخدامه

  1. ابدأ بقراءة README وتأكد أن المشكلة المذكورة تطابق احتياجك الفعلي.
  2. افحص الملفات المذكورة أعلاه؛ أسماء الملفات توضح مكان البيانات والأدوات والقوالب والاختبارات.
  3. اتبع Quick Start الموجود في README، وتحقق من المتطلبات قبل تشغيل أي أمر.
  4. قارن المخرجات بعينة موثقة، وراجع القيود قبل استخدامها في قرار أو عمل عميل.

أمثلة أوامر البدء من README: python -m unittest discover -s tests · python src/token_generator.py --help

النطاق والقيود

  • WABA Click-to-Chat Handshake: Captures pre-filled message reference tokens or dynamic URL parameters to connect ad click IDs (fbclid, gclid) to incoming CRM chats.
  • Downstream Conversion Attribution: Maps completed offline WhatsApp orders back into Meta CAPI and Google Ads as offline purchase conversions.
  • GDPR / PDPL Opt-In Consent: Captures explicit user consent prior to saving telephone numbers and initiating automated remarketing sequences.

هذه الصفحة تلخص التوثيق المتاح ولا تثبت أداءً أو نتيجة تجارية. تحقق من صلاحية البيانات والمتطلبات قبل الاستخدام.

مستودعات مرتبطة