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

เมื่อผู้ใช้เพิ่มพาสของคุณ Pushwoosh จะลงทะเบียนพาสนั้นเป็นการสมัครสมาชิกแพลตฟอร์ม (Apple Wallet หรือ Google Wallet) ที่ผูกกับ User ID นั้น

คุณสามารถเข้าถึงผู้ถือพาสได้หลายวิธี: ส่งการอัปเดตพาส, ส่ง push ครั้งเดียว, ส่งข้อความอัตโนมัติจาก Customer Journey, หรือแจ้งเตือนผู้ถือพาสเฉพาะผ่าน API

ส่งการอัปเดตพาส

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

Apple Wallet

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

1. ใน แคมเปญ → พาสใน Wallet → Apple Wallet ค้นหาพาสและคลิก แก้ไข ในเมนูการดำเนินการ
2. เปลี่ยนแปลงฟิลด์ที่คุณต้องการ และเพิ่มข้อความแจ้งการเปลี่ยนแปลงในฟิลด์ใดๆ ที่คุณต้องการแจ้งเตือนผู้ถือพาส
3. คลิก บันทึก

Google Wallet

สำหรับพาสสะสมคะแนน, ตั๋วกิจกรรม, และเที่ยวบิน ให้เปิดใช้งาน แจ้งเตือนเกี่ยวกับฟิลด์ที่เปลี่ยนแปลง เพื่อให้ Google ส่งการแจ้งเตือนของ Android พร้อมกับการซิงค์ พาสประเภทอื่นจะซิงค์อย่างเงียบๆ

1. ใน แคมเปญ → พาสใน Wallet → Google Wallet ค้นหาพาสและคลิก แก้ไข ในเมนูการดำเนินการ
2. เปลี่ยนแปลงฟิลด์ที่คุณต้องการ
3. ตรวจสอบให้แน่ใจว่า แจ้งเตือนเกี่ยวกับฟิลด์ที่เปลี่ยนแปลง ถูกเปิดใช้งานอยู่
4. คลิก บันทึกการเปลี่ยนแปลง

พาสกิจกรรมและเที่ยวบิน

• Google จะสร้างข้อความแจ้งเตือนเอง คุณไม่สามารถปรับแต่งได้เหมือนข้อความแจ้งการเปลี่ยนแปลงของ Apple Wallet
• สำหรับพาสกิจกรรมและเที่ยวบิน การแจ้งเตือนจะทำงานก็ต่อเมื่อเหลือเวลาน้อยกว่า 3 ชั่วโมงก่อนเวลาเริ่มต้น
• Google อนุญาตให้มีการแจ้งเตือนสูงสุด 3 ครั้งต่อพาสต่อ 24 ชั่วโมง หากถึงขีดจำกัดแล้ว พาสจะอัปเดตอย่างเงียบๆ

ส่ง push ครั้งเดียวถึงผู้ถือพาส

ส่ง push แบบสแตนด์อโลนไปยังผู้ถือพาสคนเดียวหรือกลุ่มเป้าหมายที่กว้างขึ้น ข้อความจะปรากฏเป็นข้อความบนหน้าจอล็อกสำหรับพาส Apple Wallet หรือเป็นการแจ้งเตือนสำหรับพาส Google Wallet

1. เปิดหน้าต่างสร้าง push ครั้งเดียว โดยคลิก ส่งข้อความ ใน แคมเปญ → พาสใน Wallet → Apple Wallet หรือ Google Wallet หรือไปที่ แคมเปญ → ข้อความครั้งเดียว แล้วคลิก ส่งข้อความ → Push ครั้งเดียว

2. ในขั้นตอน เนื้อหา ให้เขียนข้อความหรือเลือกจากพรีเซ็ต

3. ในขั้นตอน กลุ่มเป้าหมาย ให้ตั้งค่าผู้รับข้อความ ค่าเริ่มต้นจะขึ้นอยู่กับว่าคุณเปิดหน้าต่างสร้างข้อความจากที่ใด:

   • จาก ส่งข้อความ บนพาส: ส่งไปยังผู้ใช้ที่ระบุ จะถูกเลือกไว้ และ ผู้รับ (User IDs) จะแสดงรายการ User ID ของผู้ถือพาสนั้นอยู่แล้ว ส่งตามที่เป็นอยู่เพื่อเข้าถึงผู้ถือพาสคนนั้น หรือเปลี่ยนกลุ่มเป้าหมาย:
     • เพิ่ม User IDs เพิ่มเติมใน ผู้รับ (User IDs)
     • เปลี่ยนเป็น ส่งไปยังเซกเมนต์
     • เลือก ส่งไปยังผู้ติดตามทั้งหมด
   • จาก ข้อความครั้งเดียว: ตั้งค่ากลุ่มเป้าหมายเหมือนกับการส่ง push ครั้งเดียว ทั่วไป: ส่งไปยังผู้ใช้ที่ระบุ, ส่งไปยังเซกเมนต์, หรือ ส่งไปยังผู้ติดตามทั้งหมด

4. ใต้ แพลตฟอร์มเป้าหมาย ให้เลือก Apple Wallet, Google Wallet, หรือทั้งสองอย่าง
5. ส่งหรือตั้งเวลาส่งข้อความ

หมายเหตุ

เมื่อคุณกำหนดเป้าหมายเป็นเซกเมนต์ การจัดส่งจะไปถึงผู้ใช้ในเซกเมนต์นั้นที่มีการลงทะเบียนแพลตฟอร์มที่ตรงกัน ไม่ใช่ทุกคนที่บันทึกพาสเฉพาะนั้นไว้

ส่งข้อความอัตโนมัติจาก Customer Journey

ส่งข้อความอัตโนมัติตามอีเวนต์หรือเซกเมนต์

Journey ที่เริ่มต้นตามทริกเกอร์

ต้องการความช่วยเหลือจากนักพัฒนา

การส่งอีเวนต์ที่กำหนดเองต้องการให้ทีมนักพัฒนาของคุณผสานรวมการเรียก API postEvent เข้ากับแบ็กเอนด์หรือ CRM ของคุณ โปรดแชร์ส่วนนี้กับพวกเขา

1. สร้าง Customer Journey และเพิ่ม การเข้าตามทริกเกอร์ (Trigger-based entry)
2. เลือกอีเวนต์ที่จะเริ่มต้น Journey สร้างอีเวนต์ที่กำหนดเองใน Control Panel ก่อนหากคุณยังไม่ได้สร้าง เช่น RewardAvailable
3. เพิ่มและกำหนดค่าองค์ประกอบ push เปิดใช้งาน ส่งโดยใช้ User ID เพื่อให้ push เข้าถึงทุกอุปกรณ์ที่ผูกกับผู้ใช้ รวมถึงพาสที่บันทึกไว้
4. กำหนดค่าให้เสร็จสิ้นและเปิดใช้งาน Journey

เมื่ออีเวนต์เริ่มต้นทำงาน Pushwoosh จะส่ง push ไปยังทุกอุปกรณ์ที่ผูกกับผู้ใช้ ผู้ถือพาสจะได้รับเป็นข้อความบนหน้าจอล็อกใน Apple Wallet หรือเป็นการแจ้งเตือนใน Google Wallet ผู้ใช้ที่ไม่มีพาส wallet จะได้รับข้อความบนอุปกรณ์อื่นๆ ของพวกเขา

เนื้อหาของพาส

Push นี้จะไม่เปลี่ยนแปลงฟิลด์ใดๆ ของพาส หากต้องการอัปเดตเนื้อหาของพาสพร้อมกับข้อความ เช่น ยอดคะแนนสะสม ให้อัปเดตพาสแยกต่างหาก:

• Apple Wallet: ผ่าน แก้ไข ใน พาสทั้งหมด หรือผ่าน Apple PassKit API
• Google Wallet: ผ่าน แก้ไข ใน พาสทั้งหมด หรือผ่าน Google Wallet API

ตัวอย่าง: แจ้งเตือนผู้ใช้ว่ามีรางวัลพร้อมให้รับ

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

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

ชื่อ event ต้องตรงกับอีเวนต์ที่สร้างไว้ใน Control Panel ของคุณ

วิธีอื่นๆ ในการสร้าง Journey

ขั้นตอนการทำงานตามทริกเกอร์ข้างต้นเป็นเพียงหนึ่งตัวเลือก คุณสามารถเลือก องค์ประกอบการเข้า (entry element) ที่แตกต่างกันได้ ขึ้นอยู่กับว่าอะไรควรจะเริ่มต้น journey:

• การเข้าตามกลุ่มเป้าหมาย (Audience-based entry): เริ่มต้น journey สำหรับทั้งเซกเมนต์แทนที่จะเป็นอีเวนต์เดียว สามารถรันครั้งเดียว, ตามกำหนดเวลา, หรือเป็นระยะๆ (เช่น ทุกสัปดาห์สำหรับทุกคนที่ถือพาสที่ยังใช้งานอยู่) โดยผู้ใช้ใหม่จะเข้ามาเมื่อพวกเขาเข้าร่วมเซกเมนต์
• การเข้าตาม API (API-based entry): เริ่มต้น journey จากอีเวนต์ทางธุรกิจที่เกิดขึ้นนอกแอป เช่น เที่ยวบินล่าช้าหรือการเปลี่ยนแปลงประตูขึ้นเครื่อง ระบบภายนอกของคุณจะเรียกเทมเพลตคำขอขององค์ประกอบการเข้าและส่งตัวกรองเพื่อกำหนดเป้าหมายผู้ใช้ที่ถูกต้อง เช่น ทุกคนที่มีแท็ก flightNumber = SU1234 ที่ตั้งค่าไว้เมื่อออกพาส เหมาะสำหรับบอร์ดดิ้งพาสและตั๋วกิจกรรม

แจ้งเตือนผู้ถือพาสเฉพาะผ่าน API

หากต้องการส่งข้อความถึงทุกคนที่บันทึกพาสเฉพาะหนึ่งใบ ให้เรียกใช้ Update a pass ซึ่งจะอัปเดตพาสและแจ้งเตือนอุปกรณ์ต่างๆ สำหรับ Google Wallet ให้ตั้งค่า notifyMessage เพื่อส่งการแจ้งเตือนที่กำหนดเองพร้อมกับการอัปเดต หากไม่มีค่านี้ พาสจะซิงค์อย่างเงียบๆ

• Apple Wallet:
  อัปเดตพาส
• Google Wallet:
  อัปเดตพาส