# كيفية استخدام جداول Google للرسائل الجماعية

* [كيفية إعداد ورقة](#how-to-set-up-the-sheet)
* [كيفية تفعيل سكربت](#how-to-activate-the-script)
* [كيفية إعداد روبوت الدردشة](#how-to-configure-the-chat-bot)
* [كيفية إعداد مُشغِّل](#how-to-set-up-a-trigger)

## كيفية إنشاء رسائل بريدية بمساعدة Google Sheets

كيف يعمل: يجمع الروبوت العناوين الجديدة ويلصقها واحدًا تلو الآخر في العمود الأول (A3:A في ورقة "Sending"). يتم تشغيل سكربت Google عندما يتم ضبط الوقت أو عند تغيير الورقة (حسب نوع المُشغِّل)، حيث ينشئ رسالة بريدية بالعناوين الجديدة وينقلها إلى ورقة "Log" مع طابع زمني.

```
function SendMail() {

var ss = SpreadsheetApp.getActiveSpreadsheet()
var sheet = ss.getSheetByName("Sending")
var email = sheet.getRange("a3:a").getValues()
var subj = sheet.getRange("c2").getValue()
var body = sheet.getRange("d2").getValue()
var arr = []

MailApp.sendEmail(email, subj, body)
arr = [[new Date(), email]]

//write sent addresses into Log
ss.getSheetByName("Log").getRange(ss.getSheetByName("Log").getLastRow()+1, 1, 1, 2).setValues(arr)
//clear the Sending sheet
sheet.getRange("a3:a").clearContent()
}
```

يتكوّن الإعداد من 4 أجزاء: **إعداد الورقة، تفعيل السكربت، إعداد روبوت الدردشة** و **إعداد مُشغِّل**

## كيفية إعداد ورقة

أنشئ نسخة من [الورقة التي تحتوي على الكود](https://docs.google.com/spreadsheets/d/1SJYyF1YRJ-BWflqy_8Ad9zvbJCO1Tv7nIItiBadmeIc/edit?usp=sharing)‎: ملف -> إنشاء نسخة

![](https://lh4.googleusercontent.com/0znfipVFnBgjF0xaHim-CaAE2jpFerBN07E_eWb7w_6qg0-HKaL91a1GartyWuiNL-5IdyXEZ6eP9_hptfzLdas86wEnknas5lYRM155hbFBZvRjVMmhq3TPWH00hqNGpfTDHWTReIEVd9Y7JA)

لاحظ أنه مكتوب إن السكربتات ستُنسخ أيضًا - تأكد من ذلك عند نسخ الورقة. اضغط "إنشاء نسخة".

![](https://lh6.googleusercontent.com/WmeNROF_YPBTaR5YQ7pUu_YRO6sJ7VmZ9JUS3oOmpdDVDqFYJNV2sGPcSG8Vtya6jBe6ul9xTHU7z1YM0mK7PiKUMVrj4UqMpF7KmiDivpVEGAB1Q_Fsrq0UNap_sn30WUvt8eEJto-qEKFSMQ)

في ورقة "Sending" غيّر فقط العمودين B2 وC2:

![بخصوص الورقة: يلصق الروبوت العناوين في العمود الأول (A3:A في ورقة "Sending"). عليك تغيير عمودي الموضوع والرسالة فقط، لا شيء آخر](https://lh3.googleusercontent.com/dL8NVFfqvpbXApcPNBN98na1DpwkRt5h30uPtLspmvGgSHenjO3GWyLjV1TYjyXrlcb0qkBeNDNu5qJVZP4kBko_o9bVZW9hHpyd93ZSkGGP1lHAQCkN4xTn1SivbYo0ILKCdSdll_OA98sdMQ)

الآن عليك التحقق من صلاحية الوصول إلى ورقتك، ويجب أن تكون متاحة للتحرير لأي شخص لديه الرابط، كما في لقطة الشاشة أدناه.

![](https://lh4.googleusercontent.com/hUpiJdh33M7hKw-DG1jLic1N9vl6HSBnHet6TMKbATLsZG-CraY7-oI3hNKLKsCmlXXhP9QCfu5TdlN1F_odYBy1N0Eki9jebxEtPVowSBLMm61Ci2E5by80nQVg7dhrYWxV4Max2vCyvk9tcQ)

## كيفية تفعيل السكربت

في أوراقك: الإضافات -> Apps Script

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

اختر **"SendMail"**

![](https://lh3.googleusercontent.com/CznVVRkKKT4vG95VASXmWbFrnnptM91Bkaz_8oTcQ6i6mBJ7o8zaQOnKjtDo5r-DuCcoAsB24cA7wWz0TpkOzcXrLBIcWQlgk0Q8QJwOmtvW7OcyXjlB1klYsat4PG12j9UuhjB2Kc_3wkDi6Q)

اضغط **"تشغيل"**

![](/files/e1b67085d406200e26bd21981b64f04f14fc6527)

اضغط **"مراجعة الأذونات"**

![](https://lh5.googleusercontent.com/mkuOfM_1Q2ZOhrZV-y3wvdjSmiMIIVvG08hv15N9iWb5UkqKFUgOpvYFKFTNJdhn-6do7DyFTPDqwr4Zw9GlxvgaOdQp8ehiRCZKgumr9sDmhJsN-uD_saMsawV88YVm3fwe5nDEFvSdzVqxoQ)

اختر الحساب الذي تريد إرسال الرسائل البريدية منه.

![](https://lh4.googleusercontent.com/WMnh64nzsoFhNHlbTEOYeniFcXMd4UKOauXFxmTgOb_t4vHzyC_fb6bOl_WNxDRsDgYA9sggerakcy1_6SIZ_fG0PbKER8-cDR3swEngIaTcFD3aIfFVc-tkHUrl_qKHUVnWp7ooIiiNxjngLw)

اضغط **"متقدم"**

![](https://lh6.googleusercontent.com/KKVlceduQy1mvcFBb_Fzdkb9dAVCG4oBcxBkdSfBPV92_zkZGKn6sVpZfbrHVC8EQo3U_-7I1dGpkUzgYRCTrxvfg5Uu61ZJgcSVaEd5GJf2DSEEE2WMZmbB4l-ILT_ncPqeOvGbNlP-LQXcrA)

اضغط **"الانتقال إلى (اسم السكربت) (غير آمن)"**

![](https://lh3.googleusercontent.com/d0h-SyYP_emJpadCb4je04Md04JCj4W7Y6Nnk34LpFY96Vu_G_E6aJ8rhq1N-fJAdu0fYgisCgJLAuvD-ZwSaL5NlC_9k0Sasq5OWLMWyohx2Fok2oJFSy278l-9iDVPL8aHpMj6uu2S388F8A)

اضغط **"السماح"**

![](https://lh3.googleusercontent.com/ed24LwyVea_PNw09wUZNFWwC8Vlu7jt96z3hajRQz-rBR63Hjws473KrFhppSEMXdFJTHJ5dCfbz_UPl0lmdnZgiujvgOtDTgAGfNk9ajglJhTy8MvCJU71DGCo1TnlfkN_IPs7_kjLI2XswSA)

الآن عليك التأكد من أن السكربت تم تفعيله من خلال التحقق من رسالة التنبيه الأمني في حسابك

![](https://lh6.googleusercontent.com/CA0T1ucBr43qZm2mGtnNKXhQB7r6aAlLLD6dqZ60ADBGrH9ewKIENTx96ohZfPYlfL2rxSA9wOa_3off0NnimW3yUSiNVt34s1ko9TYfPEWhLxZBo-2GCYTo8ZfSrEikHbpkfkoQHMEeKfFPDA)

## كيفية إعداد روبوت الدردشة

لنأخذ كمثال المخطط التالي المكوّن من ثلاث كتل

![](https://lh3.googleusercontent.com/CZWqjtQ4jFIV44IYZGjF4K6HGaEBN2cdBFYGr1PbwoW-7_hq37l51n4aHFkH3pUZyAM5rrN9DoMxkZPxG26VYNqgGdmBmF9EChesJXIfcWtffqHskemFU5-kakeJcwzERMxxMsgVfFCIUrEx7A)

1\) الكتلة الخضراء الأولى **"التحقق من الشرط الأساسي"** يبدأ الحوار مع الروبوت. هنا نكتب العبارة التي ستبدأه في الشروط. وللتأكد من حفظ الإعدادات في الكتل، لا تنسَ الضغط على **"حفظ"** بعد الإضافة.

![](https://lh6.googleusercontent.com/6ffv52weuudLlHsC1AXgyl48u4QXdyxSv2O0K6sfxPVBrOlYJkGVbsqQ6hGNRsk4VjNGWZn9dtdCPjOWXKbujTm8iR_N-JL1L8hO4WKfixQ_FAY3eiN6m0H_5WCN-Adc5OwJ0G8UtfimAPbbgg)

2\) الآن أنشئ كتلة أسفلها وعدّل الاتصال. افتح تبويب "User enters data" والصق اسم المتغير (client\_mail كما في المثال). ثم ضع تعبيرًا نظاميًا في الشرط للتحقق من البريد الإلكتروني. في هذه المرحلة، من المهم التحقق من دقة البيانات المُدخلة، وإلا سيتجمّد السكربت كثيرًا. يمكنك استخدام أحد التعبيرين التاليين:

^\[a-z0-9]\[a-z0-9\_.-]*@(\[a-z0-9]+.)*\[a-z0-9]\[a-z0-9-]+.(\[a-z]{2,6})$

^\[-\w.]+@(\[A-z0-9]\[-A-z0-9]+.)+\[A-z]{2,4}$

![](https://lh6.googleusercontent.com/50dUCHfRgUdqhue-PmZ5nCi5ndIWEnZdCOZijnq6e26HtTVcgzQRzLSoYsVOJ0CMKDmuYLWEpbA5J29GDD4oO4xJsQoC9brKIpv7j-udJ3qsX335tMrFjsLvRIbW9c99Rwc14GaIM0gTBeE_kw)

المزيد عن التعبيرات النظامية [هنا](https://docs.salebot.ai/variables/list-of-useful-regular-expressions)

3\) الكتلة التالية هي التي تنقل البيانات إلى الورقة. اضبط كل شيء كما هو في لقطة الشاشة (وصف الحقول أدناه)

![](https://lh5.googleusercontent.com/zkwBa6IAlb8tbGQsyYyancfz-svS1jEZ_5IqOoW4hMqaupiEgFP7QboWH8t6C5a-efwgxdhOhMhi62LAG0leRyUsWBxFEOF5MVmouhAyPpxBTw7GH1ncpAjiz_tI7HMH834EAZvAD9UpPH55LA)

* اختر نوع طلب POST-json.
* الصق عنوان URL الخاص بالدالة في تبويب “URL request”.

  \_<https://store.salebot.ai/function/gsheets_&#x20>;
* الصق السطر التالي في تبويب “JSON parameters” \
  \
  \&#xNAN;*{"id": "(معرّفك id)", "mapping":{"a":"#{client\_mail}"}, "list\_name": "Sending"}*\
  \
  الصق معرّفك id من الرابط إلى ورقتك. يمكنك العثور عليه في الرابط إليها، بعد d/

![](https://lh5.googleusercontent.com/o6lwAhIQht-QCEaMmgKJigcS_YGkWcQ3lnyBL7ny0NTgcl160dBbwsu6lFuhjntkKxzElimLGXll5vhEv5ZlzqkQJ75A-TM9p_8Tr8cNVUCRTwQbp6f5UURrvAmzsxxrrJ3JkYDTfk0M100vjg)

## كيفية إعداد مُشغِّل

قبل إنشاء مُشغِّل، تحقق من أن الروبوت يكتب البيانات في الورقة وأن الدالة تعمل بشكل صحيح.

![](https://lh5.googleusercontent.com/of8l8zMhl_K_0TQu016FdRxrpqiynd7rSYtvDbURmpZw3Nl8fxA5tAdenyG-r1bNVHW7kZmZCnCwNin3-auJpSPKQIa6WvdPqmbQNsR0GzEmbHEGM18ZIGkscbggkkDVbnKH07NsuTrVF_wp-w)

إذا سار كل شيء بسلاسة، افتح Extensions -> Apps Script -> SendMail ثم Triggers في القائمة على اليسار.

![](https://lh4.googleusercontent.com/C8vlOIX_davRzXgp6aqzkwnmNSIutirJSrajGNdyg2fDtTVZrk2s6l3KUBgo3DX_AgMKCCS1DQixPM6Wt72aGF6Pr2ExuUfGE1m76-nQj0J1dOUOk8_xnCNpKGpN8aoz1EAjyD1c87WuCqQNrQ)

أنشئ مُشغِّلًا جديدًا باستخدام الزر الموجود في الزاوية اليمنى السفلية من الشاشة

![](https://lh6.googleusercontent.com/rZBUefTUe_7NH70qsa9xEW_jbYf0IAGMvUcstUzHEoaZSUTzr041wisei6UNxCxFB1y938qHjg2gBnFGEdqB1_OLvarMltZQbYZxKw1LJuEE-BzDElQ1PtBjYOSjofG-QE8Ml6G2QDz77mKjSA)

اضبطه كما في لقطة الشاشة. إذا كنت تُعدّه ليعمل وفق الوقت، فاعلم أن الفترة الزمنية يجب ألا تقل عن 30 دقيقة. يمكنك اختيار القيم التي تريدها، لكن تذكّر أن هناك بعض [الحصص](https://developers.google.com/apps-script/guides/services/quotas)‎. ثم اضغط **"حفظ"**.

![](https://lh5.googleusercontent.com/K6zGZeA95Cxg0ylq4ZpwOjBGwovnvpAIHbxutgTT0pwosoQD2e69VhvM87O-qVwykxjIPCslC4Ht2eFSdl2ecAg4WTJ1CqKCEGNBnlf9vPqGtG3tncEyguFmv1WYn7zWhTV5iynnNdzibw6zLA)

الآن أصبح هناك مُشغِّل في القائمة. اكتمل الإعداد!

![](https://lh6.googleusercontent.com/jyjPMqqLvPL0yUZcvNFWexSmaCXJ91JyWykbMylzqitwEBKNtmU2SUo0gU4SQwd5unJLAcuphVMvD61IVR79lFhOdULbuNsaJwOgxkMRVq45RmVitPSr70YAw2HNqebe6IalO1mbey4ebZN1ng)

#### روابط أخرى مفيدة:

[حدود إرسال Gmail في Google Workspace](https://support.google.com/a/answer/166852?hl=en)

[مزيد من المعلومات حول خدمة Gmail](https://developers.google.com/apps-script/reference/gmail/)

[الحصص الخاصة بخدمات Google](https://developers.google.com/apps-script/guides/services/quotas)


---

# 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/kyfyh-astkhdam-jdawl-google-llrsael-aljmaayh.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.