OneSignal automation guide | Atom Mobility Help Center

Automations can help a merchant engage with their user base through OneSignal on scale and minimize the time the merchant spends on OneSignal creating and triggering different outreach through push messages.

Also, since recently, ATOM has added email support on the OneSignal integration which means that merchants have one additional communication channel with their end-users through OneSignal now. In order for the email outreach to work, the users need to opt into receiving marketing emails through the merchant's app either during registration or in their profile settings.

For each user, ATOM system creates two subscriptions - one for mobile app push notifications and another one for emails:

For each subscription in OneSignal, tags can be added. Below you will find a list of all possible tags that can currently be added:

#	OneSignal Dashboard
1	user_id
2	device_id
SHARING
3	total_sharing_rides
4	sharing_last_ride_started_timestamp
5	sharing_last_ride_timestamp
RENTAL
6	total_rental_rides
7	rental_last_ride_started_timestamp
8	rental_last_ride_timestamp
9	rental_booking_made_timestamp
10	rental_booking_cancelled_timestamp
11	rental_booking_extended_timestamp
RIDE-HAILING
12	total_taxi_rides
13	taxi_last_ride_started_timestamp
14	taxi_last_ride_timestamp
15	taxi_last_ride_requested_timestamp
16	taxi_last_ride_accepted_timestamp
17	taxi_last_ride_cancelled_timestamp
18	taxi_last_ride_scheduled_timestamp

The tags available for a project depend on:

The plan the merchant is using in their OneSignal account. The Free plan supports only 2 tags, the Growth plan supports 10 tags, and the Professional plan supports 100 tags;
The enabled flows for the client: Sharing, Rental, and/or Ride-hailing.

NB! USER_ID and DEVICE_ID tags are mandatory and cannot be disabled. This means that clients on the Free OneSignal plan cannot enable any automations.

All of the following instructions only apply to clients with more than 2 tags allowed.

Tag management for clients is done by ATOM support team, so in case you're on OneSignal's Growth or Professional plan and require enabling more tags for your project, please reach out to help@atommobility.com

Automation Setup

To set up automation for push notifications and/or emails, follow these steps:

Create a Segment;
Create a Message Template that will be sent automatically;
Create the Automation.

Example: Create an Automation to Send an Email After a User Completes Their 10th Ride in SHARING flow.

Step 1: Create a Segment

Go to OneSignal Dashboard > Audience > Segments > New Segment.
In the Segment Editor:
1. Segment Name: 10 rides
2. Select User Tag:
  1. Key: total_sharing_rides
  2. Operator: is
  3. Value: 10
3. Click Create Segment.

Step 2: Create a Message Template

Go to OneSignal Dashboard > Messages > Templates > New Template > New Email Template.
In the New Template Editor:
1. Template Name: 10 rides;
2. Select the HTML Editor;
3. Set the Message Subject and Preheader;
4. Write the email body in HTML;
5. Replace [unsubscribe_url] with:
  https://app.rideatom.com/onesignal/unsubscribe?app_id={{app.id}}&notification_id={{message.id}}&email={{subscription.email}}&language={{user.language}}&token={{subscription.unsubscribe_token}}
6. Click Save.

Step 3: Create the Automation

Go to OneSignal Dashboard > Messages > Automations > New Automated Message > New Automated Email;
In the Automation Editor:
1. Message Name: 10 rides automation;
2. In the Audience section, select the segment you created;
3. Fill in the Message Details;
4. In the Message section, select the template you created;
5. Set the Delivery Schedule;
6. Click Make Active.

Once a user is part of the segment, they will automatically receive an email informing them that they have completed 10 rides.

Using Time Operators for Segment Creation

Most tag values, aside from USER_ID, DEVICE_ID,SHARING_TOTAL_RIDES, RENTAL_TOTAL_RIDES,TAXI_TOTAL_RIDES are timestamps, which allow you to use Time Operators when creating segments. This is useful for sending messages after every ride, for example.

Example: Create a Segment with Time Operators

Go to OneSignal Dashboard > Audience > Segments > New Segment.
In the Segment Editor:
1. Segment Name: After each ride;
2. Select User Tag:
  1. Key: sharing_last_ride_timestamp;
  2. Operator: time elapsed greater than;
  3. Value: 0;
3. Click Add Filter > User Tag:
  1. Key: sharing_last_ride_timestamp;
  2. Operator: time elapsed less than;
  3. Value: 60;
4. Click Create Segment.

This will create a segment to target users whose last ride was between 0 and 60 minutes ago, and can be used to send automated messages after every ride.

Links to more in-depth OneSignal resources on this subject: