Outsystems

เริ่มต้นด้วยการติดตั้งปลั๊กอิน Pushwoosh จาก OutSystems Forge วิธีที่เร็วที่สุดคือการไปที่แท็บ OutSystems ในสภาพแวดล้อมการพัฒนาของคุณและติดตั้งจากที่นั่น

คุณจะต้องกำหนดค่า Pushwoosh สำหรับแต่ละแพลตฟอร์มที่คุณจะรองรับ เมื่อการกำหนดค่าของคุณเสร็จสิ้น คุณจะได้รับ Application Code จาก Pushwoosh ซึ่งจะใช้กับปลั๊กอินของคุณ

เรียนรู้วิธี กำหนดค่า Pushwoosh สำหรับ iOS

เรียนรู้วิธี กำหนดค่า Pushwoosh สำหรับ Android

1. ในแอปพลิเคชันของคุณ ใช้ “Manage Dependencies…” เพื่อเพิ่มการอ้างอิงถึงปลั๊กอิน Pushwoosh

2. เพิ่มบล็อก “PushwooshNotifications” ไปที่:

   • บล็อก “Layout” หากแอปพลิเคชันของคุณไม่มีการเข้าสู่ระบบ
   • บล็อก “LayoutBlank” หากแอปพลิเคชันของคุณมีการเข้าสู่ระบบ

   เมื่อเพิ่มบล็อก “PushwooshNotifications” ให้หลีกเลี่ยงการเพิ่มเข้าไปใน placeholders เนื่องจากบางส่วนมีให้ใช้งานเฉพาะในเวลาออกแบบเท่านั้น และในเวลาทำงาน Pushwoosh จะไม่ทำงาน

3. ตั้งค่าพารามิเตอร์ต่อไปนี้ใน PushwooshNotifications:

   • PushwooshApplicationCode: โค้ด Pushwoosh ที่คุณได้รับหลังจากสร้างแอปพลิเคชันใน Pushwoosh
   • FCMSenderId: หมายเลขประจำตัวที่คุณได้รับขณะกำหนดค่า Android คุณสามารถปล่อยว่างไว้ได้หากแอปพลิเคชันของคุณมีให้ใช้งานเฉพาะสำหรับ iOS
   • NotificationReceivedEvent (ไม่บังคับ): อีเวนต์ที่ถูกเรียกเมื่อได้รับการแจ้งเตือนขณะที่แอปพลิเคชันอยู่ในสถานะเบื้องหน้า (foreground)
   • NotificationOpenedEvent (ไม่บังคับ): อีเวนต์ที่ถูกเรียกเมื่อผู้ใช้คลิกการแจ้งเตือนบนอุปกรณ์ของตน

หากคุณกำลังใช้ปลั๊กอิน Pushwoosh ในแอป Android ของคุณ ให้ทำดังต่อไปนี้:

1. รับ google-services.json จาก Firebase ชื่อแพ็กเกจจากบริการของ Google ต้องตรงกับตัวระบุแอปของแอปพลิเคชัน OutSystems ที่กำลังสร้าง
2. สร้างไฟล์ zip ที่มี google-services.json อยู่ในราก (root)
3. อัปโหลดไฟล์ “google-services.zip” จากขั้นตอนก่อนหน้าไปยังแอปพลิเคชัน OutSystems ของคุณและตรวจสอบให้แน่ใจว่า:
   • ตั้งค่า “Name” เป็น “google-services.zip”
   • ตั้งค่า “Deploy to Target Directory” เป็น “google-services”

เพื่อให้เครื่องของคุณรับการแจ้งเตือนแบบพุชได้ คุณจะต้องลงทะเบียนอุปกรณ์ของคุณ หากผู้ใช้ของคุณต้องเข้าสู่ระบบเพื่อใช้แอปพลิเคชัน ให้ไปที่หน้าจอ “Login” และแก้ไขการกระทำ “Login”

เพิ่มโค้ดเพื่อลงทะเบียนอุปกรณ์หลังจากการกระทำ “DoLogin” ควรมีลักษณะดังนี้:

หากแอปพลิเคชันของคุณไม่มีการเข้าสู่ระบบ คุณสามารถเพิ่มโค้ดนี้ไปที่อีเวนต์ OnInitializeOver ในบล็อก PushwooshNotifications

ในตัวจัดการอีเวนต์นี้ ให้เรียกการกระทำ RegisterDevice

หากคุณกำลังสร้างแอปพลิเคชันมือถือ iOS โดยใช้ใบรับรองสำหรับนักพัฒนา (developer certificate) คุณจะต้องเพิ่ม preference ไปยังคุณสมบัติ Extensibility Configurations ของโมดูล OutSystems ของคุณ:

{
  "preferences": {
    "global": [
      {
        "name": "aps-environment",
        "value": "development"
      }
    ]
  }
}

preference นี้จะถูกเพิ่มไปยังไฟล์ entitlements ของคุณ (เรียนรู้เพิ่มเติมเกี่ยวกับ entitlements ใน เอกสารสำหรับนักพัฒนาของ Apple)

หากคุณกำลังสร้างแอปพลิเคชันมือถือ iOS โดยใช้ใบรับรองสำหรับใช้งานจริง (production certificate) คุณไม่จำเป็นต้องระบุ preference ใดๆ เนื่องจากค่าเริ่มต้นของ preference aps-environment ใน OutSystems คือ production

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

ในการส่งการแจ้งเตือน คุณต้องมี โทเค็นการเข้าถึง API ของ Pushwoosh สร้างโทเค็นโดยการเข้าถึงคอนโซลของ Pushwoosh ไปที่ “API Access” และคลิก “Generate new access token”

ในการส่งการแจ้งเตือนไปยังทุกอุปกรณ์ ให้ใช้การกระทำ SendPushNotificationToAll

การกระทำนี้ใช้พารามิเตอร์ต่อไปนี้:

• PushwooshApplicationCode: โค้ด Pushwoosh ที่คุณได้รับหลังจากสร้างแอปพลิเคชันใน Pushwoosh
• ApiAccessToken: โทเค็นการเข้าถึง API ของ Pushwoosh ที่ได้รับมาก่อนหน้านี้
• Message: ข้อความที่คุณต้องการส่ง
• Badge: ตัวเลขที่แสดงบนไอคอนแอปพลิเคชันของ iOS
• Deeplink: ดีปลิงก์ที่จะส่งไปพร้อมกับการแจ้งเตือน เรียนรู้ วิธีตั้งค่าดีปลิงก์

ตัวอย่างเช่น หากคุณใช้การกระทำนี้เพื่อส่งข้อความ “Hello from OutSystems” ไปยังแอปพลิเคชันชื่อ “PushTest” สิ่งต่อไปนี้จะแสดงใน iOS:

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

ความคิดเห็นของคุณช่วยให้เราสร้างประสบการณ์ที่ดีขึ้น เรายินดีที่จะรับฟังจากคุณหากคุณมีปัญหาใดๆ ในระหว่างกระบวนการผสานรวม SDK หากคุณประสบปัญหาใดๆ โปรดอย่าลังเลที่จะแบ่งปันความคิดเห็นของคุณกับเรา ผ่านแบบฟอร์มนี้