Radar can track customer pickups for orders placed through Olo. The integration includes optional capabilities to fire orders based on live location updates and send approaching and arrival alerts to Olo Expo.
Configure an Olo webhook to deliver order events to https://api.radar.io/webhooks/olo via the Development Tools section of the Olo Dashboard (requires two-factor authentication and at least Brand Manager permission). Under the Order Events section, enable Order Placed and Order Cancelled. If leveraging Olo Expo, enable the Order Picked Up event as well.
Once the webhook is setup, your Radar account team will setup the configuration on the Integrations page. Applicable Olo Handoff modes, a destination geofence tag (e.g.,
restaurant), and custom field mappings from the Olo webhook body to Radar trip metadata will be set.
Radar will automatically create trips when new orders are placed, as well as complete or cancel trips when orders are completed or cancelled in Olo. Call
Radar.startTrip(tripOptions, trackingOptions) with
tripOptions.externalId set to the Olo order ID to start the Radar trip and enable tracking.
The mapping below will be used between the Olo webhook and a Radar trip:
|Olo webhook field
|Radar trip attribute
|Trip external id
|Trip approaching threshold*
|Trip scheduled arrival at*
*Requires enabling the associated auto-calculate order firing setting
Assuming locations permissions have been granted and location tracking has been started in your app, Radar will calculate live ETAs to the restaurant and generate
user.arrived_at_trip_destination events. Learn more about Trip Tracking.
Radar can fire orders in Olo based on customer location rather than a preset time to ensure food preparation time aligns with customer arrival.
Orders in Olo will need to have
ismanualfire set to
true or set a
timewanted for advance orders.
Additionally, configure Radar with a Partnership Type of Customer Arrival via the Partner Management section of the Olo Dashboard. Select stores in the configuration where order firing will be enabled. Upon completion, reach out to your Radar account team to complete the order firing integration.
The trip's approaching threshold and scheduled arrival at attributes are used to determine the order firing time. When an active trip ETA drops below the approaching threshold, Radar generates a
user.approaching_trip_destination event and Radar will fire the order. If the trip is started inside the destination geofence, Radar will fire the order immediately. In the event the
scheduledArrivalAt set on the trip is reached before the approaching threshold is crossed, the order will automatically fire. See below for how to configure these two parameters.
scheduledArrivalAt datetime is required as a fallback in the event location sharing is disabled or the device is experiencing connectivity issues.
You can enable auto-calculation of the
scheduledArrivalAt, which is initially set to the
timeReady value from the Olo Order Placed webhook and then continues to update based on each trip ETA calculation. This includes a backup fire delay setting which is a maximum number of minutes to push back the initial scheduled arrival at. This can be configured in Trips Settings.
As an alternative to Radar's automatic calculation, manually set the
scheduledArrivalAt either via
Radar.startTrip() in the app,
Radar.updateTrip() in the app or the Trips API server-side. Setting this manually will override use of Radar's auto-calculated
In the Radar Trips Settings, set the Approaching threshold (minutes) value as the default number of minutes away from arriving that the order should automatically be fired to Olo.
You can enable Radar to auto-calculate the approaching threshold for ASAP orders, which is initially set to the time difference between
timePlaced from the Olo Order Placed webhook.
As an alternative to Radar's automatic calculation, set the approaching threshold either at the store level via the
tripApproachingThreshold property in the geofences API or at the order level via
Radar.updateTrip() in the app or Trips API server-side.
Radar is a Customer Arrival Olo partner and can automatically provide Approaching and Arrival status updates to Olo Expo based on Radar trip tracking events. This keeps in-store teams up-to-date with real-time status updates on tracked mobile orders. Additionally, if your team utilizes the Picked Up button in Olo Expo, this will automatically complete the Radar trip and capture completion time for trip duration and wait time analytics.
Configure Radar as a Customer Arrival Partnership Type via the Partner Management section of the Olo Dashboard if this was not completed to enable order firing. Select stores in the configuration where order firing will be enabled. Upon completion, reach out to your Radar account team to complete the order firing integration.
Finally, on the Integrations page under Olo, you will need to set Expo updates enabled to Yes, and save your integration settings.