# العمل مع أكواد الخصم

يمكنك إعطاء رمز ترويجي لعميل بإحدى طريقتين:

1. أعدّ قائمة بأكواد ترويجية في Google Sheet، ودرّب Mavibot على العثور على رمز متاح، وتسليمه للعميل، ثم وضع علامة عليه على أنه مُصدَر في الجدول. 
2. درّب Mavibot على إنشاء أكواد ترويجية وفقًا لقواعد محددة، ووفّر الرمز للعميل، ثم سجّله في الجدول.

يمكنك التحقق من صلاحية الرموز باستخدام Google Sheets وطلبات API الخاصة به.

تعرّف على المزيد حول هذه العمليات أدناه:

* [كيفية التحقق من رمز ترويجي من Google Sheets](#how-to-check-the-promo-code-from-google-sheets) 
* [كيفية إعطاء رمز ترويجي من Google Sheets](#how-to-give-a-promo-code-from-google-sheets) 
* [كيفية إنشاء رمز ترويجي بمساعدة Salebot](#how-to-generate-a-promo-code-with-the-help-of-salebot)

## كيفية التحقق من رمز ترويجي من Google Sheets

إذا كان هدفك تقييد الوصول إلى البوت أو العروض الخاصة، فيمكنك استخدام وظيفة التحقق من الأكواد الترويجية.

أعدّ Google Sheet بحيث يكون أحد الأعمدة قائمة بأكوادك الترويجية. اضبط إعدادات الوصول على “Anyone with this link can edit”. لمعرفة كيفية القيام بذلك، اقرأ في [هذه المقالة](https://docs.salebot.ai/integrations/google-sheets)

إليك كيفية عمل هذه الوظيفة: يُدخل العميل رمزه الترويجي في البوت. ثم تتحقق الوظيفة مما إذا كان الرمز موجودًا في العمود المحدد الذي أنشأته. إذا تم العثور على الرمز، تُضاف العبارة "Promo code was used" إلى الخلية المجاورة، وتعيد الوظيفة هذه الاستجابة:

`{“status”: ‘’0’’}`

عنوان الوظيفة: <https://store.mavibot.ai/function/check-promocode&#x20>;

للتحقق من الرمز، تحتاج إلى إرسال هذه المعلمات من الكتلة:

`{"id":"1HfnHDbJYTGz68-3KWIcRISncTmdEn8v7Vf_OKvDMrOI", "promocode": "#{question}", "col_number": "1"}`

**id** هو معرّف Google Sheet الخاص بك الذي يحتوي على الأكواد الترويجية. يمكنك العثور عليه في عنوان URL الخاص بالمستند. تأكد من أن إعدادات مشاركة المستند تسمح لأي شخص لديه الرابط بالتعديل.

![](https://lh6.googleusercontent.com/cvcU-bsobIQ-uD5iqEzNsEbnTep8loKIyZrIlfPKkqUF7qTLewOTk8-L6RwUkXBlTGM8K_yQCn-jujDlBBuzH-_bIwhKvtOgRB-pkQnd5VpA108jCx75_UKlEV5mphSWkEsSwR5_7zrBwS9Sag)

إذا كانت الأكواد الترويجية موجودة في *ورقة منفصلة*، فستحتاج إلى استخدام المعلمة **list\_name**، والتي يجب أن تضع فيها اسمها، على سبيل المثال:

`{"id":"1HfnHDbJYTGz68-3KWIcRISncTmdEn8v7Vf_OKvDMrOI", "promocode": "#{question}", "col_number": "1", "list_name": "Sheet name"}`

المعلمة التالية هي الرمز الترويجي الذي يطبقه العميل.

**col\_number** - رقم العمود الذي يحتوي على الأكواد

`{“status”: ‘’1’’}`، وبعد ذلك لن تتمكن من استخدام الرمز للمرة الثانية

إذا لم تعثر الوظيفة على الرمز الترويجي في الجدول أو كان قد استُخدم بالفعل، فإنها ترد بـ

`{“status”: ‘’0’’}`

إذا كنت تتساءل عن كيفية استخدام هذا وأين تضعه، فراجع لقطة الشاشة أدناه.

![](https://lh5.googleusercontent.com/WqtuqryusiRuwOBWKF80lAl2Q4HC5EfWZoSxDMw367AzRceNWRf01XyDVO6mfvIxAXan1-Ejzvg8iYl36yDUzfmdqP62nMNe1xqNAuZ-BjON9_F1oC7gsFBb2Ta_GZZyoWZy3tFKtmQzUv3OSA)

**#{custom\_answer}** - الإجابة من الخادم المذكورة في علامة التبويب "URL request".

استخدم هذا المتغير في علامة التبويب الخاصة بالإجابة لرؤية محتوياته. إذا كان كل شيء مضبوطًا بشكل صحيح، فاحفظ status->status، ثم في الأسهم الموجودة أسفل تبويب “Variable for comparison”، اضبط الشروط على **"status == 0"** (إبلاغ المستخدم بأن الرمز قد استُخدم بالفعل) أو **"status == 1"** (السماح للمستخدم بالمتابعة).

يوضح المثال أدناه.

![](https://lh3.googleusercontent.com/IBr66uuikrvi9s4hR82FHYxdxVpsRqtNVysc8obCZQzjFxMThrTz0jsbHWdgMCrv6iP0fU_9axov9EhL9CMeiUtZVFqNUK8Hk22grZ_x3Tr4JPVqI5oAxQmca_da1D2fta03u3e7Qy9tAwig3g)

## كيفية إعطاء رمز ترويجي من Google Sheets

أعدّ جدولك كما هو موضح في الصورة أدناه، مع وضع الأكواد الترويجية في العمود الأول وكلمة "Available" في العمود الثاني. اضبط إعدادات الوصول على “Anyone on the Internet with this link can edit”. لمعرفة كيفية القيام بذلك، اقرأ في [هذه المقالة](https://docs.salebot.ai/integrations/google-sheets)

![](https://lh5.googleusercontent.com/XkxdMscLWR-5FE8V2c53KehWDsbt7XP6TAxVuVRsHrxSKlFPeM8xEAgvIENjRxWS_Z2bU8KtxEIQkz6NgExRYSr6qWu207cGuybkb_kAwDg_J0RotfpPSKRCQ4z8w3lFVLClEW9oYNFPnikWww)

ستحصل على رابط مشابه لهذا: <https://docs.google.com/spreadsheets/d/**1HfnHDbJYTGz68-3KWIcRISncTmdEn8v7Vf\\_OKvDMrOI**/edit?usp=sharing>

النص الغامق هنا هو معرّف الصفحة الخاص بك. ستحتاج إليه لاحقًا.

أنشئ كتلة على Mavibot والصق هذه المعلمات في إعداداتها:

نوع الطلب: `POST-json`

طلب URL: `https://store.salebot.ai/function/findcell`

القيم المخزنة:

`data->Promo code;` \
`cell_number|row ->line;`

معلمات JSON:

`{"id": "1HfnHDbJYTGz68-3KWIcRISncTmdEn8v7Vf_OKvDMrOI", "find": "Available", "col": 2, "return": 1}`

حيث تحتاج إلى وضع معرّف صفحتك الخاص بدلًا من 1HfnHDbJYTGz68-3KWIcRISncTmdEn8v7Vf\_OKvDMrOI

![](https://lh5.googleusercontent.com/hr0fmr7F_klICs6FDm8ay1majH0R_GQ3EDsxvzFq-IWYJhP_DhvaoSKfGhr7O5aZSY0xUzC6YLb8pzcryhs7IK9J_4ACyjfeEAT_0PApcS27OXKP3QPfeSmcq_rTNLw9EIFA99NADl5QipPWLg)

أنشئ كتلة بالأسفل وانقر على "Time settings" في إعدادات الاتصال. في القسم الذي يفتح، وتحت **"Delay before answer"** أدخل -1 في علامة التبويب لجعل الانتقال يحدث بأسرع ما يمكن.

في الكتلة الجديدة، اضبط المعلمات المذكورة أدناه.

لإظهار الرمز الخاص بالعميل، اكتب **#{Promo\_code}**

نوع الطلب: `POST-json`

طلب URL: `https://store.mavibot.ai/function/gsheets`

معلمات JSON:

`{"id": "1HfnHDbJYTGz68-3KWIcRISncTmdEn8v7Vf_OKvDMrOI", "write":{"b#{line}":"Used"}}` \
حيث تحتاج إلى وضع معرّف صفحتك الخاص بدلًا من 1HfnHDbJYTGz68-3KWIcRISncTmdEn8v7Vf\_OKvDMrOI

![](https://lh3.googleusercontent.com/PtlosYtM_SMivssLQ1toFXIoerd7SenhhPtw_Doy-KDgB6G4Ycp3P02IO4LQyYqK8wiLbP_q7zL81wcguaIeHDSBQGVSk-HpXPMnmgnRvbs7thEsarKGaT5xIt3n4T979FEaHz52pvEikeCyfA)

## كيفية إنشاء رمز ترويجي بمساعدة Mavibot

إذا كان بالإمكان إنشاء رمز ترويجي وفقًا لقواعد معينة، فيمكنك إنشاؤه مباشرة في Mavibot وكتابته في Google Sheets للتحقق منه لاحقًا.

ستحتاج إلى متغيرات لهذا. على سبيل المثال، لإنشاء رمز ترويجي فريد، يمكنك استخدام المتغير **#{client\_id}**، وهو متغير في Mavibot يشير إلى رقم عميلك في النظام.

في إعدادات الكتلة Advanced -> Calculator اكتب: \
`Promocode = promo#{client_id}`&#x20;

الصق **#{Promo\_code}** في حقل "Answer" \
ستحصل على رمز ترويجي promo1330882.

إذا كنت تريد إضافة المزيد من *العشوائية* إلى الرمز، فأضف استدعاء الدالة **random()** \
`Promocode = 'promo' + '#{client_id}' + random(0,10)` \
في هذه الحالة، يضيف رقمًا عشوائيًا واحدًا في النهاية

والآن لنلصقه في جدول الأكواد الخاص بنا.

أولًا، أنشئ Google Sheet جديدة فارغة. اضبط أذونات المشاركة على "Anyone with the link can edit."
\
ثم اكتب Promo codes في الخلية A1.

{% hint style="warning" %}
إذا كانت الخلية الأولى فارغة، فلن تعمل الوظيفة. يجب أن تتأكد من تعبئتها!
{% endhint %}

ستحصل على رابط مشابه لهذا:

<https://docs.google.com/spreadsheets/d/**1HfnHDbJYTGz68-3KWIcRISncTmdEn8v7Vf\\_OKvDMrOI**/edit?usp=sharing>

النص الغامق هنا هو معرّف الصفحة الخاص بك. ستحتاج إليه لاحقًا.

والآن لنعد إلى Mavibot ونواصل العمل على الكتلة الخاصة بك التي تحتوي على الرمز الترويجي

نوع الطلب: `POST-json`

طلب URL: `https://store.mavibot.ai/function/gsheets`

معلمات JSON:

`{"id": "1sl15vKFjo5TFD98GnVjF3AlLtdhr85-AkEjoeJkgDxE", "mapping":{"a":"#{Promo_code}"}}`\
حيث تحتاج إلى وضع معرّف صفحتك الخاص بدلًا من 1HfnHDbJYTGz68-3KWIcRISncTmdEn8v7Vf\_OKvDMrOI

يجب أن تنشئ شيئًا مثل هذا:

![](https://lh4.googleusercontent.com/Eivmw4kvkhay9Mt7Lc8pZiby50doKFXS8QDuFR75JJwP2UKLAs3EDUuB4IoWG0h8nl3f9xXk4TtEzfqNhxNhtAF6DQVg7QHCDy9bZRrAi9N2HAnWVv6gByBr46p0IzKg0338chEt1cWplmhvKg)


---

# 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/myzat-khash/alaml-ma-akwad-alkhsm.md?ask=<question>
```

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.