Introduction
Push notifications have become an essential tool for businesses to engage with their users, providing real-time updates and alerts.
This article will explore the benefits of integrating push notifications into your marketplace, explain how the system works, and offer practical use cases to illustrate its effectiveness.
🔵 Feature included from Pro Plan
Benefits for Your Business
Integrating push notifications into your marketplace offers several advantages:
Improved Customer Engagement: Push notifications keep customers informed about their order status, promotions, and updates, leading to increased engagement and satisfaction.
Operational Efficiency: Real-time notifications help streamline operations by keeping drivers, business owners, and administrators updated on order statuses and other critical information.
Enhanced Communication: Notifications ensure that important messages are delivered promptly, reducing the chances of missed information and enhancing overall communication.
Customization: Businesses can tailor notifications to suit their specific needs, ensuring that users receive relevant and timely updates.
How it works
Setting up push notifications for your marketplace involves a series of configurations. Here’s a step-by-step guide to get you started.
Configuration
For this setup, you will need a One Signal account, which can be created here https://dashboard.onesignal.com/
Then the settings must be done according to the platform/version, in other words for Android and iOS.
For Android, it's necessary to have a Firebase account, and for iOS for an Apple Developer account.
Can follow these guides to learn how to set up each version:
Then go to the Dashboard and add they Keys
One Signal Ordering App ID
Set up your Ordering App One Signal ID and the API Key. This is required for push notifications.
Add your One Signal Ordering App ID.
Add your API Key
One Signal Delivery App ID
Set up your Delivery App One Signal ID and the API Key. This is required for push notifications.
Add your API Key
Example:
c5e6d6d8-ca5f-462e-b00d-8da6f5270d77
One Signal Business App ID
Set up your Business App One Signal ID and the API Key. This is required for push notifications.
Add your API Key
Example:
dcd05d37-3677-4da3-acc3-f97641e23a9f
Notification Settings
Notification when Driver is Close to Business, or customer: This notification will be sent according to the distance you set in this setting.
One Signal Ordering Web ID
Set up your Ordering Web One Signal ID and the API Key. This is required for push notifications.
Add your One Signal Ordering Web ID.
Add your API Key
One Signal Dashboard Web ID
Set up your Dashboard Web One Signal ID and the API Key. This is required for push notifications.
Add your One Signal Dashboard Web ID.
Add your API Key
Notification Frequency
Number of times notifications are repeated: Set the number of times notifications are repeated (MAX 15).
How often are notifications repeated: Set the frequency of notifications repetition (in seconds).
Allow repeat notifications by Superadmin, Business Owner, Driver: Configure whether repeat notifications are allowed by these roles.
Notification In App
Notification In App Enabled: Enable or disable in-app notifications.
Notification In App Position: Set the position for in-app notifications.
OneSignal Credentials
Fill in your OneSignal keys and IDs for each app to enable push notifications:
OneSignal User Authentication Key
General key from your OneSignal account to authenticate usage.
Customer App OneSignal ID
Enables notifications for your customer-facing app.
Ordering App REST API Key
Allows communication between the Ordering app and OneSignal.
Business App OneSignal ID
Enables push notifications for your Business App users.
Business App REST API Key
Required for backend interactions with your Business App notifications.
Delivery App OneSignal ID
Activates notifications for drivers using your Delivery App.
Delivery App REST API Key
Authorizes push actions from your delivery platform to OneSignal.
Website OneSignal ID
Adds push notifications for your browser-based ordering website.
Dashboard OneSignal ID
Enables alerts directly within your admin dashboard.
Dashboard REST API Key
Lets your admin dashboard interact with OneSignal for real-time alerts.
Proximity and Repeats
Customize how your alerts behave based on delivery and user actions:
Notification Proximity Alert Settings
Sends alerts when a driver is within a certain distance of a store or customer.
Set Max Notification Repeats
Sets how many times the same alert should be retried (max 15).
Set Notification Repeat Interval
Defines the delay (in seconds) between each repeated notification attempt.
Role-Based Repeats
Decide which team members will receive repeated alerts:
Enable Admin Notification Repeats
Re-send order alerts to admins if they haven’t accepted them yet.
Enable Business Owner Notification Repeats
Notifies business owners again if they haven’t accepted a new order.
Enable Driver Notification Repeats
Repeats alerts to drivers who haven’t accepted their assigned deliveries.
In-App & Default Notifications
In-app alerts help users get notified even while browsing within the app:
Enable In-App Notifications
Turns on real-time alerts within the app interface.
Set In-App Notification Position
Choose where alerts pop up (top-right is default).
One Signal Default Enabled
Activates Ordering’s default notification credentials if custom fields are empty.
SMS & WhatsApp Options
Add external communication channels as backups:
Allow text messages via WhatsApp
Enable notifications to be sent via WhatsApp to users.
Allow text messages via SMS
Allow SMS-based alerts to reach users without relying on push.
Notification Types
You can enable or disable the following notifications for users, including administrators, businesses, customers, and drivers:
ORDER_STATUS_PENDING
ORDERS_COMPLETED
ORDER_REJECTED
ORDER_STATUS_IN_BUSINESS
ORDER_READY
ORDER_REJECTED_RESTAURANT
ORDER_STATUS_CANCELLEDBYDRIVER
ORDER_STATUS_ACCEPTEDBYRESTAURANT
ORDER_CONFIRMED_ACCEPTED_BY_DRIVER
ORDER_PICKUP_COMPLETED_BY_DRIVER
ORDER_PICKUP_FAILED_BY_DRIVER
ORDER_DELIVERY_COMPLETED_BY_DRIVER
ORDER_DELIVERY_FAILED_BY_DRIVER
PREORDER
ORDER_NOT_READY
ORDER_PICKEDUP_COMPLETED_BY_CUSTOMER
ORDER_STATUS_CANCELLED_BY_CUSTOMER
ORDER_NOT_PICKEDUP_BY_CUSTOMER
ORDER_DRIVER_ALMOST_ARRIVED_BUSINESS
ORDER_DRIVER_ALMOST_ARRIVED_CUSTOMER
ORDER_CUSTOMER_ALMOST_ARRIVED_BUSINESS
ORDER_CUSTOMER_ARRIVED_BUSINESS
ORDER_DRIVER_WAITING_FOR_ORDER
ORDER_DRIVER_WAITING_FOR_CUSTOMER
DRIVER_ASSIGNED
DRIVER_CLOSE
NEW_BUSINESS_OWNER_SIGNUP
NEW_DRIVER_SIGNUP
Practical Use Cases
Order Status Updates: Customers receive real-time notifications about their order status, such as when the order is accepted, ready, and out for delivery.
Driver Alerts: Drivers get alerts when they are close to the pick-up or drop-off location, improving efficiency and reducing wait times.
Business Owner Notifications: Business owners are notified about new orders, order cancellations, and driver assignments, allowing them to manage operations effectively.
Administrator Controls: Administrators can send out mass notifications about system updates or promotional offers, ensuring all users are informed.
Conclusion
Integrating push notifications into your marketplace enhances communication, improves operational efficiency, and boosts customer satisfaction.
By following the configuration steps and enabling relevant notifications, businesses can ensure timely and effective communication with all users. Embrace the power of push notifications to stay connected and keep your marketplace running smoothly.