การกำหนดค่า Web push
ในการเริ่มต้นส่งการแจ้งเตือน Web push ด้วย Pushwoosh คุณต้องกำหนดค่าแพลตฟอร์ม Web push ของคุณและเปิดใช้งานข้อความแจ้งให้สมัครรับ (subscription prompt) ที่แสดงต่อผู้ใช้
ในการเริ่มการกำหนดค่า ไปที่ 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 และต้องการใช้คีย์เดิมต่อไปโดยไม่ต้องขอให้ผู้ใช้สมัครรับใหม่อีกครั้ง
สร้างการกำหนดค่าพุชใหม่ (Create a new push configuration)
Anchor link toเลือก Create a new push configuration หากคุณไม่เคยตั้งค่าการแจ้งเตือน Web push กับบริการอื่นมาก่อน Pushwoosh จะสร้างคีย์ VAPID (Voluntary Application Server Identification) ที่จำเป็นให้คุณโดยอัตโนมัติ
VAPID keys คืออะไร
คีย์ VAPID คือคู่คีย์แบบพับลิก-ไพรเวท (public-private key pair) ที่ใช้ใน Web Push Protocol เพื่อยืนยันตัวตนของเซิร์ฟเวอร์แอปพลิเคชันเมื่อส่งการแจ้งเตือนพุชไปยังเว็บเบราว์เซอร์ พับลิกคีย์ (public key) จะถูกแชร์กับเบราว์เซอร์เมื่อผู้ใช้สมัครรับการแจ้งเตือน ส่วน ไพรเวทคีย์ (private key) จะถูกเก็บไว้ที่เซิร์ฟเวอร์ของคุณและใช้ในการลงนามในแต่ละข้อความที่คุณส่งอย่างปลอดภัยคลิก Configure เพื่อสร้างและใช้คีย์
เมื่อสร้างแล้ว Pushwoosh จะใช้คีย์เหล่านี้ในการกำหนดค่า SDK โดยอัตโนมัติ เรียนรู้เพิ่มเติมเกี่ยวกับการผสานรวม Web Push SDK
ใช้การกำหนดค่าที่มีอยู่ (Use existing configuration)
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 และคัดลอกคู่คีย์ (key pair) ที่มีอยู่
- วางลงในช่อง Web Push Certificate ในฟอร์มการกำหนดค่าเว็บของ Pushwoosh
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 ใหม่ (Reconfigure web push configuration)
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 เพื่อบันทึกการเปลี่ยนแปลง
กำหนดค่าข้อความแจ้งให้สมัครรับ (Subscription prompt)
Anchor link toในการส่งการแจ้งเตือนพุช ผู้ใช้จะต้องให้สิทธิ์อย่างชัดเจนผ่านข้อความแจ้งของเบราว์เซอร์ในระดับระบบ หากไม่ได้รับอนุญาตนี้ จะไม่สามารถส่งการแจ้งเตือนได้
เนื่องจากการเปลี่ยนแปลงนโยบายล่าสุดของ Chrome และ Firefox ป๊อปอัปขออนุญาตแบบเนทีฟจะปรากฏขึ้นได้ก็ต่อเมื่อผู้ใช้มีปฏิสัมพันธ์กับหน้าเว็บแล้วเท่านั้น (เช่น การคลิกปุ่ม) เพื่อให้เป็นไปตามข้อกำหนดนี้ Pushwoosh จะแสดง วิดเจ็ต Subscription Prompt เป็นค่าเริ่มต้น วิดเจ็ตนี้จะกระตุ้นให้ผู้ใช้เลือกรับ และเมื่อตกลงแล้ว จะเป็นการเรียกใช้ข้อความแจ้งของเบราว์เซอร์แบบเนทีฟ
ในการปรับแต่งข้อความและลักษณะที่ปรากฏของข้อความแจ้ง ให้คลิก Settings
ประเภทของข้อความแจ้ง (Prompt types)
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
เพิ่มใบรับรองใหม่ (Add new certificate)

- เลือกประเภท Website Push ID Certificate และคลิก Continue

- เลือก Website Push ID - ซึ่งเป็นสตริง reverse-domain ที่ไม่ซ้ำกันของคุณ เช่น web.com.example.domain (ต้องขึ้นต้นด้วย web.)

อัปโหลด Certificate Signing Request หากต้องการเรียนรู้เพิ่มเติมเกี่ยวกับการสร้าง Certificate Signing Request โปรดดูบทความ 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 พร้อมชุดไอคอน, website JSON dictionary และไฟล์ manifest ที่ Safari ร้องขอจากเซิร์ฟเวอร์โดยอัตโนมัติ คุณสามารถดาวน์โหลดได้ทุกเมื่อที่ต้องการ