Sending Notifications Using OneSignal SDK

• Cross-Platform Support: OneSignal seamlessly supports multiple platforms, including Android and iOS. This means you can leverage a single solution for both operating systems.
  
  
• Ease of Integration: With its dev-friendly Flutter plugin, OneSignal simplifies the process of integrating push notifications into your Flutter application. The plugin is designed to be developer-friendly, ensuring a smooth and hassle-free integration process.
  
  
• Advanced Targeting and Segmentation: OneSignal allows you to target specific user segments with personalized messages while also providing the flexibility to tailor your messaging strategy.
  
  
• Rich Notification Content: Beyond simple text notifications, OneSignal supports rich media content, enabling you to include images, buttons, and interactive elements in your push notifications. This capability allows for a more engaging and visually appealing user experience.

• Create and set up a Firebase project.
• Enable Firebase Cloud Messaging API (V1).
• Generate a Private Key JSON file:
  • In the Firebase Console, go to Project settings.
  • Navigate to the Service accounts tab.
  • Click "Generate new private key" at the bottom of the page.
    • Save the JSON file securely; it will be needed shortly.

• In OneSignal, go to Settings > Platforms > Google Android.
• Activate the Android platform.
• Click on "Service Account JSON" and choose the JSON file you downloaded from your Firebase service account.
• Click "Save and Continue."

• After configuring Android, your OneSignal App ID and Rest API Key are ready to use.

• Activate iOS Platform in OneSignal Dashboard
  • Navigate to the OneSignal dashboard's “Settings” section and click on "Platforms."
  • Click the "Activate" button for iOS platforms to initiate the setup process.

• Get Key ID & Key (.p8 file) from Apple Developer Console Apple Developer account
  • In the Apple Developer console, go to the "Account" section.
  • Access "Certificates" and select "Keys" to create an Apple Push Notification Service (APNs) key.
  • Click the plus icon to add a new key, register a name, and click “Continue.”
  • After generating the key, access its details and copy the unique Key ID.
  • Download the authentication key by clicking the download button.
  • Upload the downloaded key to the designated “Upload” section in OneSignal.
• Obtain App's Bundle ID
  • In your Apple Developer console, go to the "Apps" section.
  • Select the specific app for which you want to enable push notifications.
  • Navigate to "App Information" and copy the app’s bundle ID, typically structured like: com.example.your_app_name
• Retrieve Team ID
  • Find your Team ID within your Apple Developer account’s account details page.
  • Copy the Team ID and paste it into the designated “Team ID” section in OneSignal.
• Save Changes
  • Confirm and save the changes made in the OneSignal dashboard.

• Open your Xcode project.
• Follow the instructions in the OneSignal iOS SDK Setup Guide to add an iOS Service Extension.
• A Service Extension is required for handling advanced features such as media attachments and interactive buttons in your push notifications.
• Enable iOS Push Capability
  • In the main app target, select Signing & Capabilities > All > + Capability, enable Push Notifications.

• Next, enable Background Modes and check Remote Notifications.

• Initializes the OneSignal SDK. This should be called during application startup. The ONESIGNAL_APP_ID can be found in Keys & IDs.
• When the OneSignal SDK is initialized in your mobile app, it creates a Subscription ID for that device. The user must opt-in (aka subscribe) to receive push notifications for your app.

In OneSignal, logging in a user is a crucial step to authenticate the user and associate their device with their account. By doing so, the user becomes eligible to receive personalized push notifications, and you gain the ability to send targeted messages to specific users based on various filters, such as tags.

• Personalized Notifications
  • Logging in allows you to associate an external user ID with the OneSignal device. This association enables the delivery of personalized push notifications tailored to individual users.
• User Segmentation with Tags
  • OneSignal provides a powerful filtering mechanism through tags. Tags are key-value pairs that can be associated with users. In the context of login, the user's unique ID is often used as a tag.
  • Using the unique user ID as a tag enables precise user segmentation, allowing you to send notifications to specific users or groups.

In OneSignal, setting a notification click listener enables you to define custom actions when a user opens a push notification. This is a powerful feature that allows you to navigate users to specific screens or perform actions based on the additional data provided with the notification. Let's explore how to implement this in a Flutter app.

OneSignal provides a versatile method, addForegroundWillDisplayListener, which allows you to listen to notifications when your app is running in the foreground. This is particularly useful for performing custom logic before displaying a notification, giving you the flexibility to decide whether to show the notification or handle specific cases differently.

• Your OneSignal App ID (appId).
• Your OneSignal API Key (apiKey).
• The OneSignal endpoint for notifications (apiUrl).
• The desired segments or filters for targeting users.
  

• Define a requestBody Map that contains the necessary information for the notification.
• In this example, we include the target segments, filters based on tags, notification content, and additional data.

• Create a headers Map that includes the necessary authorization and content-type headers.

• Use the http.post method to send a POST request to the OneSignal API endpoint with the constructed requestBody.

In conclusion, this guide aims to equip developers with the knowledge and tools necessary to leverage OneSignal effectively within their Flutter applications. By following the best practices outlined herein, developers can develop an exceptional notification system that not only keeps users informed but also enhances user satisfaction and retention.