> ## 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 Flows: الشاشات والحالات والقواعد

> ما هي WhatsApp Flows، والـ Flows الثابتة وذات نقطة النهاية، والحالات التي يمر بها الـ Flow، وما تشترطه Meta قبل النشر، وكيف يبنيها Flowella.

WhatsApp Flow نموذج أو تطبيق قصير يُفتح داخل محادثة WhatsApp. ينقر العميل على زر، فتنزلق شاشة إلى الأعلى تتضمن أسئلة أو قوائم منسدلة أو أدوات اختيار التاريخ أو مربعات الموافقة، وتعود إجاباته إليك عندما يرسلها. تُعرَّف Flows بـ **Flow JSON**، وتُنشر لدى Meta، وتُرسل من زر في قالب أو من رسالة تفاعلية.

> [!NOTE]
>
> **في Flowella.** مدعوم. يبني Flowella الـ Flows من نماذج HubSpot الخاصة بك، أو من الصفر في [مصمم Flow](https://knowledge.flowella.io/ar/app/flow-designer.md)، وينشرها نيابةً عنك، فلا تكتب Flow JSON أبدًا. يرسل Flowella الـ Flows من زر Flow في قالب، ويسجّل كل عملية إرسال. راجع [Flows](https://knowledge.flowella.io/ar/app/flows.md).

## اللبنات الأساسية

| المصطلح | معناه |
| - | - |
| **Flow** | مهمة واحدة يُكملها العميل، مثل "حجز زيارة" أو "طلب عرض سعر" |
| **الشاشة** | صفحة واحدة من الـ Flow، لها مكوناتها الخاصة وزر في الأسفل |
| **المكون** | عنصر واحد على الشاشة: نص، أو حقل إدخال، أو قائمة، أو أداة اختيار التاريخ، أو اشتراك، أو صورة |
| **Flow JSON** | تعريف الشاشات والمكونات، مع رقم إصدار. راجع [إصدارات Flow JSON](https://knowledge.flowella.io/ar/whatsapp/flows/flow-json-versions.md). |
| **نقطة النهاية** | خادم اختياري يستدعيه الـ Flow لتحميل البيانات أو التحقق من الإجابات أثناء تعبئة العميل له |
| **Flow token** | معرّف يضبطه النشاط التجاري عند إرسال الـ Flow، ويُعاد مع الإجابات حتى يمكن مطابقتها مع الشخص الصحيح |

## Flows الثابتة وذات نقطة النهاية

| | Flow ثابت | Flow ذو نقطة نهاية |
| - | - | - |
| كيف يعمل | كل شيء موجود في Flow JSON. تصل الإجابات عندما ينتهي العميل. | يستدعي الـ Flow خادمك أثناء عمله، مثلًا للتحقق من الإجابات أو تحميل الخيارات. |
| مراقبة السلامة | لا شيء | تراقب Meta الخادم ويمكنها خنق الـ Flow أو حظره. راجع [سلامة Flow](https://knowledge.flowella.io/ar/whatsapp/flows/flow-health.md). |
| الإعداد | لا شيء سوى النشر | مفتاح تشفير على رقم الهاتف وخادم يرد على فحوص السلامة. راجع [نقاط نهاية Flow والأمان](https://knowledge.flowella.io/ar/whatsapp/flows/flow-endpoints-and-security.md). |

> [!NOTE]
>
> **في Flowella.** الـ Flows المبنية من نماذج HubSpot هي Flows ذات نقطة نهاية: يستضيف Flowella نقطة النهاية، التي تتحقق من كل عملية إرسال مقابل نموذج HubSpot الحالي قبل أن يرى العميل شاشة الشكر. أما Flows المنشأة من مصمم Flow ومن Flowella API فهي ثابتة.

## ما تشترطه Meta

يمكن لأي شخص بناء Flow، لكن لنشره وإرساله تشترط Meta ما يلي:

* [نشاط تجاري موثَّق](https://knowledge.flowella.io/ar/whatsapp/accounts/business-verification.md).
* رقم هاتف مسجَّل في WhatsApp Business Account.
* تصنيف جودة مراسلة جيد. راجع [تصنيف الجودة](https://knowledge.flowella.io/ar/whatsapp/limits/quality-score.md).
* Flow JSON صالح بإصدار غير مجمَّد وغير منتهي الصلاحية.
* للـ Flows ذات نقطة النهاية، مفتاح تشفير موقَّع على الرقم ونقطة نهاية سليمة.

في Flowella، يظهر الشرط الناقص كشارة مثل **Verification required** أو **Registration required** عند المزامنة. راجع [أخطاء المزامنة](https://knowledge.flowella.io/ar/app/flows.md#sync-errors).

## الحالات التي يمر بها الـ Flow

| الحالة | من يضبطها | معناها |
| - | - | - |
| **Draft** | أنت | قيد البناء. لا يمكن إرساله إلا للاختبار، ويعرض شريط مسودة. الحالة الوحيدة التي يمكن فيها حذف الـ Flow. |
| **Published** | أنت | فعّال. يمكن إرساله إلى أي شخص. |
| **Throttled** | WhatsApp | نقطة النهاية أو التنقل بين الشاشات غير سليم. لا يزال بإمكان العملاء فتحه، لكن لا يمكنك إرساله إلا 10 مرات في الساعة. |
| **Blocked** | WhatsApp | ساءت السلامة. لا يمكنك إرساله، ولا يستطيع العملاء فتح Flows التي تلقوها بالفعل. |
| **Deprecated** | أنت | متوقف نهائيًا. لا يمكن إرساله، لكن العملاء الذين لديهم بالفعل قد يظلون قادرين على إرساله. |

حالتا Throttled وBlocked للـ Flows ذات نقطة النهاية فقط. يعيد WhatsApp الـ Flow إلى Throttled، ثم إلى Published، بمجرد تعافي السلامة.

> [!NOTE]
>
> **في Flowella.** تنشر المزامنة فورًا، دون خطوة مسودة. يرفض Flowella إرسال قالب يكون الـ Flow الخاص به متوقفًا (Deprecated). بالنسبة إلى Flows التي تديرها عبر Flowella API، يحدّث `GET /v1/flows/{id}` الحالة من Meta، ويُبلغ webhook من النوع `flow.status_updated` عن التغييرات. راجع [Webhooks](https://knowledge.flowella.io/ar/api-reference/webhooks.md).

## كيف يصل الـ Flow إلى العميل

| المسار | متى يمكنك استخدامه |
| - | - |
| **قالب بزر Flow** | في أي وقت، بعد اعتماد القالب. بهذه الطريقة تبدأ محادثة بـ Flow. |
| **رسالة Flow تفاعلية** | فقط ما دامت [نافذة الـ 24 ساعة](https://knowledge.flowella.io/ar/whatsapp/messaging/customer-service-window.md) الخاصة بالعميل مفتوحة |

راجع [إرسال Flows](https://knowledge.flowella.io/ar/whatsapp/flows/sending-flows.md).

## أين تعمل Flows

تُفتح Flows على Android 6.0 والإصدارات الأحدث وiOS 12 والإصدارات الأحدث. وأضافت Meta دعم WhatsApp Web وسطح المكتب اعتبارًا من ديسمبر 2025. راجع [دعم Flows على الأجهزة](https://knowledge.flowella.io/ar/whatsapp/flows/flows-client-support.md).

## ذات صلة

> [card] [Flows في Flowella](https://knowledge.flowella.io/ar/app/flows.md)
>
> حوّل نموذج HubSpot إلى Flow.

> [card] [مصمم Flow](https://knowledge.flowella.io/ar/app/flow-designer.md)
>
> ابنِ Flow دون HubSpot.

> [card] [مكونات Flow وحدودها](https://knowledge.flowella.io/ar/whatsapp/flows/flow-components-and-limits.md)
>
> ما يمكن أن تتسع له الشاشة.

> [card] [رموز أخطاء Flows](https://knowledge.flowella.io/ar/whatsapp/errors/flows-error-codes.md)
>
> أخطاء النشر والإرسال.

تمت المراجعة مقابل وثائق Meta في 18 نوفمبر 2026: [WhatsApp Flows overview](https://developers.facebook.com/documentation/business-messaging/whatsapp/flows/guides) و[Lifecycle of a Flow](https://developers.facebook.com/documentation/business-messaging/whatsapp/flows/guides/lifecycle) و[Sending a Flow](https://developers.facebook.com/documentation/business-messaging/whatsapp/flows/guides/sendingaflow).


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