> ## Documentation Index
> Fetch the complete documentation index at: https://knowledge.flowella.io/llms.txt
> Use this file to discover all available pages before exploring further.

# إرسال قالب WhatsApp إلى عدد كبير من جهات الاتصال من ملف CSV أو Excel

> أرسل قالب WhatsApp معتمدًا إلى ما يصل إلى 50,000 جهة اتصال من ملف CSV أو Excel، وجدول المهمة، وتابع التسليم وحالات الفشل في Flowella.

يرسل الإرسال الجماعي قالب WhatsApp معتمدًا واحدًا إلى قائمة من جهات الاتصال في مهمة واحدة. تسمي بعض الأدوات ذلك بثًّا (broadcast). تضيف الأرقام يدويًا أو تستورد ملف CSV أو Excel، ويرسل Flowella الرسائل في الخلفية.

> [!NOTE]
>
> لا يتضمن الإرسال الجماعي قائمة جهات اتصال ولا أداة لاختيار قوائم HubSpot. إذا كان جمهورك قائمة في HubSpot، فاستخدم بدلًا من ذلك مسار عمل في HubSpot مع الإجراء **Send WhatsApp Template**. راجع [إجراءات مسارات العمل](https://knowledge.flowella.io/ar/hubspot/workflow-actions.md).

## قبل أن تبدأ

* **من يستطيع الإرسال:** أي عضو في مؤسستك. تحتاج مؤسستك إلى اشتراك نشط أو فترة تجريبية مجانية.
* **قالب معتمد.** تبقى بطاقة **Bulk send** مقفلة حتى توافق Meta على القالب. راجع [القوالب](https://knowledge.flowella.io/ar/app/templates.md).
* **مستلمون وافقوا على الاستلام.** أرسل فقط إلى الأشخاص الذين وافقوا على تلقي رسائل WhatsApp من نشاطك التجاري. يتخطى Flowella كل من ألغى اشتراكه على الرقم الذي ترسل منه. راجع [إلغاء الاشتراك](https://knowledge.flowella.io/ar/app/opt-outs.md).
* **حصة كافية في الخطة.** يُحتسب الإرسال الجماعي ضمن حصة الرسائل في خطتك. راجع [الخطط والحدود](https://knowledge.flowella.io/ar/account/plans-and-limits.md).
* **مساحة كافية في حد المراسلة.** تضع Meta حدًا لعدد الأشخاص الفريدين الذين يمكنك مراسلتهم خارج نافذة الـ 24 ساعة خلال 24 ساعة متحركة. أبقِ كل مهمة ضمن حدك، وجدول بقية القائمة الكبيرة لأيام لاحقة. راجع [حدود المراسلة](https://knowledge.flowella.io/ar/meta/messaging-limits.md).
* **قيم احتياطية مؤكدة**، إذا كانت بعض جهات الاتصال قد تحتوي على قيم فارغة. راجع [القيم الاحتياطية](https://knowledge.flowella.io/ar/app/template-variables.md#القيم-الاحتياطية).

## ما يمكنك تخصيصه

| جزء القالب | هل يمكن أن يختلف لكل مستلم؟ |
| - | - |
| متغيرات النص الأساسي (`{{1}}` و`{{2}}` وهكذا) | نعم، عمود واحد لكل متغير. |
| متغير في نهاية زر URL | نعم، عمود واحد لكل متغير زر. |
| متغير الترويسة النصية | لا. يحصل كل مستلم على القيمة الاحتياطية للمتغير. |
| ترويسة صورة أو فيديو أو مستند | لا. ملف واحد للمهمة بأكملها. |
| ترويسة الموقع | لا. لا يستطيع الإرسال الجماعي تعيين موقع، لذا لا تستخدمه مع قوالب الموقع. |
| بطاقات الكاروسيل | لا. يحصل كل مستلم على البطاقات نفسها. |

## إعداد ملف المستلمين

تخطَّ هذا القسم إذا كنت تخطط لكتابة الأرقام يدويًا.

1. افتح علامة التبويب **Send** الخاصة بالقالب. في بطاقة **Bulk send**، انقر على **Download sample file** واختر **Excel (.xlsx)** أو **CSV (.csv)**. يحتوي الملف النموذجي على الأعمدة الصحيحة لهذا القالب.
2. أضف صفًا واحدًا لكل مستلم.
3. احفظ الملف بصيغة `.xlsx` أو `.csv`.

### أعمدة الملف

| العمود | مطلوب | محتواه |
| - | - | - |
| `phone` (أو `e164`) | نعم | رقم المستلم بالتنسيق الدولي، مع رمز البلد، مثل `+447700900123` أو `447700900123` |
| `var1`، `var2` حتى `varN` | واحد لكل متغير في النص الأساسي | قيم `{{1}}` و`{{2}}` وهكذا، بالترتيب |
| `buttonvar1`، `buttonvar2` وهكذا | واحد لكل متغير زر | قيمة متغير الزر، مثل نهاية عنوان URL |

أسماء الأعمدة غير حساسة لحالة الأحرف ويمكن أن تأتي بأي ترتيب. يتجاهل Flowella الأعمدة الأخرى، مثل عمود الاسم الذي تحتفظ به للرجوع إليه.

```csv theme={null}
phone,var1,var2
+447700900123,Sam,AB-1234
+447700900456,Priya,AB-1235
14155550100,Jordan,AB-1236
```

لمزيد من المعلومات عن تنسيقات الأرقام، راجع [تنسيق رقم الهاتف](https://knowledge.flowella.io/ar/hubspot/phone-number-format.md).

### قواعد الملف

* استورد ملف `.csv` أو `.xlsx` واحدًا في كل مرة. يجب أن يكون حجمه أقل من 10 MB وألا يتجاوز 50,000 صف من المستلمين.
* ملفات `.xls` القديمة غير مدعومة. احفظها بصيغة `.xlsx` أو `.csv` أولًا.
* في مصنف Excel، يقرأ Flowella الورقة المسماة **Recipients**، أو الورقة الأولى إذا لم تكن موجودة.
* تُقرأ أرقام الهواتف المخزنة كأرقام في Excel كاملةً.
* تُستورد خلايا التاريخ في Excel بتنسيق يوم/شهر/سنة، مثل `27/06/2026`. لاستخدام تنسيق آخر، اكتب التاريخ كنص.
* يجب وضع قيم CSV التي تحتوي على فواصل أو فواصل أسطر بين علامتي اقتباس مزدوجتين. تعمل الملفات المحفوظة بصيغة CSV UTF-8 من Excel، وتُتجاهل الصفوف الفارغة في النهاية.

> [!TIP]
>
> املأ كل أعمدة المتغيرات في كل صف قبل استيراد الملف. بعد الاستيراد، تحقق من بضعة صفوف في القائمة للتأكد من أن كل قيمة في العمود الصحيح.

## إرسال المهمة

![بطاقة Bulk send في علامة التبويب Send الخاصة بقالب، مع المستلمين وقيم متغيراتهم، وImport file وAdd recipient وSend from channel وSchedule & limits وزر Enqueue send job](https://mintcdn.com/flowella/GmwkaQx8DHWkvE3D/images/Screenshots/flowella-bulk-send.png?fit=max\&auto=format\&n=GmwkaQx8DHWkvE3D\&q=85\&s=f906e2afd529ca656c391d1ffd60174d)

**1. افتح بطاقة Bulk send**

في صفحة **Templates**، افتح قائمة إجراءات القالب وانقر على **Send**. مرّر متجاوزًا **Test Template** إلى بطاقة **Bulk send**، تحت **Or send at scale**.

**2. أضف المستلمين**

تحت **Recipients**، انقر على **Add recipient** لإضافة صف يدويًا، أو انقر على **Import file** لاستيراد ملف `.csv` أو `.xlsx`.

يؤدي استيراد ملف إلى استبدال أي صفوف موجودة بالفعل في القائمة. يؤكد Flowella ذلك بالرسالة **Imported N recipients**. تحقق من العدد أسفل القائمة، مثل **250 recipients ready**.

**3. اختر رقم الإرسال**

تحت **Send from channel**، اختر رقم WhatsApp الذي ستُرسل منه. تعرض القائمة الأرقام الموجودة في WhatsApp Business Account الخاص بالقالب.

**4. عيّن جدولًا زمنيًا وحدودًا (اختياري)**

انقر على **Schedule & limits** لعرض مزيد من الخيارات:

* **Schedule (optional, local)**: تاريخ ووقت بالمنطقة الزمنية لجهاز الكمبيوتر الخاص بك. اتركه فارغًا للإرسال فورًا.
* **Max sends per hour (optional)**: عدد صحيح من 1 إلى 100,000. لا ينظّم وتيرة الإرسال حاليًا، لذا لا تعتمد عليه. لتوزيع قائمة كبيرة على مدى زمني، قسّمها إلى عدة مهام وجدول كلًّا منها.
* **Header media URL**: يظهر للقوالب التي تحتوي على ترويسة صورة أو فيديو أو مستند. إذا كان للقالب ملف نموذجي، يظهر النص **Using the template sample media from Meta.** وإن لم يكن، فالصق رابط `https://` عامًا للملف.

**5. ضع المهمة في قائمة الانتظار**

انقر على **Enqueue send job (N recipients)**. يؤكد Flowella ذلك بالرسالة **Bulk send job queued (N recipients)**، أو بـ **Bulk send scheduled for** والتاريخ للمهمة المجدولة. ثم يفتح علامة التبويب **Statistics**.

> [!TIP]
>
> قبل أي إرسال كبير، شغّل مهمة إلى بضعة أرقام خاصة بك. تحقق من أن كل متغير وزر يظهر كما تتوقع.

## التحقق من التقدم والنتائج

### شريط التقدم

بعد وضع المهمة في قائمة الانتظار، تعرض علامة التبويب **Statistics** تقدمها:

* يعرض الشريط **Bulk send in progress** مع عدد مثل **120/500 processed**. عند معالجة كل المستلمين، يتغير إلى **Bulk send complete** ثم يُغلق.
* يعرض **Current job summary** عدد الرسائل في حالات **Sent** و**Delivered** و**Read** و**Failed** و**Pending** و**Suppressed**. وللمهمة المجدولة، يعرض أيضًا **Scheduled for** والتاريخ.
* إذا توقفت المهمة قبل معالجة كل المستلمين، يعرض الشريط **Bulk send finished with unsent recipients**. انقر على **Resend unsent** لإعادة المحاولة للمستلمين الذين لم تصلهم الرسالة، بمن فيهم من فشل الإرسال إليهم. أما المستلمون الذين وصلتهم الرسالة بالفعل، أو الذين ألغوا اشتراكهم، فلا تُرسل إليهم مرة أخرى.

يظهر الشريط و**Current job summary** فقط للمهمة التي بدأتها من تلك الصفحة. تستمر المهمة في العمل إذا أغلقت الصفحة، ولا يرسل Flowella إشعارًا عند انتهائها. للتحقق منها لاحقًا، افتح علامة التبويب **Statistics** الخاصة بالقالب واقرأ سجل الإرسال.

### سجل الإرسال

يسرد **Send log** في علامة التبويب **Statistics** عمليات الإرسال التجريبي والإرسال الجماعي والإرسال من مسارات عمل HubSpot للقالب، مع الأعمدة **Time** و**Recipient** و**Name** و**Status** و**Channel** و**Details**. استخدم مربع البحث لتصفية الصفوف، أو اختر إجمالي حالة لعرض تلك الحالة فقط.

تعرض الحالة آخر حالة تسليم: **Pending** أو **Sent** أو **Delivered** أو **Read** أو **Failed** أو **Suppressed**. يشرح عمود **Details** الصفوف الفاشلة والمكبوتة، ويكون فارغًا للصفوف الأخرى.

| Details | معناها |
| - | - |
| **Invalid phone number.** | الرقم ليس رقمًا دوليًا صالحًا. |
| **Recipient opted out of messages on this channel.** | ألغت جهة الاتصال اشتراكها على الرقم الذي أرسلت منه، لذا لم يرسل Flowella الرسالة. |
| **Contact no longer exists in your workspace.** | حُذفت جهة الاتصال قبل أن يرسل Flowella الرسالة. |
| **Duplicate send suppressed within 15 seconds.** | أُرسل القالب نفسه إلى الرقم نفسه قبل أقل من 15 ثانية. راجع [التكرارات وعمليات الإرسال المتكررة](#التكرارات-وعمليات-الإرسال-المتكررة). |
| رسالة تذكر متغيرًا، مثل `Variable {{1}} is empty and has no fallback value` | كانت إحدى القيم فارغة وليس للقالب قيمة احتياطية مؤكدة لها. راجع [القيم الاحتياطية](https://knowledge.flowella.io/ar/app/template-variables.md#القيم-الاحتياطية). |
| **Delivery failed. No error detail was recorded.** | أبلغت Meta عن فشل دون ذكر سبب. |
| أي نص آخر | سبب الفشل من Meta، بلغة إنجليزية بسيطة عندما يتعرف Flowella على رمز الخطأ. راجع [رموز أخطاء Meta](https://knowledge.flowella.io/ar/troubleshooting/meta-error-codes.md). |

## التكرارات وعمليات الإرسال المتكررة

* **داخل المهمة الواحدة:** إذا ظهر رقم أكثر من مرة، يرسل Flowella إليه مرة واحدة، مستخدمًا أول صف يحتوي على ذلك الرقم. لا يشمل عدّاد التقدم إلا الأرقام الفريدة، لذا قد يكون أقل من العدد الظاهر على زر **Enqueue send job**.
* **خلال 15 ثانية:** إذا أُرسل القالب نفسه إلى الرقم نفسه من رقم WhatsApp نفسه مرتين خلال 15 ثانية، يرسله Flowella مرة واحدة. يظهر الإرسال الثاني بحالة **Suppressed**.
* **عمليات الإرسال اللاحقة:** بعد 15 ثانية، يرسل Flowella مرة أخرى. إذا استوردت الملف نفسه مرة أخرى أو وضعت القائمة نفسها في قائمة الانتظار مجددًا، فسيتلقى الجميع الرسالة مرة ثانية.

## القوالب الموقوفة مؤقتًا أو المعطلة

إذا أوقف WhatsApp القالب مؤقتًا أو عطّله بينما المهمة في قائمة الانتظار أو مجدولة أو قيد التنفيذ، يحتجز Flowella المهمة بدلًا من إرسالها. عندما تستعيد Meta القالب، تستمر المهمة مع المستلمين الذين لم تصلهم الرسالة بعد. يخبرك إشعار **Message template approved** بعدد المهام المحتجزة التي استُؤنفت.

تبقى مهمة القالب المعطل محتجزة. ولا تستمر إلا إذا وافقت Meta على القالب مرة أخرى بعد تعديله وإعادة تقديمه. راجع [شارات سلامة التسليم](https://knowledge.flowella.io/ar/app/templates.md#شارات-سلامة-التسليم-في-قائمة-القوالب).

## إلغاء مهمة أو تغييرها

لا يمكنك إلغاء مهمة أو إيقافها مؤقتًا أو تعديلها في التطبيق بعد وضعها في قائمة الانتظار، ويشمل ذلك المهمة المجدولة. تحقق من قائمة المستلمين ورقم الإرسال والجدول الزمني قبل النقر على **Enqueue send job**.

## الفترة التجريبية المجانية

في الفترة التجريبية المجانية، يتحقق Flowella من المهمة بأكملها مقارنةً بحصتك التجريبية المتبقية قبل وضعها في قائمة الانتظار. إذا كانت المهمة أكبر مما تبقى، يرفض Flowella المهمة بأكملها ويعرض **You have reached your plan's monthly WhatsApp message limit. Upgrade your plan to continue sending.** لا يُرسل أي شيء. أرسل إلى عدد أقل من المستلمين، أو قم بالترقية. راجع [الخطط والحدود](https://knowledge.flowella.io/ar/account/plans-and-limits.md).

تحمل القوالب التي تنشئها خلال الفترة التجريبية التذييل الثابت `Reply STOP to opt out. Powered by Flowella.io`.

## استكشاف الأخطاء وإصلاحها

> **زر Enqueue send job غير متاح**
>
> يوضح النص أعلى الزر السبب:
>
> * **Bulk send is available once Meta approves this template.** انتظر الموافقة.
> * **Choose a WhatsApp channel to send from.** اختر رقمًا تحت **Send from channel**.
> * **Invalid phone number.** أحد الأرقام التي كتبتها غير صالح. صحّحه، أو احذف الصف.
> * **Add at least one phone number, or import a CSV or Excel file.** لا تحتوي القائمة على أرقام صالحة بعد.
> * **Fix template errors before sending.** افتح علامة التبويب **Editor** وأصلح القالب.

> **عدد المستلمين أقل من عدد الصفوف في ملفي**
>
> يتخطى Flowella صفوف الملف التي تحتوي على رقم هاتف مفقود أو غير صالح، دون تحذير. تحتاج الأرقام إلى رمز البلد: الرقم المحلي مثل `07700 900123` غير صالح. كما يرسل Flowella مرة واحدة فقط إلى كل رقم، لذا لا تُحتسب الصفوف المكررة.

> **لا يتم استيراد الملف**
>
> * **Choose a .csv or .xlsx file.**: الملف بتنسيق آخر.
> * **Legacy .xls files are not supported. Save as .xlsx or .csv and try again.**
> * **That file is too large. Use a file under 10 MB.**
> * **That file has too many rows. Import at most 50,000 recipients.** قسّم القائمة إلى عدة مهام.
> * **No recipient rows parsed from the file.**: لا يحتوي أي صف على رقم هاتف صالح.
> * **CSV must include a phone column header**: سمِّ عمود الهاتف `phone` أو `e164`.

> **This template requires a media header URL before queueing bulk send.**
>
> يحتوي القالب على ترويسة وسائط لكن دون ملف نموذجي. افتح **Schedule & limits** والصق رابط `https://` عامًا للملف في **Header media URL**.

> **فشلت صفوف برسالة عن متغير فارغ**
>
> كانت إحدى القيم فارغة وليس للقالب قيمة احتياطية مؤكدة. املأ القيمة، أو أكّد القيم الاحتياطية للقالب، ثم أرسل إلى هؤلاء المستلمين في مهمة جديدة. راجع [القيم الاحتياطية](https://knowledge.flowella.io/ar/app/template-variables.md#القيم-الاحتياطية).

> **رُفضت المهمة برسالة عن حد الخطة**
>
> في الفترة التجريبية المجانية، تُرفض بالكامل أي مهمة أكبر من حصتك المتبقية. راجع [الفترة التجريبية المجانية](#الفترة-التجريبية-المجانية).

> **فشلت صفوف كثيرة بأخطاء من Meta**
>
> اقرأ عمود **Details**، ثم راجع [رموز أخطاء Meta](https://knowledge.flowella.io/ar/troubleshooting/meta-error-codes.md) و[الرسائل غير المسلّمة](https://knowledge.flowella.io/ar/troubleshooting/messages-not-delivered.md).

## ذات صلة

> **[القوالب](https://knowledge.flowella.io/ar/app/templates.md)**
>
> أنشئ قوالب WhatsApp واختبرها وأدرها.

> **[متغيرات القوالب](https://knowledge.flowella.io/ar/app/template-variables.md)**
>
> المتغيرات والعينات والقيم الاحتياطية.

> **[حدود المراسلة](https://knowledge.flowella.io/ar/meta/messaging-limits.md)**
>
> عدد الأشخاص الذين تسمح لك Meta بمراسلتهم خلال 24 ساعة.

> **[الخطط والحدود](https://knowledge.flowella.io/ar/account/plans-and-limits.md)**
>
> حصص الرسائل وحدود الفترة التجريبية والتجاوزات.

> **[إلغاء الاشتراك](https://knowledge.flowella.io/ar/app/opt-outs.md)**
>
> كيف يتتبع Flowella الموافقة وحالات إلغاء الاشتراك.

> **[نظرة عامة على الحملات](https://knowledge.flowella.io/ar/campaigns/overview.md)**
>
> اختر بين الإرسال الجماعي ومسارات عمل HubSpot والإعلانات.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.