# إرسال رسائل إلى حاملي بطاقات Apple Wallet

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

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

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

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

1. افتح محرر رسائل push لمرة واحدة. إما أن تنقر على **Send message** في **Campaigns → Wallet Passes → Apple Wallet**، أو اذهب إلى **Campaigns → One-Time Messages** وانقر على **Send message → One-time push**.
2. في خطوة **Content**، اكتب الرسالة أو اختر إعدادًا مسبقًا.
3. في خطوة **Audience**، حدد من سيتلقى الرسالة. يعتمد الخيار الافتراضي على المكان الذي فتحت منه المحرر:

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

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

4. تحت **Target platforms**، اختر **Apple Wallet**.
5. أرسل الرسالة أو قم بجدولتها.

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

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

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

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

يتلقى كل جهاز أضاف البطاقة التحديث. يتم تحديث الحقول التي لا تحتوي على رسالة تغيير بصمت.

## أتمتة الرسائل من Customer Journey

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

### رحلة الدخول القائمة على المشغلات

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

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

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

<Aside type="tip" title="محتوى البطاقة">
لا تغير رسالة push أي حقول في البطاقة. لتحديث محتوى البطاقة إلى جانب الرسالة، على سبيل المثال رصيد النقاط، قم بتحديث البطاقة بشكل منفصل عبر **Edit** في [All passes](/ar/product/messaging-channels/apple-wallet-passes/#view-and-manage-existing-passes) أو من خلال [PassKit API](/ar/developer/api-reference/apple-wallet-passkit-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` مع حدث تم إنشاؤه في Control Panel الخاص بك.

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

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

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

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

لإرسال رسالة إلى كل من قام بحفظ بطاقة معينة، قم باستدعاء [تحديث بطاقة](/ar/developer/api-reference/apple-wallet-passkit-api/#update-a-pass). يقوم هذا بتحديث البطاقة وإشعار الأجهزة.

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