# كيفية إرسال الرسائل الحيوية

الرسائل الحيوية، مثل تأكيدات الطلبات، وتجديد الاشتراكات، وإعادة تعيين كلمات المرور، وتحديثات الشحن، أو إشعارات الدفع، ضرورية لتزويد المستخدمين بمعلومات ذات صلة وفي الوقت المناسب بناءً على إجراءات محددة. يتيح لك Pushwoosh أتمتة هذه الرسائل باستخدام أداة **Customer Journey Builder**.

## المتطلبات الأساسية
<Aside type="caution" icon="setting" title="مطلوب مساعدة المطورين">
ستحتاج إلى مساعدة من فريق التطوير لديك لإكمال هذا الإعداد.
</Aside>

قبل إعداد الرسائل الحيوية، تأكد من أن:

*   [**Pushwoosh SDK**](/ar/developer/pushwoosh-sdk/pushwoosh-sdk-overview) مدمج في تطبيق الجوال أو موقع الويب الخاص بك.
*   الأحداث (Events) التي تريد استخدامها في رحلات الرسائل الحيوية تم إنشاؤها وإعدادها وتتبعها في Pushwoosh. [تعرف على المزيد حول إنشاء الأحداث](/ar/product/audience-data-and-segmentation/events#implementation)

فيما يلي أمثلة على الرسائل الحيوية الشائعة وخطوات تكوينها باستخدام [**Customer Journey Builder**](/ar/product/customer-journey/pushwoosh-journey-overview).

## إرسال تأكيد الطلب

لإرسال رسائل تأكيد طلب مخصصة تلقائيًا عند وقوع حدث شراء، اتبع الخطوات التالية:

1.  في حساب Pushwoosh الخاص بك، انتقل إلى **Campaigns > Customer Journey Builder** وانقر على **Create campaign** لبدء بناء تدفق الرسائل الحيوية.
2.  في **Customer Journey Builder**، أضف عنصر **Trigger-based entry element** إلى لوحة العمل وحدد حدث [PW_InAppPurchase](/ar/product/audience-data-and-segmentation/events/default-events#pw_inapppurchase) (حدث افتراضي). تأكد من تكوين الحدث بشكل صحيح. [تعرف على المزيد](/ar/product/audience-data-and-segmentation/events/default-events#pw_inapppurchase)

<Aside type="tip">
إذا كان تطبيقك يتطلب حدثًا مخصصًا، فقم بإنشائه وإعداده مسبقًا. [تعرف على المزيد حول إنشاء الأحداث](/ar/product/audience-data-and-segmentation/events/custom-events).
</Aside>

<img src="/how-to-create-campaigns-how-to-send-transactional-messages-1.webp" alt="لوحة عمل Customer Journey Builder تظهر عنصر Trigger-based entry element مع تحديد حدث PW_InAppPurchase لإعداد تأكيد الطلب"/>

3.  أضف عنصر [**إشعار دفع (push notification)**](/ar/product/customer-journey/journey-elements#push) إلى لوحة العمل. أنشئ محتوى الرسالة، واستخدم العناصر النائبة مثل `{order_id}` لتخصيص الرسالة.

### مثال على محتوى الإشعار

**العنوان**: "تأكيد الطلب"

**الرسالة**: "شكرًا لطلبك رقم `{order_id}`! سيتم شحن أغراضك قريبًا."

<img src="/how-to-create-campaigns-how-to-send-transactional-messages-2.webp" alt="معاينة محتوى إشعار الدفع تظهر رسالة تأكيد الطلب مع العنصر النائب للتخصيص order_id"/>

4.  للتأكد من تسليم الرسالة بغض النظر عن أي حدود للرسائل، حدد [**إرسال الرسائل بدون تحديد التكرار العالمي (Send messages without global frequency capping)**](/ar/product/messaging-channels/global-frequency-capping/#ignore-global-frequency-capping) في إعدادات التسليم.

<img src="/shared-53.webp" alt="إعدادات التسليم مع تحديد خيار إرسال الرسائل بدون تحديد التكرار العالمي للرسالة الحيوية"/>

5.  **إنهاء وإطلاق الرحلة (Journey)**. قم بتكوين الرسالة، وأي خطوات اختيارية للتجزئة أو الانتظار. أضف [**عنصر الخروج (Exit element)**](/ar/product/customer-journey/journey-elements#exit-from-journey) وانقر على **Launch** لبدء الرحلة.

<img src="/how-to-create-campaigns-how-to-send-transactional-messages-3.webp" alt="رحلة عميل (Customer Journey) مكتملة مع تكوين عنصر الخروج وجاهزة للإطلاق"/>

سيتم الآن إرسال الرسالة الحيوية تلقائيًا عند استيفاء شروط المشغل.

## إرسال بريد إلكتروني لتجديد الاشتراك

باستخدام خدمات إدارة الاشتراكات التابعة لجهات خارجية مثل [**Adapty**](/ar/product/integrations/adapty-integration)، و[**Apphud**](https://docs.apphud.com/docs/pushwoosh)، وما إلى ذلك، يمكنك إرسال إشعارات تجديد أو رسائل بريد إلكتروني تلقائيًا للمستخدمين عند انتهاء صلاحية اشتراكهم، لحثهم على التجديد. للقيام بذلك، اتبع ما يلي:

1.  أولاً، قم بتكوين تكامل الخدمة مع Pushwoosh. [تعرف على المزيد حول عمليات التكامل المتاحة](/ar/product/integrations/#in-app-purchases)
2.  بعد ذلك، قم بإعداد حدث **Subscription_expired** في خدمة إدارة الاشتراكات التي اخترتها. عندما ينتهي اشتراك المستخدم، سترسل الخدمة حدث **subscription expired** إلى Pushwoosh.
3.  بمجرد إعداد الحدث، في **Customer Journey Builder**، انقر على **Create campaign** وأضف عنصر **Trigger-based entry element** إلى لوحة العمل.
4.  حدد حدث **subscription expired** المرسل من خدمة الطرف الثالث.

<img src="/how-to-create-campaigns-how-to-send-transactional-messages-4.webp" alt="عنصر Trigger-based entry element تم تكوينه بحدث انتهاء الاشتراك من خدمة طرف ثالث"/>

5.  أضف [**عنصر البريد الإلكتروني (email element)**](/ar/product/customer-journey/journey-elements#email) إلى لوحة العمل وحدد محتوى البريد الإلكتروني الذي أنشأته مسبقًا.

### مثال على محتوى البريد الإلكتروني

***الموضوع**: "انتهت صلاحية اشتراكك - جدد الآن لتبقى على اتصال!"*

***النص:***

*مرحباً،*

*لقد لاحظنا أن اشتراكك قد انتهت صلاحيته، ولا نريدك أن تفوت جميع المزايا الرائعة! جدد اشتراكك اليوم لمواصلة الاستمتاع بوصول غير منقطع إلى خدماتنا.*

*\[جدد اشتراكي]*

*شكرًا لكونك عميلاً مميزًا. نتطلع إلى عودتك!*

6.  للتأكد من تسليم الرسالة بغض النظر عن أي حدود للرسائل، حدد [**إرسال الرسائل بدون تحديد التكرار العالمي (Send messages without global frequency capping)**](/ar/product/messaging-channels/global-frequency-capping/#ignore-global-frequency-capping) في إعدادات التسليم.

7.  أكمل تكوين الرحلة (Journey) وانقر على **Launch campaign.**

<img src="/how-to-create-campaigns-how-to-send-transactional-messages-5.webp" alt="رحلة بريد إلكتروني لتجديد الاشتراك مكتملة وجاهزة للإطلاق"/>

بمجرد الإعداد، سيتم إرسال إشعارات التجديد تلقائيًا عند تشغيل حدث انتهاء الاشتراك بواسطة خدمة الطرف الثالث.

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

لإرسال بريد إلكتروني لإعادة تعيين كلمة المرور، ستحتاج إلى إعداد حدث إعادة تعيين كلمة المرور، وتكوين رابط إعادة تعيين كلمة المرور من جانبك، ثم [بناء رحلة عميل (Customer Journey)](/ar/product/customer-journey/create-a-customer-journey-for-your-project) لإرسال البريد الإلكتروني.

اتبع الخطوات أدناه لإكمال الإعداد:

### الخطوة 1. تكوين حدث إعادة تعيين كلمة المرور في Pushwoosh

عندما يطلب المستخدم تغيير كلمة المرور، فإنك تقوم بتشغيل حدث، مثل **password change requested**. تحتاج إلى إعداد هذا الحدث مسبقًا.

1.  انتقل إلى **Events** في لوحة تحكم Pushwoosh وانقر على **Create event**.
2.  قم بتسمية الحدث، على سبيل المثال، **Password reset request**.
3.  أضف السمات التالية إلى الحدث:

| اسم السمة | النوع | الوصف | قيمة مثال |
| ----- | ----- | ----- | ----- |
| reset_link | String | رابط إعادة تعيين كلمة المرور الفريد. | https://yourapp.com/reset-password?token=abc |
| user_name | String | اسم المستخدم للتخصيص. | John |
| token_durability | Integer | صلاحية الرمز بالثواني (على سبيل المثال، 24 ساعة). | 86400 |
| date | Date | تاريخ ووقت طلب إعادة التعيين. | 2024-11-18T10:00:00Z |

تعمل هذه السمات كعناصر نائبة، حيث تتلقى بيانات ديناميكية من نظامك عند تشغيل الحدث.

<Aside type="caution" title="هام">
في سمات الحدث، يجب عليك تمرير رابط فريد لإعادة تعيين كلمة المرور تقوم بإنشائه من جانبك، أو مفتاح فريد يجب تضمينه في الرابط لكي يعمل. يجب أن يحتوي هذا الرابط على رمز (token) فريد يتم تخصيصه لكل مستخدم وتضمينه في عنوان URL من خلال سمة حدث مرسلة من نظامك. يجب أن يكون للرمز فترة انتهاء صلاحية (على سبيل المثال، 24 ساعة) لضمان الأمان، مما يسمح للمستخدمين بإعادة تعيين كلمة المرور الخاصة بهم فقط خلال الإطار الزمني المحدد.
</Aside>

<img src="/how-to-create-campaigns-how-to-send-transactional-messages-6.webp" alt="واجهة تكوين الحدث تظهر حدث طلب إعادة تعيين كلمة المرور مع السمات المطلوبة"/>

قم بإعداد الحدث في تطبيقك. [تعرف على المزيد حول إعداد الأحداث المخصصة](/ar/product/audience-data-and-segmentation/events#implementation)

### الخطوة 2. إنشاء رابط إعادة تعيين كلمة المرور

عندما يطلب المستخدم إعادة تعيين كلمة المرور (على سبيل المثال، بالنقر على "نسيت كلمة المرور")، ستحتاج إلى:

1.  **إنشاء رمز فريد (token)**. قم بإنشاء رمز آمن تم إنشاؤه عشوائيًا للمستخدم. على سبيل المثال، 12345-abcde-67890.
2.  اجمع الرمز مع عنوان URL لإعادة تعيين كلمة المرور. على سبيل المثال، https://yourapp.com/reset-password?token=12345-abcde-67890.
3.  احفظ الرمز في قاعدة البيانات الخاصة بك، مرتبطًا بحساب المستخدم، وقم بتعيين وقت انتهاء الصلاحية (على سبيل المثال، 24 ساعة).
4.  قم بتضمين رابط إعادة التعيين في سمة الحدث reset_link عند تشغيل حدث **Password Reset Request**.

### الخطوة 3. إنشاء محتوى البريد الإلكتروني

1.  انتقل إلى **Email content** في Pushwoosh وقم بإنشاء محتوى بريد إلكتروني جديد. [تعرف على المزيد](/ar/product/content/email-content/drag-and-drop-email-editor#create-email-content)
2.  أضف عناصر نائبة للمحتوى الديناميكي:
    1.  `{reset_link}` لرابط إعادة تعيين كلمة المرور.
    2.  `{user_name}` لاسم المستخدم.
    3.  `{token_durability}` لوقت انتهاء صلاحية الرابط.

<img src="/how-to-create-campaigns-how-to-send-transactional-messages-7.webp" alt="محرر محتوى البريد الإلكتروني مع عناصر نائبة لحقول reset_link و user_name و token_durability"/>

### الخطوة 4. إنشاء الحملة

1.  انتقل إلى قسم **Customer Journey** في Pushwoosh وانقر على **Create Campaign**.
2.  اسحب وأفلت عنصر **Trigger-based entry** على لوحة العمل.
3.  قم بتكوين المشغل ليتم تفعيله عندما يرسل نظامك حدث **Password Reset Request**.

<img src="/how-to-create-campaigns-how-to-send-transactional-messages-8.webp" alt="لوحة عمل Customer Journey تظهر عنصر Trigger-based entry element تم تكوينه لحدث طلب إعادة تعيين كلمة المرور"/>

4.  أضف عنصر **Email** إلى لوحة العمل.

5.  اربط البريد الإلكتروني بعنصر **Trigger-based entry**.

6.  حدد محتوى البريد الإلكتروني الذي تم إنشاؤه مسبقًا مع العناصر النائبة لرابط إعادة التعيين وتفاصيل المستخدم.

<img src="/how-to-create-campaigns-how-to-send-transactional-messages-9.webp" alt="عنصر البريد الإلكتروني مرتبط بمدخل المشغل مع محتوى بريد إلكتروني لإعادة تعيين كلمة المرور وعناصر نائبة ديناميكية"/>

7.  للتأكد من تسليم الرسالة بغض النظر عن أي حدود للرسائل، حدد **Send messages without global frequency capping** في إعدادات التسليم.

8.  بعد إضافة محتوى الرسالة، تأكد من تكوين جميع الخطوات في الرحلة بشكل صحيح. أضف عنصر **Exit** وانقر على **Launch campaign** لبدء الرحلة.

<img src="/how-to-create-campaigns-how-to-send-transactional-messages-10.webp" alt="رحلة بريد إلكتروني لإعادة تعيين كلمة المرور مكتملة مع تكوين عنصر الخروج وجاهزة للإطلاق"/>

بمجرد التفعيل، سيتم إرسال **رسالة إعادة تعيين كلمة المرور** تلقائيًا عندما يطلب المستخدم إعادة تعيين كلمة المرور الخاصة به، مما يوفر تجربة سلسة وآمنة.