# เริ่มต้นใช้งาน Apple Wallet passes

Apple Wallet passes คือบัตรดิจิทัล เช่น บัตรสะสมคะแนน คูปอง ตั๋วงานอีเวนต์ บัตรผ่านขึ้นเครื่อง และบัตรของร้านค้า ที่ผู้ใช้ของคุณเก็บไว้ในแอป Wallet บน iPhone และ Apple Watch ด้วย Pushwoosh คุณสามารถออกแบบพาสได้ด้วยภาพใน Control Panel, แชร์ และส่งการอัปเดตได้ตลอดเวลาโดยไม่ต้องขอให้ผู้ใช้ติดตั้งอะไรใหม่

เมื่อคุณเปลี่ยนพาส Pushwoosh จะแจ้งเตือนทุกอุปกรณ์ที่เพิ่มพาสนั้น และ iOS จะดึงเวอร์ชันใหม่มาอย่างเงียบๆ บาร์โค้ด ยอดคงเหลือ หมายเลขประตู หรือวันหมดอายุบนโทรศัพท์ของผู้ใช้จะอัปเดตด้วยตัวเอง

## สิ่งที่คุณสามารถทำได้ด้วย Apple Wallet passes

ด้วย Apple Wallet passes ใน Pushwoosh คุณสามารถ:

* ออกแบบพาสด้วยภาพด้วยสี ฟิลด์ โลโก้ ภาพแถบ และบาร์โค้ด โดยไม่ต้องเขียน `pass.json` ด้วยตนเอง
* สร้างบัตรสะสมคะแนน คูปอง ตั๋วงานอีเวนต์ บัตรผ่านขึ้นเครื่อง และบัตรของร้านค้าทั่วไป
* แจกจ่ายพาสให้ผู้ใช้เป็นไฟล์ `.pkpass` ลิงก์ติดตั้ง หรือ QR code
* อัปเดตเนื้อหาพาสและส่งการเปลี่ยนแปลงไปยังอุปกรณ์ที่เพิ่มพาสนั้น
* เข้าถึงผู้ถือพาสด้วย push แบบครั้งเดียว การอัปเดตพาส หรือ Customer Journey ดูที่ [ส่งข้อความถึงผู้ถือ Apple Wallet pass](/th/product/messaging-channels/apple-wallet-passes/message-pass-holders/)

## ข้อกำหนดเบื้องต้น

<Aside type="caution" icon="setting" title="ต้องการความช่วยเหลือจากนักพัฒนา">
การออก Apple Wallet passes ต้องใช้บัญชี Apple Developer และใบรับรองการลงนาม แชร์ส่วนนี้กับทีมนักพัฒนาของคุณเพื่อทำการตั้งค่าครั้งเดียวให้เสร็จสิ้น
</Aside>

ก่อนที่คุณจะออกแบบพาสแรกของคุณ ให้ยืนยันสิ่งต่อไปนี้:

* **Apple Developer Program:** คุณต้องมีสมาชิกที่ใช้งานได้เพื่อลงทะเบียน Pass Type IDs และสร้างใบรับรองการลงนาม [ลงทะเบียนหรือจัดการบัญชีของคุณ](https://developer.apple.com/programs/)
* **แพลตฟอร์ม iOS:** แอปพลิเคชันของคุณต้องเชื่อมต่อ iOS ใน Pushwoosh ก่อนที่คุณจะสามารถเพิ่มใบรับรองการลงนามพาสได้ [ตั้งค่า iOS](/th/developer/first-steps/connect-messaging-services/ios-configuration/)

## เริ่มทำงานกับ Apple Wallet passes

หลังจาก [ข้อกำหนดเบื้องต้น](#prerequisites) พร้อมแล้ว ให้ทำตามขั้นตอนต่อไปนี้:

<Steps>

1. **กำหนดค่า Wallet passes ใน Pushwoosh**

   ก่อนที่คุณจะสามารถออกแบบพาสได้ Pushwoosh ต้องมีใบรับรองการลงนาม Apple ของคุณสำหรับแอปพลิเคชัน ทีมนักพัฒนาของคุณจะสร้างมันใน Apple Developer และอัปโหลดไปยัง Pushwoosh นี่คือการตั้งค่าครั้งเดียวต่อแอปพลิเคชัน

   [วิธีการตั้งค่าใบรับรองการลงนาม](/th/developer/first-steps/connect-messaging-services/ios-configuration/ios-wallet-pass-configuration/)

2. **ออกแบบพาส**

   ใน [pass builder](/th/product/messaging-channels/apple-wallet-passes/pass-builder/) เลือกสไตล์พาส ตั้งค่าฟิลด์และแบรนด์ และตรวจสอบการแสดงตัวอย่างสด

3. **สร้าง `.pkpass` ที่ลงนามแล้ว**

   เมื่อคุณสร้างและตรวจสอบพาสแล้ว ใน [pass builder](/th/product/messaging-channels/apple-wallet-passes/pass-builder/#generate-the-pass) เลือก **Generate** Pushwoosh จะเตรียมรูปภาพตามความละเอียดที่ต้องการและลงนามไฟล์ด้วยใบรับรองของคุณ

4. **แจกจ่ายพาส**

   ส่งไฟล์ `.pkpass` ลิงก์ติดตั้ง หรือ QR code ให้ผู้ใช้ ดูที่ [แชร์พาสกับผู้ใช้ผ่านช่องทางของ Pushwoosh](#share-the-pass-with-users-via-pushwoosh-channels) เมื่อผู้ใช้เพิ่มพาสลงใน Wallet อุปกรณ์ของพวกเขาจะลงทะเบียนเพื่อรับการอัปเดตในอนาคต

5. **อัปเดตเนื้อหาพาส**

   แก้ไขพาสใน pass builder หรือผ่าน API แล้วบันทึก Pushwoosh จะแจ้งเตือนอุปกรณ์ที่ลงทะเบียนไว้ และ iOS จะดาวน์โหลดเวอร์ชันใหม่ในเบื้องหลัง ผู้ใช้ไม่จำเป็นต้องติดตั้งพาสใหม่

6. **ส่งข้อความถึงผู้ถือพาส**

   เมื่อผู้ใช้เพิ่มพาสลงใน Wallet แล้ว คุณสามารถเข้าถึงพวกเขาได้ด้วย push แบบครั้งเดียว การอัปเดตพาส หรือ Customer Journey อัตโนมัติ

   [ส่งข้อความถึงผู้ถือ Apple Wallet pass](/th/product/messaging-channels/apple-wallet-passes/message-pass-holders/)

</Steps>

## ดูและจัดการพาสที่มีอยู่

ใน Control Panel ไปที่ **Campaigns → Wallet Passes** และเปิดแท็บ **Apple Wallet** ตาราง **All passes** จะแสดงรายการพาสทั้งหมดสำหรับแอปพลิเคชัน รวมถึงชื่อ สไตล์ [User ID](/th/product/pushwoosh-knowledge-hub/users-userids/) ที่เชื่อมโยง และวันที่และเวลาที่อัปเดตล่าสุด

ในรายการพาส เปิดเมนูการดำเนินการ (⋮) เพื่อ:

* **แก้ไข:** เปลี่ยนชื่อและคำอธิบายพาส ค่าและป้ายกำกับของฟิลด์ เปลี่ยนข้อความ สี ข้อความบาร์โค้ด วันหมดอายุและสถานะ และตำแหน่งที่ตั้ง สไตล์และรูปภาพของพาสจะถูกล็อกหลังจากการสร้าง เมื่อคุณบันทึก ทุกอุปกรณ์ที่เพิ่มพาสจะได้รับการอัปเดต

<Aside type="note" title="การอัปเดตจะถูกส่งเป็น silent pushes">
เมื่อคุณบันทึกการเปลี่ยนแปลง Pushwoosh จะลงนามพาสใหม่อีกครั้งและแจ้งเตือนทุกอุปกรณ์ที่ลงทะเบียนด้วย push ที่ไม่มีเนื้อหา iOS จะดึงเวอร์ชันใหม่มาเอง—ไม่ต้องติดตั้งใหม่
</Aside> 

* **ดาวน์โหลด:** ดาวน์โหลดไฟล์ `.pkpass` ที่ลงนามแล้ว
* **QR code:** แสดง QR code สำหรับติดตั้งที่ผู้ใช้สามารถสแกนเพื่อเพิ่มพาสลงใน Wallet และลงทะเบียนอุปกรณ์ของพวกเขาเพื่อรับการอัปเดต ในหน้าต่างนี้ คุณยังสามารถใช้ **Copy install link** ที่อยู่ใต้ QR ได้อีกด้วย
* **คัดลอกลิงก์ติดตั้ง:** คัดลอก URL การติดตั้งเพื่อแชร์พาสในช่องทางการส่งข้อความของคุณ [เรียนรู้เพิ่มเติม](#share-the-pass-with-users-via-pushwoosh-channels)
* **ส่งข้อความ:** เปิดตัวสร้าง push แบบครั้งเดียวเพื่อส่งข้อความถึงผู้ถือพาส เมื่อคุณเปิดจากรายการ มันจะกำหนดเป้าหมายเจ้าของพาสโดยใช้ [User ID](/th/product/pushwoosh-knowledge-hub/users-userids/) ดู [ส่งข้อความถึงผู้ถือ Apple Wallet pass](/th/product/messaging-channels/apple-wallet-passes/message-pass-holders/) สำหรับทุกวิธีในการเข้าถึงพวกเขา
* **ลบ:** ลบพาส สำเนาที่ติดตั้งแล้วบนอุปกรณ์จะหยุดรับการอัปเดตและจะใช้งานไม่ได้ในการรีเฟรชครั้งต่อไป

## แชร์พาสกับผู้ใช้ผ่านช่องทางของ Pushwoosh

ลิงก์ติดตั้งที่คุณคัดลอกใน builder (**Copy install link**) เป็น URL ปกติ การเปิดบน iPhone จะเพิ่มพาสลงใน Apple Wallet คุณสามารถใช้ลิงก์นี้ในช่องทาง Pushwoosh เดียวกันกับที่คุณใช้เพื่อเข้าถึงผู้ชมของคุณอยู่แล้ว:

* **อีเมล:** เพิ่มลิงก์ไปยังปุ่มหรือลิงก์ข้อความใน [email editor](/th/product/content/email-content/drag-and-drop-email-editor/) ตัวอย่างเช่น คำกระตุ้นการตัดสินใจ "Add to Apple Wallet"
* **Push notifications:** ตั้งค่าลิงก์เป็นการกระทำเมื่อเปิด [open action](/th/product/messaging-channels/push-notifications/send-push-notifications/one-time-push/#define-what-happens-when-the-push-is-clicked) ของการแจ้งเตือนเพื่อให้การแตะเปิดพาสขึ้นมา
* **SMS:** รวมลิงก์ไว้ใน [เนื้อหา SMS](/th/product/messaging-channels/sms/send-sms/send-sms-via-customer-journey/#configure-sms-content)

<Aside type="note" title="หนึ่งลิงก์ต่อหนึ่งพาส">
ลิงก์ติดตั้งแต่ละอันจะผูกกับพาสเดียว (มันมีหมายเลขซีเรียลและโทเค็นของพาสนั้น) ดังนั้นหนึ่งลิงก์จะใช้ได้กับพาสที่แชร์ร่วมกันหนึ่งใบ ซึ่งสะดวกสำหรับคูปองหรือตั๋วงานอีเวนต์ทั่วไป หากต้องการให้ผู้รับแต่ละคนมีพาสของตัวเอง ให้สร้างพาสต่อผู้ใช้ด้วย [PassKit API](/th/developer/api-reference/apple-wallet-passkit-api/) และส่งลิงก์ของแต่ละคนไปให้พวกเขา Wallet passes จะติดตั้งบนอุปกรณ์ Apple เท่านั้น—iPhone และ Apple Watch
</Aside>

## จัดการพาสผ่าน API

ทุกสิ่งที่ pass builder ทำได้ยังมีให้ใช้งานแบบโปรแกรมผ่าน PassKit Designer API: สร้าง อัปเดต แสดงรายการ ดาวน์โหลด และลบพาส

<LinkCard title="Apple Wallet PassKit API" href="/developer/api-reference/apple-wallet-passkit-api/" />

## ดูผู้ถือพาสใน User Explorer

เมื่อผู้ใช้เพิ่มพาสของคุณลงใน Wallet, Pushwoosh จะแสดงรายการไว้ในแท็บ **Devices and platforms** ใน [User Explorer](/th/product/audience-data-and-segmentation/user-explorer/)

1. ไปที่ **Audience → User Explorer** และเปิดโปรไฟล์ผู้ใช้
2. เปิดแท็บ **Devices and platforms**
3. เลือก **Apple Wallet** ในแถบด้านข้าง

ในโปรไฟล์แพลตฟอร์ม คุณสามารถตรวจสอบ:

* **สถานะการสมัครสมาชิก:** ตัวอย่างเช่น **SUBSCRIBED**
* **ตัวระบุแพลตฟอร์ม:** ตัวระบุพาสที่แสดงอยู่ใต้ชื่อแพลตฟอร์ม
* **ข้อมูลเมตา:** **First subscription**, **Timezone** และฟิลด์อื่นๆ เมื่อมี
* **แท็ก:** แท็กแพลตฟอร์ม รวมถึงแท็กที่คุณตั้งค่าเมื่อออกพาส

[เรียนรู้เพิ่มเติม](/th/product/audience-data-and-segmentation/user-explorer/#devices-and-platforms-tab)