การกำหนดค่า Web Push
ในการเริ่มส่งการแจ้งเตือน Web Push ด้วย Pushwoosh คุณต้องกำหนดค่าแพลตฟอร์ม Web Push ของคุณและเปิดใช้งานข้อความแจ้งให้สมัครรับข่าวสารที่แสดงต่อผู้ใช้
ในการเริ่มการกำหนดค่า ไปที่ Settings > Platform Configuration > Web Push Notifications และคลิก Configure
กำหนดค่า Web Push สำหรับเบราว์เซอร์ทั้งหมด (ยกเว้น Safari เวอร์ชันเก่า)
Anchor link toการกำหนดค่านี้ใช้ได้กับเบราว์เซอร์สมัยใหม่ทั้งหมด รวมถึง Safari เวอร์ชันล่าสุด ซึ่งตอนนี้รองรับการแจ้งเตือน Web Push แบบเนทีฟแล้ว
หมายเหตุ: Safari เวอร์ชันเก่า (macOS 10.14–12) ต้องการการตั้งค่าแยกต่างหาก คุณสามารถกำหนดค่าได้ในส่วนเฉพาะ เรียนรู้เพิ่มเติม
ในการเริ่มการตั้งค่า คลิก Configure ใต้ All browsers configuration
ในหน้าต่างการกำหนดค่า เลือกหนึ่งในตัวเลือกต่อไปนี้:
-
Create a new push configuration แนะนำหากคุณไม่เคยตั้งค่าการแจ้งเตือน Web Push ผ่านบริการอื่นมาก่อน Pushwoosh จะสร้างคู่คีย์ VAPID ใหม่ให้โดยอัตโนมัติ
-
Use existing configuration เลือกตัวเลือกนี้หากคุณมีคีย์ VAPID อยู่แล้ว เช่น จาก Firebase และต้องการใช้ต่อไปโดยไม่ต้องขอให้ผู้ใช้สมัครรับข่าวสารอีกครั้ง
สร้างการกำหนดค่าพุชใหม่
Anchor link toเลือก Create a new push configuration หากคุณไม่เคยตั้งค่าการแจ้งเตือน Web Push กับบริการอื่นมาก่อน Pushwoosh จะสร้างคีย์ VAPID (Voluntary Application Server Identification) ที่จำเป็นให้คุณโดยอัตโนมัติ
VAPID keys คืออะไร?
VAPID keys คือคู่คีย์สาธารณะ-ส่วนตัวที่ใช้ใน Web Push Protocol เพื่อยืนยันตัวตนของเซิร์ฟเวอร์แอปพลิเคชันเมื่อส่งการแจ้งเตือนพุชไปยังเว็บเบราว์เซอร์ คีย์สาธารณะ จะถูกแชร์กับเบราว์เซอร์เมื่อผู้ใช้สมัครรับการแจ้งเตือน คีย์ส่วนตัว จะอยู่บนเซิร์ฟเวอร์ของคุณและใช้เพื่อลงนามในแต่ละข้อความที่คุณส่งอย่างปลอดภัย
คลิก Configure เพื่อสร้างและใช้คีย์
เมื่อสร้างแล้ว Pushwoosh จะใช้คีย์เหล่านี้ในการกำหนดค่า SDK โดยอัตโนมัติ เรียนรู้เพิ่มเติมเกี่ยวกับการผสานรวม Web Push SDK
ใช้การกำหนดค่าที่มีอยู่
Anchor link toหากคุณมีคีย์ VAPID อยู่แล้ว (เช่น ที่สร้างผ่าน Firebase) คุณสามารถนำมาใช้ใหม่เพื่อตั้งค่าการแจ้งเตือน Web Push ใน Pushwoosh ได้
สำหรับสิ่งนี้:
-
เลือก Use existing configuration
-
ในช่อง Web Push Certificate ให้ป้อน VAPID public key ของคุณ
-
ในช่อง Web Push Private Key ให้ป้อน VAPID private key ของคุณ
-
คลิก Configure เพื่อบันทึกและใช้การตั้งค่า
วิธีค้นหาคีย์ VAPID ใน Firebase
Anchor link toหากคุณกำลังย้ายจาก Firebase และต้องการใช้คีย์ VAPID ที่มีอยู่ของคุณใหม่ ให้ทำตามขั้นตอนเหล่านี้เพื่อค้นหา
Web Push certificate
Anchor link to- ใน Firebase ไปที่ Project Settings → Cloud Messaging
- เลื่อนลงไปที่ส่วน Web Configuration และคัดลอกคู่คีย์ที่มีอยู่
Web Push private key
Anchor link to- ใน Firebase Console ไปที่ Project Settings → Cloud Messaging → Web Configuration
- คลิก เมนูสามจุด ใต้ Actions ถัดจากคู่คีย์และเลือก Show private key คีย์นี้จำเป็นเพื่อให้แน่ใจว่าการแจ้งเตือน Web Push ทำงานอย่างถูกต้อง
-
คัดลอกคีย์ที่แสดงไปยังคลิปบอร์ดของคุณ
-
ในฟอร์ม Pushwoosh Web Configuration วางลงในช่อง Web Push Private Key
- คลิก Apply เพื่อบันทึกการเปลี่ยนแปลงของคุณ
กำหนดค่าการกำหนดค่า Web Push ใหม่
Anchor link toหากคุณได้ตั้งค่าการแจ้งเตือน Web Push แล้ว แต่ต้องการอัปเดตข้อมูลประจำตัวของคุณ (เช่น เปลี่ยนคีย์ VAPID) นี่คือวิธีทำ:
- คลิก Reconfigure ใต้ All browsers configuration
-
ในป๊อปอัปที่ปรากฏขึ้น ให้ป้อนคีย์ VAPID ใหม่ของคุณ:
- Web Push Certificate: VAPID public key ใหม่ของคุณ
- Web Push Private Key: VAPID private key ใหม่ของคุณ
-
คลิก Configure เพื่อบันทึกการเปลี่ยนแปลง
กำหนดค่าข้อความแจ้งให้สมัครรับข่าวสาร
Anchor link toในการส่งการแจ้งเตือนพุช ผู้ใช้ต้องให้สิทธิ์อย่างชัดเจนผ่านข้อความแจ้งของระบบเบราว์เซอร์ หากไม่ได้รับอนุญาตนี้ จะไม่สามารถส่งการแจ้งเตือนได้
เนื่องจากการเปลี่ยนแปลงนโยบายล่าสุดของ Chrome และ Firefox ป๊อปอัปขออนุญาตแบบเนทีฟจะปรากฏขึ้นได้ก็ต่อเมื่อผู้ใช้โต้ตอบกับหน้าเว็บ (เช่น โดยการคลิกปุ่ม) เพื่อให้เป็นไปตามข้อกำหนดนี้ Pushwoosh จะแสดง วิดเจ็ต Subscription Prompt โดยค่าเริ่มต้น วิดเจ็ตนี้จะกระตุ้นให้ผู้ใช้เลือกเข้าร่วม และเมื่อตกลงแล้ว จะเรียกใช้ข้อความแจ้งของเบราว์เซอร์แบบเนทีฟ
ในการปรับแต่งข้อความและลักษณะของข้อความแจ้ง ให้คลิก Settings
ประเภทของข้อความแจ้ง
Anchor link toมีข้อความแจ้งให้สมัครรับข่าวสารสองประเภท:
-
Default widget จัดทำโดย Pushwoosh และแสดงโดยอัตโนมัติ เรียนรู้วิธีปรับแต่งวิดเจ็ตเริ่มต้น
-
Custom widget ใช้วิดเจ็ตที่คุณออกแบบเอง เรียนรู้เพิ่มเติม
หมายเหตุ: เนื่องจากข้อจำกัดของแพลตฟอร์ม การเปลี่ยนแปลงวิดเจ็ตอาจใช้เวลาถึง 30 นาทีจึงจะปรากฏ หากการเปลี่ยนแปลงไม่แสดงผล โปรดติดต่อทีมสนับสนุนของ Pushwoosh
การกำหนดค่า Safari (macOS 10.14–12)
Anchor link toเพื่อรองรับการแจ้งเตือนพุชใน Safari เวอร์ชันเก่า (macOS 10.14–12) คุณต้องดำเนินการกำหนดค่าแยกต่างหากโดยใช้ข้อมูลประจำตัว Apple Developer ของคุณ ขั้นตอนนี้จำเป็นสำหรับเวอร์ชันเก่าเหล่านี้เท่านั้น เนื่องจาก Safari เวอร์ชันใหม่ (macOS Ventura และใหม่กว่า) รองรับการตั้งค่า Web Push มาตรฐานที่รวมอยู่ใน การกำหนดค่าสำหรับเบราว์เซอร์ทั้งหมด
รับข้อมูลประจำตัวที่จำเป็นจาก Apple
Anchor link to-
ไปที่ส่วน Certificates, Identifiers & Profiles ของ Apple Developer Portal
-
เพิ่มใบรับรองใหม่
- เลือกประเภท Website Push ID Certificate และคลิก Continue
- เลือก Website Push ID - สตริงโดเมนย้อนกลับที่ไม่ซ้ำกันของคุณ เช่น web.com.example.domain (ต้องขึ้นต้นด้วย web.)
-
อัปโหลด Certificate Signing Request หากต้องการเรียนรู้เพิ่มเติมเกี่ยวกับการสร้าง Certificate Signing Requests โปรดดูบทความ Developer Account Help
-
หลังจากนั้น ดาวน์โหลดใบรับรองการแจ้งเตือนพุช
กำหนดค่า Safari ใน Pushwoosh
Anchor link to- คลิก Configure ใต้ Safari Configuration
- กรอกข้อมูลในช่องต่อไปนี้ในฟอร์มการกำหนดค่า:
| Website name | ชื่อเว็บไซต์ของคุณที่ปรากฏในข้อความแจ้งพุช |
| Allowed domains | รายชื่อโดเมนที่ได้รับอนุญาตให้ขอสิทธิ์การแจ้งเตือน (หนึ่งโดเมนต่อบรรทัด) |
| URL template | URL ที่จะเปิดเมื่อผู้ใช้คลิกการแจ้งเตือน รองรับตัวยึดตำแหน่งเช่น %@ เพื่อแทรกค่าไดนามิก ตัวอย่าง: https://yourwebsite.com/%@ |
| Website icon | อัปโหลดรูปภาพ PNG สี่เหลี่ยมจัตุรัส (256×256 px) Pushwoosh จะปรับขนาดโดยอัตโนมัติสำหรับอินเทอร์เฟซต่างๆ |
| Key file | อัปโหลดใบรับรอง .p12 ที่ส่งออกจากบัญชี Apple Developer ของคุณ |
| Private key password | รหัสผ่านที่ใช้เมื่อส่งออกไฟล์ .p12 |
- คลิก Configure เพื่อบันทึกการเปลี่ยนแปลงของคุณ
Pushwoosh จะสร้าง push package พร้อมชุดไอคอน, พจนานุกรม JSON ของเว็บไซต์ และไฟล์ manifest ที่ Safari ร้องขอจากเซิร์ฟเวอร์โดยอัตโนมัติ คุณสามารถดาวน์โหลดได้ทุกเมื่อที่ต้องการ