Integration Guide:
Mobile App Notifications

Bettermile enables you to create a customized tracking experience by sending real-time tracking events to your backend. This guide explains how to leverage these tracking events for an example use case to implement notifications in a customer's mobile app.

Integration Steps

  1. Availability Messages: With those messages, we send you parcel IDs that have become “real-time trackable” at this very moment. As soon as a parcel is trackable, we send availability events via webhook .
  2. Subscribing to Parcels: To receive subsequent updates on parcels, you must subscribe to them via the Tracking Subscribe endpoint. To reduce load and minimize costs, we recommend subscribing only to parcels for which you plan to send notifications to consignees.
  3. Tracking Messages: We push all updates for subscribed parcels via the tracking webhook .

Sequence Diagram

ConsigneeTenantBettermilesubscribe to notificationsonly for customers who havethe Tenant's app installedWebhook push: [availability event]Subscribe to get Tracking Updates[tracking event]Webhook push: [tracking event]Mobile NotificationConsigneeTenantBettermile