ข้ามไปยังเนื้อหา

การกำหนดค่า Web push

ในการเริ่มต้นส่งการแจ้งเตือน Web push ด้วย Pushwoosh คุณต้องกำหนดค่าแพลตฟอร์ม Web push ของคุณและเปิดใช้งานข้อความแจ้งให้สมัครรับ (subscription prompt) ที่แสดงต่อผู้ใช้

ในการเริ่มการกำหนดค่า ไปที่ Settings > Platform Configuration > Web Push Notifications และคลิก Configure

Configure web push notifications

กำหนดค่า Web push สำหรับทุกเบราว์เซอร์ (ยกเว้น Safari เวอร์ชันเก่า)

Anchor link to

การกำหนดค่านี้ใช้ได้กับเบราว์เซอร์สมัยใหม่ทั้งหมด รวมถึง Safari เวอร์ชันล่าสุด ซึ่งตอนนี้รองรับการแจ้งเตือน Web push แบบเนทีฟแล้ว

หมายเหตุ: Safari เวอร์ชันเก่า (macOS 10.14–12) ต้องการการตั้งค่าแยกต่างหาก คุณสามารถกำหนดค่าได้ในส่วนเฉพาะ เรียนรู้เพิ่มเติม

ในการเริ่มการตั้งค่า ให้คลิก Configure ใต้ All browsers configuration

Configure web push for all browsers

ในหน้าต่างการกำหนดค่า เลือกหนึ่งในตัวเลือกต่อไปนี้:

  • 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 เพื่อสร้างและใช้คีย์

Create a new push configuration

เมื่อสร้างแล้ว Pushwoosh จะใช้คีย์เหล่านี้ในการกำหนดค่า SDK โดยอัตโนมัติ เรียนรู้เพิ่มเติมเกี่ยวกับการผสานรวม Web Push SDK

ใช้การกำหนดค่าที่มีอยู่ (Use existing configuration)

Anchor link to

หากคุณมีคีย์ VAPID อยู่แล้ว (เช่น คีย์ที่สร้างผ่าน Firebase) คุณสามารถนำมาใช้ซ้ำเพื่อตั้งค่าการแจ้งเตือน Web push ใน Pushwoosh ได้

สำหรับขั้นตอนนี้:

  1. เลือก Use existing configuration

  2. ในช่อง Web Push Certificate ให้ป้อน VAPID public key ของคุณ

  3. ในช่อง Web Push Private Key ให้ป้อน VAPID private key ของคุณ

  4. คลิก Configure เพื่อบันทึกและใช้การตั้งค่า

Use existing configuration

วิธีค้นหาคีย์ VAPID ใน Firebase

Anchor link to

หากคุณกำลังย้ายจาก Firebase และต้องการใช้คีย์ VAPID ที่มีอยู่ของคุณซ้ำ ให้ทำตามขั้นตอนต่อไปนี้เพื่อค้นหา

Web Push certificate
Anchor link to
  1. ใน Firebase ไปที่ Project Settings → Cloud Messaging
  2. เลื่อนลงไปที่ส่วน Web Configuration และคัดลอกคู่คีย์ (key pair) ที่มีอยู่

Find Web Push certificate

  1. วางลงในช่อง Web Push Certificate ในฟอร์มการกำหนดค่าเว็บของ Pushwoosh

Paste it into the Web Push Certificate field

Web Push private key
Anchor link to
  1. ใน Firebase Console ไปที่ Project Settings → Cloud Messaging → Web Configuration
  2. คลิก เมนูสามจุด ใต้ Actions ถัดจากคู่คีย์ แล้วเลือก Show private key คีย์นี้จำเป็นเพื่อให้แน่ใจว่าการแจ้งเตือน Web Push ทำงานได้อย่างถูกต้อง

Find Web Push private key

  1. คัดลอกคีย์ที่แสดงไปยังคลิปบอร์ดของคุณ

  2. ในฟอร์ม Pushwoosh Web Configuration ให้วางลงในช่อง Web Push Private Key

Paste Web Push private key

  1. คลิก Apply เพื่อบันทึกการเปลี่ยนแปลงของคุณ

กำหนดค่าการตั้งค่า Web push ใหม่ (Reconfigure web push configuration)

Anchor link to

หากคุณได้ตั้งค่าการแจ้งเตือน Web push ไปแล้ว แต่ต้องการอัปเดตข้อมูลประจำตัวของคุณ (เช่น เปลี่ยนคีย์ VAPID) นี่คือวิธีการ:

  1. คลิก Reconfigure ใต้ All browsers configuration

Reconfigure web push configuration

  1. ในป๊อปอัปที่ปรากฏขึ้น ให้ป้อนคีย์ VAPID ใหม่ของคุณ:

    • Web Push Certificate: VAPID public key ใหม่ของคุณ
    • Web Push Private Key: VAPID private key ใหม่ของคุณ
  2. คลิก Configure เพื่อบันทึกการเปลี่ยนแปลง

กำหนดค่าข้อความแจ้งให้สมัครรับ (Subscription prompt)

Anchor link to

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

เนื่องจากการเปลี่ยนแปลงนโยบายล่าสุดของ Chrome และ Firefox ป๊อปอัปขออนุญาตแบบเนทีฟจะปรากฏขึ้นได้ก็ต่อเมื่อผู้ใช้มีปฏิสัมพันธ์กับหน้าเว็บแล้วเท่านั้น (เช่น การคลิกปุ่ม) เพื่อให้เป็นไปตามข้อกำหนดนี้ Pushwoosh จะแสดง วิดเจ็ต Subscription Prompt เป็นค่าเริ่มต้น วิดเจ็ตนี้จะกระตุ้นให้ผู้ใช้เลือกรับ และเมื่อตกลงแล้ว จะเป็นการเรียกใช้ข้อความแจ้งของเบราว์เซอร์แบบเนทีฟ

ในการปรับแต่งข้อความและลักษณะที่ปรากฏของข้อความแจ้ง ให้คลิก Settings

Configure the Subscription prompt

ประเภทของข้อความแจ้ง (Prompt types)

Anchor link to

มีข้อความแจ้งให้สมัครรับสองประเภทให้เลือกใช้:

หมายเหตุ: เนื่องจากข้อจำกัดของแพลตฟอร์ม การเปลี่ยนแปลงวิดเจ็ตอาจใช้เวลาถึง 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
  1. ไปที่ส่วน Certificates, Identifiers & Profiles ของ Apple Developer Portal

  2. เพิ่มใบรับรองใหม่ (Add new certificate)

  1. เลือกประเภท Website Push ID Certificate และคลิก Continue
  1. เลือก Website Push ID - ซึ่งเป็นสตริง reverse-domain ที่ไม่ซ้ำกันของคุณ เช่น web.com.example.domain (ต้องขึ้นต้นด้วย web.)
  1. อัปโหลด Certificate Signing Request หากต้องการเรียนรู้เพิ่มเติมเกี่ยวกับการสร้าง Certificate Signing Request โปรดดูบทความ Developer Account Help

  2. หลังจากนั้น ให้ดาวน์โหลดใบรับรองการแจ้งเตือนพุช

กำหนดค่า Safari ใน Pushwoosh

Anchor link to
  1. คลิก Configure ใต้ Safari Configuration

Configure Safari in Pushwoosh

  1. กรอกข้อมูลในฟอร์มการกำหนดค่าดังต่อไปนี้:
Website nameชื่อเว็บไซต์ของคุณที่ปรากฏในข้อความแจ้งพุช
Allowed domainsรายชื่อโดเมนที่ได้รับอนุญาตให้ขอสิทธิ์การแจ้งเตือน (หนึ่งโดเมนต่อบรรทัด)
URL templateURL ที่จะเปิดเมื่อผู้ใช้คลิกการแจ้งเตือน รองรับตัวยึดตำแหน่ง เช่น %@ เพื่อแทรกค่าแบบไดนามิก ตัวอย่าง: https://yourwebsite.com/%@
Website iconอัปโหลดรูปภาพ PNG สี่เหลี่ยมจัตุรัส (256×256 px) Pushwoosh จะปรับขนาดให้อัตโนมัติสำหรับอินเทอร์เฟซต่างๆ
Key fileอัปโหลดใบรับรอง .p12 ที่ส่งออกจากบัญชี Apple Developer ของคุณ
Private key passwordรหัสผ่านที่ใช้เมื่อส่งออกไฟล์ .p12

Fill in the Safari configuration form

  1. คลิก Configure เพื่อบันทึกการเปลี่ยนแปลงของคุณ

Pushwoosh จะสร้าง push package พร้อมชุดไอคอน, website JSON dictionary และไฟล์ manifest ที่ Safari ร้องขอจากเซิร์ฟเวอร์โดยอัตโนมัติ คุณสามารถดาวน์โหลดได้ทุกเมื่อที่ต้องการ