# FluentCRM

> **لمن هذا؟** الشركات التي تحتفظ بقائمة بريدها الإلكتروني في FluentCRM على موقع WordPress الخاص بها، وتريد أن تغذيها المحادثات. إذا كنت لا تستخدم FluentCRM، يمكنك تخطي هذه الصفحة.
>
> هل تستخدم أداة CRM أو بريد إلكتروني مختلفة؟ لا يزال بإمكانك توصيل أي شيء يحتوي على API: راجع [توصيل أداة لا ندرجها](connecting-other-tools.md).

FluentCRM هو إضافة لإدارة علاقات العملاء (CRM) والتسويق عبر البريد الإلكتروني تعمل داخل WordPress: جهات الاتصال، والعلامات، والقوائم، والحملات التي ترسلها إليهم. يمنحك توصيله بـ <span data-t="appName">Your AI Connector</span> [أتمتة](../automations/automations.md) بخطوات تكتب فيه، بحيث يصبح عميل WhatsApp المحتمل جهة اتصال في FluentCRM مع وضع العلامة الصحيحة عليه، وتتولى سلسلة رسائل البريد الإلكتروني التي أنشأتها بالفعل المهمة من هناك. لا حاجة للتصدير، ولا للنسخ واللصق، ولا للانتظار حتى يوم الجمعة.

لا يتم تثبيت أي شيء على موقع WordPress الخاص بك. أنت تقوم بتوصيل موقعك الخاص باستخدام تفاصيل تسجيل الدخول الخاصة بك، ونحن نستدعي واجهة برمجة التطبيقات (API) التي يوفرها FluentCRM بالفعل.

**التوفر:** الأتمتة متاحة في كل حساب. إنها موجودة بالفعل في الشريط الجانبي الخاص بك، ولا يوجد شيء لتفعيله أو طلبه.

---

## ما تحتاجه

يعتمد FluentCRM على WordPress REST API، لذا فهو يتطلب نفس تفاصيل اتصال [WordPress](wordpress.md) تماماً:

- **موقع WordPress الذي يعمل عليه FluentCRM**، والذي يمكن الوصول إليه عبر **https**، على إصدار WordPress **5.6 أو أحدث**.
- **الروابط الدائمة الجميلة (Pretty permalinks)** مفعلة (**الإعدادات ← الروابط الدائمة**، أي خيار غير "عادي")، وهو ما يجعل عنوان `/wp-json/` يعمل.
- **كلمة مرور التطبيق (application password)** لمستخدم WordPress الذي يجب أن تعمل الأتمتة باسمه: **المستخدمون ← الملف الشخصي ← كلمات مرور التطبيق ← إضافة جديد**. يعرضها WordPress مرة واحدة، في كتل مفصولة بمسافات. انسخها مع المسافات.

يجب أن يكون ذلك المستخدم مسموحاً له بإدارة FluentCRM في WordPress. لا يتم استخدام كلمة مرور تسجيل الدخول الحقيقية الخاصة بك أبداً، وحذف كلمة مرور التطبيق لاحقاً يلغي هذا الاتصال تحديداً.

---

## توصيل FluentCRM

أنت تقوم بالتوصيل من داخل الأتمتة، في المرة الأولى التي تستخدم فيها خطوة FluentCRM.

1. افتح **الأتمتة (Automations)** في الشريط الجانبي (تحت مجموعة **AI Studio**) وافتح أتمتة أو أنشئ واحدة جديدة.
2. أضف خطوة وابحث عن **FluentCRM** في أداة اختيار الخطوات.
3. اختر الإجراء الذي تريده. ستطلب منك الخطوة الاتصال أولاً.
4. املأ الحقول الثلاثة:
   - **عنوان URL للموقع (Site URL)** هو عنوان موقع WordPress الذي يعمل عليه FluentCRM، بدءاً بـ `https://`.
   - **اسم مستخدم WordPress** هو اسم المستخدم الذي يسجل به ذلك المستخدم دخوله، وليس بريده الإلكتروني.
   - **كلمة مرور التطبيق (Application password)** هي كلمة المرور التي أنشأتها أعلاه، ملصقة مع مسافاتها.
5. انقر فوق اتصال.

نحن نتحقق من التفاصيل مقابل موقعك قبل حفظ أي شيء، عن طريق قراءة جهة اتصال واحدة من FluentCRM. التفاصيل الخاطئة، أو الموقع الذي لا يتم فيه حل `/wp-json/`، يتم رفضها على الشاشة مع ذكر السبب. يتم تخزين كلمة مرور التطبيق الخاصة بك مشفرة ولا يتم عرضها لك مرة أخرى أبداً.

---

## يتم تقديم العلامات والقوائم كمعرفات (IDs)

هذا هو الشيء الوحيد الذي يجب معرفته قبل بناء أي شيء. كل حقل يقبل وسومًا (tags) أو قوائم يتطلب **أرقام المعرفات (ID numbers)** الخاصة بها، مفصولة بفواصل، وليس أسماءها. `1, 2` يعمل؛ بينما `Newsletter, VIP` لا يعمل، ويقوم المحرر بوضع علامة عليه تحت الحقل. المعرف الذي يتبين أنه خاطئ فقط عند تشغيل الأتمتة (على سبيل المثال، معرف جاء من خطوة سابقة) يوقف الخطوة ويظهر خطأ، بدلاً من التشغيل بصمت بدون ذلك الوسم.

ستجد الأرقام في FluentCRM: افتح **العلامات (Tags)** أو **القوائم (Lists)** في قائمة FluentCRM، وسيكون معرف كل صف موجوداً في شريط العنوان عند فتحه. اكتب الحفنة التي تخطط لاستخدامها مرة واحدة، وقد انتهيت.

---

## الإجراءات

كل إجراء هو خطوة على لوحة الأتمتة، وتقبل جميع الحقول بيانات من الخطوات السابقة باستخدام أزرار إدراج البيانات المعتادة.

### إنشاء أو تحديث جهة اتصال

يضيف جهة اتصال، أو يحدث جهة الاتصال التي تمتلك هذا البريد الإلكتروني بالفعل. إرسال نفس البريد الإلكتروني مرتين يؤدي إلى تحديث البيانات بدلاً من الفشل، لذا يمكنك تشغيل هذا الإجراء مع كل عميل محتمل جديد دون الحاجة للتحقق أولاً.

- **البريد الإلكتروني (Email)** هو عنوان البريد الإلكتروني لجهة الاتصال. مطلوب. عادةً ما يكون بريد جهة الاتصال من المشغل (trigger).
- **الاسم الأول (First name)**، **اسم العائلة (Last name)**، و**الهاتف (Phone)** هي حقول اختيارية.
- **الحالة (Status)** يتم اختيارها من قائمة: مشترك (Subscribed)، معلق (Pending)، غير مشترك (Unsubscribed)، أو معاملات (Transactional). مطلوبة، لأن FluentCRM يحتاج إلى واحدة، وهي تنطبق على جهات الاتصال الموجودة أيضًا: **خيار "مشترك" يعيد اشتراك شخص قام بإلغاء اشتراكه**، لذا اختره فقط عندما يطلب الشخص الانضمام. **معلق (Pending)** يرسل بريد التحقق المزدوج الخاص بـ FluentCRM.
- **معرفات الوسوم (Tag IDs)** هي الوسوم التي سيتم إضافتها إليهم، مفصولة بفواصل. اختيارية.
- **معرفات القوائم (List IDs)** هي القوائم التي سيتم إضافتهم إليها، مفصولة بفواصل. اختيارية.

### العثور على جهة اتصال عن طريق البريد الإلكتروني

يبحث عن جهة اتصال باستخدام عنوان البريد الإلكتروني ويعيد المعرف الخاص بها، ووسومها، وقوائمها.

- **البريد الإلكتروني** هو العنوان المراد البحث عنه. مطلوب.

مخرجات هذا الإجراء هي ما تحتاجه الخطوات التالية، لأنها تعمل بناءً على معرف جهة الاتصال.

### إضافة وسوم إلى جهة اتصال

يربط وسماً واحداً أو أكثر بجهة اتصال موجودة بالفعل.

- **معرف جهة الاتصال (Contact ID)** يحدد جهة الاتصال المقصودة. مطلوب. عادةً ما يتم الحصول عليه من خطوة **البحث عن جهة اتصال بالبريد الإلكتروني (Find contact by email)** في وقت سابق من الأتمتة.
- **البريد الإلكتروني (Email)** هو بريد جهة الاتصال. مطلوب، لأن FluentCRM يطلب البريد الإلكتروني في كل عملية تحديث.
- **معرفات الوسوم (Tag IDs)** هي الوسوم المراد إرفاقها، مفصولة بفواصل. مطلوبة.
- **تغيير الحالة (Change status)** اختياري. إذا تُرك على **الإبقاء على الحالة الحالية (Keep current status)**، فلن يتم المساس بحالة جهة الاتصال، لذا فإن إضافة وسم لشخص قام بإلغاء اشتراكه لن يؤدي إلى إعادة اشتراكه.

### إزالة وسوم من جهة اتصال

نفس الحقول، ولكن لإزالة الوسوم بدلاً من إضافتها.

### إضافة جهة اتصال إلى قوائم

- **معرف جهة الاتصال (Contact ID)**، **البريد الإلكتروني (Email)**، و**معرفات القوائم (List IDs)** (مفصولة بفواصل)، مع نفس خيار **تغيير الحالة (Change status)** الاختياري.

---

## مثال على الأتمتة

**كل عميل محتمل جديد على واتساب يتم إدراجه في FluentCRM، مع إضافة وسم يحدد مصدره.**

1. **المُشغّل:** رسالة واردة من جهة اتصال جديدة.
2. **إنشاء أو تحديث جهة اتصال**، باستخدام البريد الإلكتروني لجهة الاتصال، والاسم الأول، ورقم الهاتف من المُشغّل، و**معرف القائمة** لقائمتك الرئيسية.
3. **إضافة وسوم إلى جهة الاتصال** ليست ضرورية هنا، لأن الخطوة 2 يمكنها حمل **معرفات الوسوم** بالفعل. استخدمها عندما يأتي الوسم لاحقاً في المحادثة بدلاً من ذلك.

والنسخة التي يأتي فيها الوسم لاحقاً، وهي الأكثر فائدة:

1. **المُشغّل:** إضافة وسم إلى جهة الاتصال، لنقل `asked about pricing`، بواسطة وكيل الذكاء الاصطناعي الخاص بك.
2. **البحث عن جهة اتصال بالبريد الإلكتروني**، باستخدام البريد الإلكتروني لجهة الاتصال.
3. **إضافة وسوم إلى جهة الاتصال**، باستخدام المعرف من الخطوة 2، ونفس البريد الإلكتروني، ومعرف وسم FluentCRM الخاص بسلسلة التسعير الخاصة بك.

تقوم أتمتة FluentCRM الخاصة بعد ذلك بإرسال سلسلة البريد الإلكتروني التي يبدأها ذلك الوسم. تتم المحادثة على واتساب، وتتم الرعاية عبر البريد الإلكتروني، ولا يقوم أحد بنقل أي بيانات بينهما يدوياً.

---

## معلومات مفيدة

- **الخطوات التي تتطلب معرف جهة اتصال تأتي بعد خطوة البحث (Find step).** هذا هو الشكل الطبيعي: ابحث عن جهة الاتصال، ثم تعامل مع المعرف الذي أعادته خطوة البحث.
- **المخرجات تنتقل للأمام.** كل ما تعيده أي إجراء يصبح متاحًا للخطوات اللاحقة كمتغيرات.
- **المعرفات، وليس الأسماء،** لكل حقل وسم أو قائمة. الاسم في ذلك الحقل يتم وضع علامة عليه في المحرر ويوقف الخطوة عند تشغيلها.
- **بعض الاستضافات تقوم بإزالة ترويسة التفويض (Authorization header)** قبل أن يراها WordPress، مما يجعل كلمة مرور التطبيق الصحيحة تبدو خاطئة. إذا كانت بياناتك صحيحة تمامًا ولا يزال الاتصال مرفوضًا، فهذا هو الأمر الذي يجب أن تسأل عنه مزود الاستضافة الخاص بك.
- **لا يوجد مشغل (trigger) يراقب FluentCRM.** لا يوجد شيء يقوم باستطلاع التغييرات فيه. لجعل FluentCRM يبدأ أتمتة، أضف مشغل **Webhook** إلى الأتمتة ووجه Webhook الصادر من FluentCRM إلى العنوان الذي يوفره لك.
- **أي شيء غير موجود في القائمة أعلاه** لا يزال من الممكن القيام به باستخدام خطوة **طلب HTTP (HTTP request)**.

---

## الخطوات التالية

- [الأتمتة](../automations/automations.md): المُشغّلات، والخطوات، والشروط، وكيفية تجميع سير العمل.
- [ووردبريس](wordpress.md): المنشورات والمستخدمون على نفس الموقع، بنفس تفاصيل الاتصال.
- [MemberPress](memberpress.md): العضويات والمدفوعات على موقع ووردبريس الخاص بك.
- [ربط أداة غير مدرجة](connecting-other-tools.md): الوظائف المخصصة، وواجهة برمجة التطبيقات (API)، وخطافات الويب (webhooks).