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

بمجرد أن يضيف المستخدم بطاقتك، يقوم Pushwoosh بتسجيلها كاشتراك منصة (Apple Wallet أو Google Wallet) مرتبط بـ [معرف المستخدم (User ID)](/ar/product/pushwoosh-knowledge-hub/users-userids/) الخاص به.

يمكنك الوصول إلى حاملي البطاقات بعدة طرق: إرسال تحديث للبطاقة، أو إرسال إشعار دفع لمرة واحدة، أو أتمتة الرسائل من رحلة العميل (Customer Journey)، أو إعلام حاملي بطاقة معينة عبر API.

## إرسال تحديث للبطاقة

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

### Apple Wallet

قم بتعيين **رسالة تغيير** على أي حقل تريد تنبيه حاملي البطاقات بشأنه؛ يعرضها iOS كرسالة على شاشة القفل. يتم تحديث الحقول التي لا تحتوي على رسالة تغيير بصمت.

1. في **الحملات ← بطاقات Wallet ← Apple Wallet**، ابحث عن البطاقة وانقر على **تعديل** في قائمة الإجراءات.
2. قم بتغيير الحقول التي تحتاجها، وأضف رسالة تغيير إلى أي حقل تريد تنبيه حاملي البطاقات بشأنه.
3. انقر على **حفظ**.

### Google Wallet

بالنسبة لبطاقات الولاء وتذاكر الفعاليات والرحلات الجوية، قم بتمكين **الإعلام بالحقول المتغيرة** لجعل Google ترسل إشعارًا على Android إلى جانب المزامنة. تتم مزامنة أنواع البطاقات الأخرى بصمت.

1. في **الحملات ← بطاقات Wallet ← Google Wallet**، ابحث عن البطاقة وانقر على **تعديل** في قائمة الإجراءات.
2. قم بتغيير الحقول التي تحتاجها.
3. تأكد من تمكين [**الإعلام بالحقول المتغيرة**](/ar/product/messaging-channels/wallet-passes/google-wallet/#view-and-manage-existing-passes).
4. انقر على **حفظ التغييرات**.

<Aside type="note" title="بطاقات الفعاليات والرحلات الجوية">
- تقوم Google بإنشاء نص الإشعار؛ لا يمكنك تخصيصه مثل رسالة تغيير Apple Wallet.
- بالنسبة لبطاقات الفعاليات والرحلات الجوية، لا يتم إرسال الإشعار إلا إذا كان الوقت المتبقي أقل من 3 ساعات حتى وقت البدء.
- تسمح Google بـ 3 إشعارات كحد أقصى لكل بطاقة كل 24 ساعة. إذا تم الوصول إلى الحد الأقصى، يتم تحديث البطاقة بصمت.
</Aside>

## إرسال إشعار دفع لمرة واحدة إلى حاملي البطاقات

أرسل إشعار دفع مستقل إلى حامل بطاقة واحد أو إلى جمهور أوسع. يظهر كرسالة على شاشة القفل على بطاقة Apple Wallet، أو كإشعار على بطاقة Google Wallet.

1. افتح أداة إنشاء إشعارات الدفع لمرة واحدة. إما بالنقر على **إرسال رسالة** في **الحملات ← بطاقات Wallet ← Apple Wallet** أو **Google Wallet**، أو بالانتقال إلى **الحملات ← رسائل لمرة واحدة** والنقر على **إرسال رسالة ← إشعار دفع لمرة واحدة**.
2. في خطوة **المحتوى**، اكتب الرسالة أو حدد إعدادًا مسبقًا.
3. في خطوة **الجمهور**، حدد من سيتلقى الرسالة. يعتمد الإعداد الافتراضي على المكان الذي فتحت منه أداة الإنشاء:

   * **من "إرسال رسالة" على بطاقة:** يتم تحديد **إرسال إلى مستخدمين محددين**، ويسرد حقل **المستلمون (معرفات المستخدمين)** بالفعل [معرف المستخدم (User ID)](/ar/product/pushwoosh-knowledge-hub/users-userids/) الخاص بحامل تلك البطاقة. أرسل كما هو للوصول إلى ذلك الحامل الواحد، أو قم بتغيير الجمهور:
     * أضف المزيد من معرفات المستخدمين في **المستلمون (معرفات المستخدمين)**
     * قم بالتبديل إلى **إرسال إلى شريحة**
     * اختر **إرسال إلى جميع المشتركين**
   * **من "رسائل لمرة واحدة":** قم بتعيين الجمهور كما في [إشعار دفع عادي لمرة واحدة](/ar/product/messaging-channels/push-notifications/send-push-notifications/one-time-push/#select-audience-for-push-notification): **إرسال إلى مستخدمين محددين**، **إرسال إلى شريحة**، أو **إرسال إلى جميع المشتركين**.

<img src="/apple-wallet-passes-message-pass-holders-1.webp" alt="خطوة الجمهور مع تحديد 'إرسال إلى مستخدمين محددين' ومعرف المستخدم (User ID) لحامل البطاقة مملوء مسبقًا في حقل المستلمين"/>

4. تحت **المنصات المستهدفة**، حدد **Apple Wallet**، **Google Wallet**، أو كليهما.
5. أرسل الرسالة أو قم بجدولتها.

<Aside type="note">
عندما تستهدف شريحة، يتم التسليم للمستخدمين في تلك الشريحة الذين لديهم المنصة المطابقة مسجلة، وليس لكل من قام بحفظ بطاقة معينة.
</Aside>

## أتمتة الرسائل من رحلة العميل (Customer Journey)

أرسل الرسائل تلقائيًا بناءً على الأحداث أو الشرائح.

### رحلة الدخول المستندة إلى مشغل

<Aside type="caution" icon="setting" title="مطلوب مساعدة المطور">
يتطلب إرسال الأحداث المخصصة من فريق المطورين لديك دمج استدعاء API [`postEvent`](/ar/developer/api-reference/user-centric-api/#postevent) في الواجهة الخلفية أو نظام إدارة علاقات العملاء (CRM) الخاص بك. شارك هذا القسم معهم.
</Aside>

1. قم بإنشاء [رحلة عميل (Customer Journey)](/ar/product/customer-journey/pushwoosh-journey-overview/) وأضف [**دخول مستند إلى مشغل**](/ar/product/customer-journey/journey-elements/entry-elements/trigger-based-entry/).
2. حدد الحدث الذي يجب أن يبدأ الرحلة. قم بإنشاء حدث مخصص في لوحة التحكم أولاً إذا لم تكن قد فعلت ذلك بالفعل، على سبيل المثال `RewardAvailable`.
3. أضف عنصر إشعار دفع وقم بتكوينه. قم بتمكين [**إرسال حسب معرف المستخدم**](/ar/product/customer-journey/journey-elements/channels/push/#send-by-user-id) حتى يصل الإشعار إلى كل جهاز مرتبط بالمستخدم، بما في ذلك البطاقة المحفوظة.
4. أكمل تكوين الرحلة وقم بتفعيلها.

عندما يتم إطلاق حدث الدخول، يرسل Pushwoosh الإشعار إلى كل جهاز مرتبط بالمستخدم. يتلقى حاملو البطاقات الإشعار كرسالة على شاشة القفل في Apple Wallet، أو كإشعار في Google Wallet. يتلقى المستخدمون الذين ليس لديهم بطاقة wallet الإشعار على أجهزتهم الأخرى.

<Aside type="tip" title="محتوى البطاقة">
لا يغير الإشعار أي حقول في البطاقة. لتحديث محتوى البطاقة إلى جانب الرسالة، على سبيل المثال رصيد النقاط، قم بتحديث البطاقة بشكل منفصل:

* **Apple Wallet:** عبر **تعديل** في [جميع البطاقات](/ar/product/messaging-channels/wallet-passes/apple-wallet/#view-and-manage-existing-passes)، أو من خلال [Apple PassKit API](/ar/developer/api-reference/apple-wallet-passkit-api/).
* **Google Wallet:** عبر **تعديل** في [جميع البطاقات](/ar/product/messaging-channels/wallet-passes/google-wallet/#view-and-manage-existing-passes)، أو من خلال [Google Wallet API](/ar/developer/api-reference/google-wallet-api/).
</Aside>

**مثال: إعلام مستخدم بأن مكافأة متاحة**

`POST https://api.pushwoosh.com/json/1.3/postEvent`

```json
{
  "request": {
    "application": "XXXXX-XXXXX",
    "userId": "u12345",
    "event": "RewardAvailable",
    "attributes": {
      "reward": "Free coffee",
      "expires": "2026-07-01"
    }
  }
}
```

يجب أن يتطابق اسم `event` مع حدث تم إنشاؤه في لوحة التحكم الخاصة بك.

### طرق أخرى لبناء الرحلة

يعد التدفق المستند إلى مشغل أعلاه خيارًا واحدًا. اعتمادًا على ما يجب أن يبدأ الرحلة، اختر [عنصر دخول](/ar/product/customer-journey/journey-elements/entry-elements/) مختلفًا:

* **[دخول مستند إلى الجمهور](/ar/product/customer-journey/journey-elements/entry-elements/audience-based-entry/):** ابدأ الرحلة لشريحة كاملة بدلاً من حدث واحد. قم بتشغيلها مرة واحدة، أو وفقًا لجدول زمني، أو بشكل دوري (على سبيل المثال، كل أسبوع لكل من يحمل بطاقة نشطة)، مع دخول مستخدمين جدد عند انضمامهم إلى الشريحة.
* **[دخول مستند إلى API](/ar/product/customer-journey/journey-elements/entry-elements/api-based-entry/):** ابدأ الرحلة من حدث عمل يحدث خارج التطبيق، مثل تأخير رحلة طيران أو تغيير بوابة. يقوم نظامك الخارجي باستدعاء قالب طلب عنصر الدخول ويمرر مرشحًا لاستهداف المستخدمين المناسبين، على سبيل المثال كل من لديه علامة `flightNumber = SU1234` تم تعيينها عند إصدار البطاقة. مناسب لبطاقات الصعود إلى الطائرة وتذاكر الفعاليات.

## إعلام حاملي بطاقة معينة عبر API

لمراسلة كل من قام بحفظ بطاقة معينة، قم باستدعاء **تحديث بطاقة**. يقوم هذا بتحديث البطاقة وإعلام الأجهزة. في Google Wallet، قم بتعيين `notifyMessage` لإرسال إشعار مخصص إلى جانب التحديث؛ بدونه، تتم مزامنة البطاقة بصمت.

* **Apple Wallet:** <LinkCard title="تحديث بطاقة" href="/developer/api-reference/apple-wallet-passkit-api/#update-a-pass" />
* **Google Wallet:** <LinkCard title="تحديث بطاقة" href="/developer/api-reference/google-wallet-api/#update-a-pass" />