# كيفية إنشاء روبوت دردشة
{% hint style="warning" %}
#### **يرجى الانتباه!**
**مشاريعك لا تُحذف أبدًا** وتبقى على المنصة إلى أجل غير مسمى.
عند انتهاء الاشتراك، ستتم إزالة البيانات التالية:
**اتصالات الماسنجر:** يتم تعطيلها بعد 3 أسابيع.
**الرسائل الطويلة:** تُحذف الرسائل التي تتجاوز 800 حرف بعد 3 أشهر.
**المحادثات:** تُخزن جميع الدردشات لمدة تتراوح بين 2 إلى 6 أشهر.
**العملاء:** تُزال بعد سنة واحدة.
**معلومات إضافية:**
**الرسائل غير المرسلة** يتم الاحتفاظ بها لمدة أسبوعين.
**الوصول إلى الماسنجر:** يُسحب بعد 3 أسابيع من انتهاء الصلاحية إذا لم يتم الدفع.
**حدود النظام:**
**الرسائل المجدولة:** الحد الأقصى 32 لكل عميل.
**روبوتات الاختبار:** محدودة بـ 1000 رسالة/يوم (بما في ذلك رسائل حسابات الاختبار).
{% endhint %}
### كيفية إنشاء أول كتلة في المسار التحويلي
كل روبوت محادثة يتم إنشاؤه في MaviBot يتكون من كتل.
الكتلة هي مجموعة من أوامر وإعدادات روبوت المحادثة، يتم تهيئتها بواسطةك أو بواسطة مطورينا لمشروعك.
تزوّد كل كتلة الروبوت بتعليمات حول كيفية الرد أو التصرف، وتحدد أين يجب أن يذهب العميل بعد ذلك في المسار التحويلي.
**إنشاء كتلة أمر بسيط: انقر نقرًا مزدوجًا في أي مساحة فارغة في مساحة العمل للبدء.**
يمكنك نقل كتلة (أو عدة كتل) إلى أي مكان داخل لوحة الإنشاء لتحسين التخطيط ومنح مسارك التحويلي مظهرًا أنظف وأكثر تنظيمًا.
لتسهيل الفهم، سنستعرض مخططًا تجريبيًا للمسار التحويلي ونشرح كيفية عمل المحرر باستخدام هذا المثال.
أنت تنظر إلى تدفق روبوت محادثة. يتكون التدفق من **كتل** و **اتصالات.**
**كتلة البدء (أخضر):** هنا تبدأ كل محادثة.
**كتل المُشغّل (رمادي داكن):** تفعّل هذه الكتل تدفقات محددة بناءً على إجراءات المستخدم.
عندما يرسل المستخدم رسالة أو ينقر زرًا، يمكنه الانتقال من كتلة إلى أخرى — ولكن **فقط إذا تم استيفاء شرط الانتقال**. يمكن تعيين الشروط على كل من **كتل** و **الموصلات.**
لجعل الروبوت يبدأ عندما ينقر المستخدم زر "**ابدأ"** في تيليجرام (أو أي ماسنجر آخر)، تحتاج إلى تحديد **كلمة مشغّلة** في الكتلة الخضراء.
تأتي كتل المُشغّل بلونين: **الأخضر و** **الرمادي**.
هناك أربعة أنواع من **كتل الشروط**:
1. **بدء**
2. **المشغّل**
"**ابدأ"** تتمتع الكتلة بأعلى أولوية بين جميع كتل الشروط — وهذا يعني أنها ستُفعَّل **الأول** إذا طابقت شرطها أيًّا من إجراءات العميل.
**الخطوة 1: أنشئ كتلة "دردشة"**
للقيام بذلك، انقر في أي مكان على اللوحة الفارغة في أداة إنشاء التدفق.
{% hint style="success" %}
**من الجيد معرفته!**\
**ما هي `#{none}` البنية؟**\
الـ `#{none}` البنية، التي تظهر افتراضيًا في حقل الرد، هي عنصر نائب خاص يُستخدم للتعامل مع الإدخال غير المحدد أو العام.
وهذا يعني، على سبيل المثال، أن **كتلة الشرط** بـ `#{none}` ستُفعَّل **عندما يرسل العميل أي رسالة** (إذا لم يتم تحديد كلمة مفتاحية أو مُشغّل معين).\
إذا تركت `#{none}` في حقل الرسالة، فهذا يتيح لك **توجيه العملاء إلى كتلة معينة في المسار التحويلي**، بغض النظر عن محتوى رسالتهم.
{% endhint %}
لإنشاء كتلة لا ترسل رسالة، أدخل `#{none}` في حقل الرد (هذا هو الإعداد الافتراضي).
ثم انقر على الكتلة وحدد نوعها — "**ابدأ".**
1. حدد **"بدء"** نوع الكتلة. سيؤدي هذا إلى فتح لوحة إعدادات الشرط.
2. في هذا الاختبار الأول في الوضع الداخلي لـ MaviBot، عيّن كلمة مشغّلة بسيطة مثل **"Hello"**.
الآن، اضبط ردّ الروبوت عند تفعيل المُشغّل. على سبيل المثال، أدخل الرسالة: **"Hello! How can I help you?"**
ثم تأكد من النقر على "**حفظ"** حتى يتم تطبيق جميع الإعدادات على الكتلة:
**الخطوة 2: أنشئ الكتلة التالية**
لإنشاء كتلة جديدة وربطها بالسابقة، افتح **قائمة الإعدادات الإضافية**.
لإنشاء تدفق محادثة سلس، يجب ربط كتلِك. إليك كيفية القيام بذلك بسرعة:
1. حدّد وافتح **قائمة الإعدادات الإضافية** للكتلة التي تريد الربط منها (مثلًا، كتلة "ابدأ").
2. ابحث عن الزر المسمّى وانقر عليه **"إنشاء كتلة أدناه."**
الآن يحتوي مسارك التحويلي على **كتلتين** وهما متصلتان.
{% hint style="warning" %}
**يرجى الانتباه!**
**ماذا يعني هذا عمليًا؟**
إذا كان لدى الروبوت مساران منفصلان للمحادثة **التدفقات**، فلا يمكن للمستخدم المرور بكليهما في الوقت نفسه. سيتبعون تدفقًا **تدفق** أو الآخر، ولكن ليس كليهما في الوقت نفسه.
**هل تحتاج إلى إرسال رسالة دون مقاطعة التدفق الحالي؟**
استخدم الكتل الرمادية — إما **"Fallback"** أو **"مشغّل"** — لإرسال رسائل منفصلة دون إرباك المحادثة النشطة للمستخدم.
{% endhint %}
**الموصلات** بين الكتل تُرشد العميل خلال مسار التحويل.
يمكنك أيضًا تعيين شروط مباشرة على الموصلات. يتيح لك ذلك التحكم في التدفق، مثل جعل النقر على زر أو نجاح الدفع شرطًا للمتابعة.
**لننشئ زرًا في كتلة “دردشة”** حتى يتمكن العميل من الانتقال إلى الكتلة التالية.
**الخطوة 3. أنشئ زرًا**
انقر على **كتلة “ابدأ”**. ستظهر لك **“الأزرار”** علامة التبويب:
انقر على اللسان — سيفتح هذا قائمة إعدادات الزر.
انقر **“+ إضافة زر”**، وستظهر قائمة إعدادات الزر.
في حقل نص الزر، أدخل أي تسمية تريدها — على سبيل المثال، **“GO”**.
انقر **"إضافة"**، وسيظهر الزر في إعدادات الكتلة.
يمكن عرض الأزرار بطريقتين: في لوحة مفاتيح الرسالة أو مباشرة داخل نص الرسالة.
لاحظ أن بعض أنواع الأزرار قد لا تكون مدعومة في بعض المراسلات (مثل واتساب).
لأفضل توافق، استخدم **"Auto"** سيفعل هذا عرض الزر تلقائيًا بالشكل الأكثر دعمًا من قبل كل ماسنجر على حدة.
ولا تنسَ حفظ إعدادات الكتلة.
تم! لقد أنشأت أول كتلة مُشغِّلة لديك مع زر! 🎉
**الخطوة 4. إعداد الاتصال**
لنُعِد تهيئة الموصل بحيث عندما ينقر العميل الزر، ينتقل إلى الكتلة التالية.
**إليك كيفية ذلك:**
1. حدّد **السهم** (الموصل) المؤدي من كتلة الزر الخاصة بك.
2. **مرّر المؤشر** فوق السهم.
3. انقر على **أيقونة الترس** التي تظهر لفتح إعداداته.
ستُفتح إعدادات الاتصال، حيث تحتاج إلى اختيار الزر الذي أنشأته.
ثم تحتاج إلى اختيار **"تطابق تام"** في **"نوع المطابقة"**:
وانقر **"حفظ"**.
بعد حفظ إعدادات الاتصال، سيظهر الشرط مباشرة على الموصل. يمنحك هذا مرجعًا بصريًا واضحًا لما يفعّل الانتقال بين الكتل.
يمكن أن يكون الاتصال منحنيًا:
يتيح لك هذا رؤية الاتصالات المتداخلة بوضوح. للقيام بذلك، أمسك السهم بالماوس عند النقطة التي تريد ثنيه فيها واسحبه إلى الموقع المطلوب.
لا يوجد حد لعدد الانحناءات التي يمكنك إجراؤها.
لحذف الانحناءات غير الضرورية من الموصل، انقر نقرًا مزدوجًا ببساطة على العقدة المطلوبة بزر الفأرة الأيسر.
**الخطوة 5. كتلة “دردشة”**
افتراضيًا، عندما نقرت على اللوحة سابقًا، تم إنشاء كتلة بيضاء **“دردشة”** — وهي أكثر كتلة استخدامًا عند بناء تدفقات روبوتات المحادثة.
يمكنك تهيئة كل شيء تقريبًا داخل كتلة “دردشة” (باستثناء الشروط). في الواقع، من المرجح أن يتكوّن معظم روبوت المحادثة لديك من **“دردشة”** الكتل.
على عكس كتل الشروط، لا يمكن الوصول إلى كتلة **“دردشة”** إلا إذا:
* تم ربطها عبر اتصال من كتلة سابقة، أو
* أرسلتَ حملة بريدية تقود المستخدمين إليها.
إذا كنت تريد أن يدخل العميل الكتلة بناءً على مُشغّل، فيجب ضبط المُشغّل إما:
* في **اتصال** (كما هو موضح في الخطوة 4)، أو
* باستخدام **كتلة مؤقّت**.
في **"Chat"** : أدخل الرسالة التي سيرسلها الروبوت إلى العميل (عندما ينقرون على الزر في كتلة **"بدء"** ).
تأكد من النقر على **"حفظ"** في **“دردشة”** إعدادات الكتلة.
{% hint style="success" %}
لقد أنشأت الآن أول روبوت محادثة لك!
{% endhint %}
#### درس فيديو
{% embed url="" %}
## اختبار روبوت المحادثة
بعد إنشاء أي روبوت محادثة — أو حتى أثناء بنائه — من المهم أن **تختبر** الروبوت للتأكد من أن تدفقاتك تعمل بشكل صحيح وأن الإعدادات مضبوطة على النحو الصحيح.
يمكنك ربط الروبوت بمشروع واختباره هناك. ومع ذلك، إذا أنشأت روبوتًا لـ **واتساب**، فضع في اعتبارك أن **لا يمكنك إرسال رسائل إلى نفسك**.
ولهذا هناك طريقة أخرى: يمكنك فتح **محادثة عبر الإنترنت** مع الروبوت والتفاعل معه مباشرةً.
للقيام بذلك، انقر على **الزر في الزاوية السفلية اليسرى** من أداة الإنشاء:
عندما تنقر على **"اختبار روبوت المحادثة"** الزر، ستفتح نافذة اختبار.
الـ **المنطقة اليسرى** من نافذة الاختبار تعرض الكتل التي أنشأتها لروبوت المحادثة.
في **الجانب الأيمن**، سترى بيانات العميل التجريبي — أي ملف المستخدم المحاكى الخاص بك.
في **منتصف الشاشة**، سترى **محادثة عبر الإنترنت** حيث يمكنك اختبار الروبوت. للقيام بذلك، اكتب عبارة المُشغّل من **"بدء"** الكتلة.
إليك كيفية عمل الروبوت:
{% hint style="success" %}
**تهانينا!** 🎉 **لقد أنشأت بنجاح روبوت محادثة عمليًا يتضمن:**
* **تهيئة المُشغّل** في كلٍّ من الكتل والموصلات
* **زرًا يعمل بالكامل**
* **اختبارًا في الوقت الحقيقي** يتيح لك رؤية كيفية عمل روبوت المحادثة الخاص بك بالضبط
{% endhint %}
### حول تبويب "الاختبار"
بعد إنشاء تدفق روبوت المحادثة في وضع الاختبار، سترى جميع اللوحات التي تحتوي على معلومات حول الكتل على اليسار.
تعرض كل لوحة على الجانب الأيسر من الشاشة رقم الكتلة، ونوعها، ومحتواها.
يمكنك تصفية الكتل وعرضها حسب نوعها باستخدام زر "التصفية" المقابل.
لاختبار تنفيذ كتلة واحدة من التدفق، يمكنك تحديد الكتلة المقابلة بالنقر عليها ثم النقر على **"إرسال الكتلة."**
ستُرسل الكتلة المحددة نيابةً عن روبوت المحادثة في القسم الأوسط من الشاشة — نافذة الاختبار.
في هذه المنطقة نفسها، يمكنك اختبار تدفق الكتل بالكامل بدءًا من أول كتلة في المخطط.
{% hint style="info" %}
لا تحتاج إلى بدء اختبار تدفق روبوت المحادثة من البداية: على سبيل المثال، إذا أضفت كتلًا جديدة إلى تدفقك، يمكنك استخدام **"إرسال الكتلة"** والبدء في اختبار التدفق من الكتلة المحددة.
{% endhint %}
على الجانب الأيمن من الشاشة، ستجد عرض العميل التجريبي.
في نافذة العميل نفسها، تتوفر الميزات التالية:
– تعيين أو إضافة وسوم/قوائم إلى العميل؛
\
– إضافة متغيرات؛
\
– عرض المتغيرات المخصصة للعميل عبر تنفيذ تدفق روبوت المحادثة.
بهذه الطريقة، يمكنك اختبار تدفق روبوت المحادثة بالكامل (أو أي جزء منه) وعرض بطاقة العميل وبياناته فورًا.
### خيارات الرد في الروبوت
الآن لنُضف سؤالًا مع عدة خيارات رد إلى التدفق الابتدائي. يتم تمثيل خيارات الرد بواسطة الموصلات الخارجة من الكتلة. سيحمل أحد الموصلات الشرط **“Yes,”** والآخر — “No.”
للقيام بذلك، انقر على الكتلة الثانية المسمّاة “Chat” وأنشئ كتلتين أسفلها باستخدام قائمة الإعدادات الإضافية.
**الآن بعد أن أضفنا كتلتين إلى تدفقنا، فالخطوة التالية هي تهيئة المُشغّل على اتصالهما.**
**إليك كيفية ذلك:**
1. مرّر فوق الموصل (السهم) المؤدي إلى الكتلة الثانية.
2. في حقل المُشغّل الذي يظهر، أدخل رد المستخدم الذي يجب أن يفعّل هذا المسار، على سبيل المثال، **"Yes"**.
ثم تأكد من حفظه. بعد ذلك، حدّد خيار الرد الآخر في إعدادات السهم الثاني أيضًا.
في الكتلة السابقة، التي تنطلق منها السهمان مع خيارات الرد، أدخل أي سؤال.
الآن، في **كتل "الدردشة"** التي تقود إليها الوصلة ذات خيارات الرد، أدخل رسالة رد الروبوت.
الآن يبدو التدفق النهائي كما يلي:
#### إليك كيف يعمل هذا التدفق:
1. يكتب المستخدم **“Hello”** ويدخل الكتلة الخضراء.
2. ثم ينقر المستخدم زرًا وينتقل إلى الكتلة الثانية؛
3. يكتب المستخدم **“Yes”** أو **“No”** ويتابع إلى إحدى الحالات حسب الإجابة.
ولكن ماذا لو كتب المستخدم شيئًا آخر — لا **“Yes”** ولا **“No”**؟ لن ينتقل الحوار إلى أي من الحالات التالية وسيبقى عالقًا في الحالة الحالية. ستتوقف المحادثة.
## كيفية إنشاء حلقة
لمنع الروبوت من الصمت عندما يرسل المستخدم رسالة لا تطابق أيًّا من المُشغّلات على الموصلات، سنضيف حلقة.
للقيام بذلك، اجعل السؤال حلقة بإضافة سهم **من دون أي مُشغّل** يشير **للخلف إلى الكتلة نفسها**.
{% hint style="info" %}
من الجيد معرفته!\
الكتل والاتصالات **من دون مُشغّلات** لها **أولوية أقل** من تلك **التي تحتوي على مُشغّلات**.
{% endhint %}
لإنشاء حلقة، انقر على الكتلة التي تسأل فيها العميل سؤالًا. في نموذج الإعدادات الذي يفتح، انقر على النقاط الثلاث في الزاوية العلوية اليمنى، ثم اختر **“إنشاء حلقة.”**
سيؤدي هذا إلى إنشاء حلقة في التدفق.
الآن، إذا أرسل العميل رسالة إلى الروبوت تختلف عن **“Yes”** أو **“No,”** فسوف تُرسل رسالة الكتلة الثانية مرة أخرى.
**ماذا لو لم يرد العميل على رسالة الروبوت؟**
يمكنك إرسال رسائل متابعة باستخدام **كتلة مؤقّت** لتذكير العميل بأن الرد مطلوب.
لذا، عندما يدخل المستخدم الكتلة التي تحتوي على السؤال *“Are you happy?”*، ولا يجيب بـ **“Yes”** أو **“No”**، نريد إرسال رسالة مثل:**“You didn’t answer the question :(”** ثم نطرح السؤال مرة أخرى.
للقيام بذلك، سنستخدم **مؤقّتًا.**
## كيفية إنشاء رسالة باستخدام مؤقّت
لننشئ كتلة جديدة سيؤدي إليها السهم من **"Are you happy?"** كتلة، ونزيل أيضًا الحلقة.
للقيام بذلك، مرّر فوق الحلقة وانقر على **أيقونة الإغلاق** لحذفها.
الآن، انتقل إلى إعدادات السهم الذي يؤدي إلى الكتلة الجديدة من كتلة السؤال.
في إعدادات السهم، توجد لوحة تسمى **“Delay before response”** — وهذا مؤقّت يحدد مقدار الوقت الذي بعده يتقدم التدفق تلقائيًا إلى الكتلة التالية.
يجب أيضًا تفعيل مربع الاختيار **“Cancel if left the block”** حتى لا تُرسل الرسالة إذا كان العميل قد أجاب بالفعل على السؤال.
الآن، لنُدخل الرسالة في الكتلة الجديدة:
ومن الكتلة الجديدة، ارسم اتصالًا يعود إلى كتلة السؤال.
للقيام بذلك، مرّر فوق الكتلة — ستظهر نقطة تسمح لك بإنشاء اتصال:
الخطوة 1. انقر على الزر واسحب الموصل إلى الكتلة التي تحتوي على السؤال.
الخطوة 2. سيتداخل الموصلان، لذا ستحتاج إلى سحب أحدهما إلى أعلى قليلًا.
\
للقيام بذلك، مرّر الماوس فوق الموصلات وابحث عن المقبض الطويل — استخدمه لضبط الانحناء وفصل الاتصال.
الخطوة 3. ثم انقر على الموصل مع الاستمرار واسحبه إلى أعلى.
الآن انتقل إلى إعدادات السهم الذي تم إنشاؤه حديثًا واضبط **مؤقتًا لمدة ثانية واحدة**، بحيث يُعاد توجيه العميل إلى كتلة السؤال.
يبدو التدفق النهائي كما يلي:
{% hint style="success" %}
لقد أنشأت بنجاح أول روبوت محادثة لك — مكتملًا بالأزرار، والموصلات، وخيارات الرد، والحلقات، وأسهم إعادة التوجيه المؤقتة!
{% endhint %}
## **كيفية إضافة مراحل المسار التحويلي (القوائم)**
باستخدام مراحل المسار التحويلي (القوائم)، يمكنك تنظيم الروبوت بالطريقة الأكثر ملاءمة لك. إنها ما تزال مساحة عمل كبيرة واحدة توجد فيها جميع فروع الروبوت، لكن يتم تقسيمها بصريًا إلى صفحات منفصلة. ويواصل الروبوت نفسه العمل كتدفق واحد.
عندما تنقطع سلاسل التدفق عبر القوائم، **تُنشأ كتل الربط** تلقائيًا.
لإضافة قائمة جديدة، انقر على **أيقونة الزائد** في الزاوية السفلية اليمنى من مساحة العمل وأدخل اسم القائمة الجديدة.
لمتابعة التدفق الحالي في قائمة جديدة، انقر على كتلة أو حدد عدة كتل، ثم انقر على السهم↪️ مع التلميح **“انقر لنقل العناصر المحددة إلى قائمة أخرى.”**
عندما يظهر تحذير نقل الكتل، اختر القائمة المطلوبة من القائمة المنسدلة في الأسفل بجوار أيقونة الزائد.
في النافذة التي تفتح، سترى تعليمات حول ما يجب القيام به لإكمال النقل.
## كيفية ربط المراسلات
بعد الاختبار، يمكنك ربط التدفق بالمراسلات. للقيام بذلك، انتقل إلى **الرسائل** القسم في القائمة الرئيسية.
بعد ذلك، تحتاج إلى النقر على زر الماسنجر المطلوب.
{% hint style="success" %}
اقرأ كيفية ربط الروبوتات في مختلف المراسلات في **«**[**الرسائل**](/doc/ar/chatbot/ttbyqat-almraslh.md)**"** المقال.
{% endhint %}
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://docs.mavibot.ai/doc/ar/chatbot/builder/funnel.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.