# دليل إعداد المشروع

يوجز هذا الدليل خطوات إعداد مشروع Pushwoosh الخاص بك وقنوات المراسلة مثل الإشعارات الفورية، وصندوق الرسائل الواردة، والرسائل داخل التطبيق، والبريد الإلكتروني، وWhatsApp، وLINE، وKakao، والرسائل القصيرة (SMS)، وبطاقات Apple وGoogle Wallet. اعتمادًا على القناة، ستقوم بتكوين إعدادات المنصة، ودمج حزم SDK (إذا لزم الأمر)، وتسجيل بيانات المستخدم.

بمجرد تكوين القناة، يمكنك البدء في إرسال الرسائل من خلال لوحة تحكم Pushwoosh أو عبر API.

## المتطلبات الأساسية

قبل البدء في العمل مع أي قناة اتصال، أكمل هذه الخطوات:

*   **إنشاء حساب Pushwoosh**

*   **استخدم مشروعك الافتراضي أو أنشئ مشروعًا جديدًا**
    يتم إنشاء مشروع افتراضي (**My project**) عند التسجيل. استخدمه لتطبيق واحد عبر منصات متعددة، أو أنشئ مشاريع منفصلة لتطبيقات مختلفة.
    <LinkCard title="تعرف على كيفية إنشاء مشروع" href="/product/first-steps/start-with-your-project/create-your-project/" />

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

<TitleIcon icon="push">
### الإشعارات الفورية
</TitleIcon>

أرسل تنبيهات مخصصة وفي الوقت المناسب للمستخدمين عبر منصات الجوال والويب.

لتمكين الإشعارات الفورية:

<Steps>
1. **تكوين منصتك**

   قم بإعداد بيانات الاعتماد لمنصات iOS، وAndroid، وHuawei، والويب. [اعرف المزيد](/ar/developer/first-steps/connect-messaging-services/configure-project/)

2. **دمج SDK**

   أضف Pushwoosh SDK إلى تطبيقك أو موقعك الإلكتروني. [اعرف المزيد](/ar/developer/pushwoosh-sdk/pushwoosh-sdk-overview/)

3. **اختبار التكامل ونشر تطبيقك أو موقعك الإلكتروني**

   تأكد من أن وظيفة الإشعارات الفورية تعمل كما هو متوقع.
   *   بالنسبة للتطبيقات، قم بإصدار النسخة التي تحتوي على SDK المدمج إلى متاجر التطبيقات.
   بالنسبة للمواقع الإلكترونية، قم فقط بتحديث موقعك المباشر. [اعرف المزيد](/ar/developer/first-steps/test-your-integration/test-devices/)

4. **تسجيل المستخدمين**

   اشترك في الأجهزة وقم بمزامنة بيانات المستخدم لتمكين تسليم الإشعارات الفورية. [اعرف المزيد](/ar/developer/first-steps/subscribe-users/)

5. **تعيين معرفات مستخدم مخصصة (User IDs)**

   قم بتعيين User ID مخصص لتوحيد أجهزة/جهات اتصال الشخص تحت ملف تعريف واحد. [اعرف المزيد](/ar/developer/first-steps/collecting-user-ids/)
</Steps>

بمجرد اكتمال الإعداد، يمكنك البدء في [إرسال الإشعارات الفورية عبر لوحة التحكم](/ar/product/messaging-channels/push-notifications/#start-sending-different-types-of-push-notifications) أو استخدام طريقة API [`Notify`](/ar/developer/api-reference/messaging-api-v2/notify/).

<TitleIcon icon="download">
### صندوق الرسائل الواردة
</TitleIcon>

خزّن الرسائل المهمة في مساحة مخصصة داخل التطبيق للوصول إلى المستخدمين حتى لو اختاروا عدم تلقي الإشعارات الفورية.

لتمكين صندوق الرسائل الواردة:

<Steps>
1. **تكوين المنصات**

   قم بإعداد تطبيقك للمراسلة الفورية على المنصات المدعومة. [اعرف المزيد](/ar/developer/first-steps/connect-messaging-services/configure-project/)

2. **دمج SDK**

   أضف Pushwoosh SDK إلى تطبيقك لتمكين وظيفة صندوق الرسائل الواردة. [اعرف المزيد](/ar/developer/pushwoosh-sdk/pushwoosh-sdk-overview/)

3. **تسجيل المستخدمين**

   قم بمزامنة بيانات المستخدم للسماح بتسليم رسائل صندوق الرسائل الواردة. [اعرف المزيد](/ar/developer/first-steps/subscribe-users/)

4. **تعيين معرفات مستخدم مخصصة (User IDs)**

   قم بتعيين User ID مخصص لتوحيد أجهزة/جهات اتصال الشخص تحت ملف تعريف واحد. [اعرف المزيد](/ar/developer/first-steps/collecting-user-ids/)

5. **تطبيق صندوق الرسائل الواردة**

   اتبع الأدلة الخاصة بالمنصة لتطبيق واجهة مستخدم صندوق الرسائل الواردة. [اعرف المزيد](/ar/developer/guides/message-inbox/)

6. **تخصيص واجهة المستخدم (اختياري)**

   قم بتخصيص مظهر صندوق الرسائل الواردة حسب الحاجة. [اعرف المزيد](/ar/developer/guides/message-inbox/)
</Steps>

بمجرد اكتمال التكامل، يمكنك تسليم رسائل صندوق الرسائل الواردة باستخدام [Pushwoosh Customer Journey](/ar/product/customer-journey/journey-elements/#save-to-inbox) أو طريقة API [`Notify`](/ar/developer/api-reference/messaging-api-v2/notify/).

<TitleIcon icon="inapp">
### الرسائل داخل التطبيق
</TitleIcon>

اعرض رسائل سياقية مباشرة داخل تطبيقك.

لتمكين الرسائل داخل التطبيق:

<Steps>
1. **تكوين منصتك**

   تأكد من أن تطبيقك يدعم الرسائل داخل التطبيق. [اعرف المزيد](/ar/developer/first-steps/connect-messaging-services/configure-project/)

2. **دمج SDK**

   مطلوب لتسليم الرسائل داخل التطبيق. [اعرف المزيد](/ar/developer/pushwoosh-sdk/pushwoosh-sdk-overview/)

3. **اختبار التكامل ونشر تطبيقك**

   تأكد من أن وظيفة الرسائل داخل التطبيق تعمل كما هو متوقع وقم بإصدار النسخة التي تحتوي على SDK المدمج إلى متاجر التطبيقات. [اعرف المزيد](/ar/developer/first-steps/test-your-integration/)

4. **تسجيل المستخدمين**

   تأكد من اشتراك الأجهزة ومزامنة بيانات المستخدم. [اعرف المزيد](/ar/developer/first-steps/subscribe-users/)

5. **تعيين معرفات مستخدم مخصصة (User IDs)**

   قم بتعيين User ID مخصص لتوحيد أجهزة/جهات اتصال الشخص تحت ملف تعريف واحد. [اعرف المزيد](/ar/developer/first-steps/collecting-user-ids/)
</Steps>

بعد الإعداد، يمكنك إرسال الرسائل داخل التطبيق عبر [Customer Journey](/ar/product/messaging-channels/in-apps/sending-in-apps/#send-in-apps-via-customer-journey) أو استخدام وظيفة [Instant in-apps](/ar/product/messaging-channels/in-apps/sending-in-apps/#send-instant-in-apps).

<TitleIcon icon="email">
### رسائل البريد الإلكتروني
</TitleIcon>

تواصل مع المستخدمين بحملات بريد إلكتروني مخصصة أو رسائل معاملات.

لبدء إرسال رسائل البريد الإلكتروني:

<Steps>
1. **تكوين منصة البريد الإلكتروني**

   قم بتوثيق نطاقك وعنوان المرسل. [اعرف المزيد](/ar/developer/first-steps/connect-messaging-services/email-verification/)

2. **تسجيل المستخدمين**

   استورد عناوين البريد الإلكتروني للمستخدمين وقم بمزامنتها. [اعرف المزيد](/ar/developer/first-steps/subscribe-users/)

3. **تعيين معرفات مستخدم مخصصة (User IDs)**

   قم بتعيين User ID مخصص لتوحيد أجهزة/جهات اتصال الشخص تحت ملف تعريف واحد. [اعرف المزيد](/ar/developer/first-steps/collecting-user-ids/)
</Steps>

بمجرد اكتمال الإعداد، يمكنك البدء في إرسال رسائل البريد الإلكتروني باستخدام لوحة تحكم Pushwoosh أو طريقة [`Notify`](/ar/developer/api-reference/messaging-api-v2/notify/).

<TitleIcon icon="whatsapp">
### WhatsApp
</TitleIcon>

تفاعل مع المستخدمين على أحد أكثر تطبيقات المراسلة استخدامًا في العالم، وقدم رسائل آمنة ومعتمدة تدفع إلى تفاعلات ذات مغزى.

لتمكين المراسلة عبر WhatsApp:

<Steps>
1. **ربط حساب WhatsApp Business الخاص بك**

   [اعرف المزيد](/ar/product/first-steps/start-with-your-project/configure-platforms/whatsapp-configuration/)

2. **الموافقة على القوالب**

   قدم قوالبك الخاصة إلى Meta أو استخدم القوالب المعتمدة مسبقًا. [اعرف المزيد](/ar/product/messaging-channels/whatsapp-messages/#create-whatsapp-templates)

3. **تسجيل جهات اتصال WhatsApp**

   [اعرف المزيد](/ar/developer/first-steps/subscribe-users/)

4. **تعيين معرفات مستخدم مخصصة (User IDs)**

   قم بتعيين User ID مخصص لتوحيد أجهزة/جهات اتصال الشخص تحت ملف تعريف واحد. [اعرف المزيد](/ar/developer/first-steps/collecting-user-ids/)
</Steps>

بمجرد أن يكون التكامل جاهزًا، يمكنك إرسال رسائل WhatsApp [باستخدام لوحة التحكم](/ar/product/messaging-channels/whatsapp-messages/send-whatsapp-messages/) أو طريقة API [`Notify`](/ar/developer/api-reference/messaging-api-v2/notify/).

<TitleIcon icon="sms">
### الرسائل القصيرة (SMS)
</TitleIcon>

أرسل رسائل نصية مباشرة إلى أرقام هواتف المستخدمين.

لتمكين الرسائل القصيرة:

<Steps>
1. **ربط مزود خدمة الرسائل القصيرة الخاص بك**

   [اعرف المزيد](/ar/developer/first-steps/connect-messaging-services/sms-configuration/)

   للحصول على عناوين URL لرد الاتصال للمزود، راجع [خطافات الويب لمزود خدمة الرسائل القصيرة](/ar/developer/first-steps/connect-messaging-services/sms-configuration/sms-provider-webhooks/).

2. **تسجيل أرقام الهواتف**

   اجمع الأرقام ونسقها بشكل صحيح (E.164) مع موافقة المستخدم. [اعرف المزيد](/ar/developer/first-steps/subscribe-users/)

3. **تعيين معرفات مستخدم مخصصة (User IDs)**

   قم بتعيين User ID مخصص لتوحيد أجهزة/جهات اتصال الشخص تحت ملف تعريف واحد. [اعرف المزيد](/ar/developer/first-steps/collecting-user-ids/)
</Steps>

بعد الإعداد، يمكنك إرسال رسائل SMS باستخدام [Customer Journey](/ar/product/customer-journey/journey-elements/#sms)، أو عبر طريقة API [`Notify`](/ar/developer/api-reference/messaging-api-v2/notify/).

<TitleIcon icon="line">
### LINE
</TitleIcon>

استخدم LINE للتواصل مع المستخدمين عبر Customer Journeys، أو API، أو الدردشة الفردية، باستخدام القوالب أو الرسائل النصية العادية.
لبدء استخدام المراسلة عبر LINE:

<Steps>

1. **إعداد حسابات LINE الخاصة بك**
   أنشئ [حساب LINE Official Business](https://www.linebiz.com/jp-en/) و[حساب LINE Developers](https://developers.line.biz/en/docs/line-developers-console/login-account/).

2. **ربط LINE بـ Pushwoosh**
   قم بتكوين منصة LINE في حساب Pushwoosh الخاص بك. [اعرف المزيد](/ar/developer/first-steps/connect-messaging-services/line-configuration/)

3. **تأكد من إعداد LINE Messaging وتمكين الفوترة.**
   > **هام:** تتم إدارة أسعار LINE Messaging API مباشرة بواسطة LINE. تختلف الخطط حسب المنطقة وحجم الاستخدام. [عرض تفاصيل الأسعار](https://developers.line.biz/en/docs/messaging-api/pricing/)

</Steps>

##### الخطوات التالية

*   **إرسال الرسائل عبر API**

    استخدم Pushwoosh API لإرسال رسائل LINE بمحتوى قالب أو نص عادي.

    <LinkCard title="Notify" href="/developer/api-reference/messaging-api-v2/notify/" />

<TitleIcon icon="comment">
### Kakao
</TitleIcon>

أرسل رسائل Kakao عبر Customer Journeys أو API باستخدام قوالب معتمدة للوصول إلى المستخدمين على KakaoTalk.

لبدء استخدام المراسلة عبر Kakao:

<Steps>

1. **ربط Kakao بـ Pushwoosh**

   قم بتكوين منصة Kakao في حساب Pushwoosh الخاص بك. [اعرف المزيد](/ar/developer/first-steps/connect-messaging-services/kakao-configuration/)

2. **إنشاء قوالب الرسائل والموافقة عليها**

   استخدم قوالب Kakao المعتمدة؛ تتطلب القوالب المخصصة موافقة في مركز أعمال Kakao. [اعرف المزيد](/ar/product/content/kakao-presets/)

</Steps>

##### الخطوات التالية

*   **إرسال الرسائل عبر API**

    استخدم Pushwoosh API لإرسال رسائل Kakao بقوالب معتمدة.

    <LinkCard title="Notify" href="/developer/api-reference/messaging-api-v2/notify/" />

### بطاقات Apple Wallet

صمم بطاقات Apple Wallet، بما في ذلك بطاقات الولاء، والكوبونات، وتذاكر الفعاليات، والمزيد، وادفع تحديثات مباشرة إلى كل جهاز أضافها.

لبدء استخدام بطاقات Apple Wallet:

<Steps>

1. **تكوين شهادة التوقيع**

   أضف شهادة Apple Pass Type ID الخاصة بك إلى تطبيقك حتى يتمكن Pushwoosh من توقيع البطاقات. [اعرف المزيد](/ar/developer/first-steps/connect-messaging-services/ios-configuration/ios-wallet-pass-configuration/)

2. **تصميم وإصدار بطاقة**

   أنشئ بطاقة في منشئ البطاقات، ثم شاركها كرابط تثبيت أو رمز QR. [اعرف المزيد](/ar/product/messaging-channels/apple-wallet-passes/pass-builder/)

</Steps>

##### الخطوات التالية

*   **اعرف المزيد عن بطاقات Apple Wallet**

    صمم ووزع وحدّث البطاقات في لوحة التحكم.

    <LinkCard title="اعرف المزيد" href="/product/messaging-channels/apple-wallet-passes/" />

*   **إدارة البطاقات عبر API**

    استخدم PassKit API لإنشاء وتحديث وإدارة البطاقات برمجيًا.

    <LinkCard title="اعرف المزيد" href="/developer/api-reference/apple-wallet-passkit-api/" />

### بطاقات Google Wallet

صمم بطاقات Google Wallet، بما في ذلك بطاقات الولاء، والعروض، وتذاكر الفعاليات، والمزيد، ودع Google يزامن التحديثات مع كل جهاز قام بحفظها.

لبدء استخدام بطاقات Google Wallet:

<Steps>

1. **تكوين Google Wallet في Pushwoosh**

   أضف Issuer ID ومفتاح حساب الخدمة الخاص بك إلى تطبيقك. هذا الإعداد مستقل عن Firebase. [اعرف المزيد](/ar/developer/first-steps/connect-messaging-services/android-configuration/android-google-wallet-configuration/)

2. **تصميم وإصدار بطاقة**

   أنشئ بطاقة في منشئ البطاقات، ثم شارك رابط حفظ "إضافة إلى Google Wallet" أو رمز QR. [اعرف المزيد](/ar/product/messaging-channels/google-wallet-passes/pass-builder/)

</Steps>

##### الخطوات التالية

*   **توزيع وتحديث البطاقات في لوحة التحكم**

    <LinkCard title="اعرف المزيد" href="/product/messaging-channels/google-wallet-passes/" />

*   **مراسلة حاملي البطاقات**

    تواصل مع حاملي البطاقات بتحديثات البطاقة، أو إشعار فوري لمرة واحدة، أو Customer Journey.

    <LinkCard title="اعرف المزيد" href="/product/messaging-channels/google-wallet-passes/message-pass-holders/" />

*   **إدارة البطاقات عبر API**

    استخدم Google Wallet API لإنشاء البطاقات، وإصدار روابط الحفظ، وإرسالها إلى المستخدمين.

    <LinkCard title="اعرف المزيد" href="/developer/api-reference/google-wallet-api/" />

## بناء حملات متعددة القنوات (omnichannel)

بمجرد تكوين ودمج قنوات المراسلة اللازمة، يمكنك إنشاء حملات متعددة القنوات لتنسيق الاتصال عبر نقاط اتصال متعددة.

لتمكين وظيفة القنوات المتعددة، تأكد من تسجيل وربط بيانات المستخدم (مثل معرف الجهاز، والبريد الإلكتروني، ورقم الهاتف) تحت [User ID موحد](/ar/developer/pushwoosh-knowledge-hub/users-userids/). يتيح لك هذا مخاطبة نفس المستخدم عبر القنوات من منطق حملة واحد.

<LinkCard title="اعرف المزيد عن الحملات متعددة القنوات" href="/product/pushwoosh-knowledge-hub/omnichannel-campaigns/" />