# FluentCRM

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

FluentCRM هو إضافة لإدارة علاقات العملاء (CRM) والتسويق عبر البريد الإلكتروني تعمل داخل WordPress: جهات الاتصال، والعلامات، والقوائم، والحملات التي ترسلها إليهم. يمنحك توصيله بـ <span data-t="appName">DM Champ</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)

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

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

---

## الإجراءات

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

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

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

- **البريد الإلكتروني** هو عنوان البريد الإلكتروني لجهة الاتصال. مطلوب. عادةً ما يكون بريد جهة الاتصال من المشغل.
- **الاسم الأول**، **اسم العائلة** و **الهاتف** اختيارية.
- **الحالة** هي `subscribed` أو `pending` أو `unsubscribed` أو `bounced`. إذا تُركت فارغة، فستكون `subscribed`.
- **معرفات الوسوم** هي وسوم لإضافتها إليهم، مفصولة بفواصل. اختيارية.
- **معرفات القوائم** هي قوائم لإضافتهم إليها، مفصولة بفواصل. اختيارية.

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

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

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

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

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

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

- **معرف جهة الاتصال** يحدد جهة الاتصال المقصودة. مطلوب. عادةً ما يتم الحصول عليه من خطوة **العثور على جهة اتصال عن طريق البريد الإلكتروني** في وقت سابق من الأتمتة.
- **البريد الإلكتروني** هو بريد جهة الاتصال. مطلوب، لأن FluentCRM يطلب البريد الإلكتروني عند كل تحديث.
- **معرفات الوسوم** هي الوسوم المراد ربطها، مفصولة بفواصل. مطلوبة.
- **الحالة** اختيارية وتكون افتراضياً `subscribed`.

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

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

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

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

---

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

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

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

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

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

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

---

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

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

---

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

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