OneSignal Help & Documentation

Welcome to the OneSignal New IA developer hub. You'll find comprehensive guides and documentation to help you start working with OneSignal New IA as quickly as possible, as well as support if you get stuck. Let's jump right in!

Get Started    Discussions

Automated Messages

OneSignal features - Automated Message Campaigns

Automated Messages are for automatically sending push notification to users once they join a segment. They are commonly used for drip campaigns like re-engaging inactive users or congratulating players on reaching a certain level.

Automated messages are not yet available in our email beta. Read more

Creating an automated message campaign

Dashboard > Messages > Automated

Before creating an automated message, be sure to go to Templates and Segments to create the template and segment(s) you wish to use in your automated message.

  1. Name your Automated Message Campaign
    This lets you identify the automated message among others.
    Examples: 'Inactive users 3 days', 'level 3 completed'

  2. Select the template you would like to use.
    You will need to have created a template for automated messages.
    We suggest dedicating one template per Automated Message to see delivery statistics in Templates.

  3. Add segment(s) to target.
    You will likely want to create specific segment(s) for automated messages.

  4. Choose your delivery options.
    Intelligent Delivery will send messages at the same time of day as the user's last session. This is the recommended delivery option, because it is personalized to the user's activity.
    "Deliver only once to a user, unless:" will cause the automated notification to repeat based on the selected option. If you do not select one of these options, the notification will only get delivered to the user once. If you select:

    • The user returns to the app. Then the user will get the notification again some time after they re-open the app.
    • X Hours have elapsed. Then the user will get the notification again after X hours have passed.

How automated messages work

Around every hour, OneSignal will deliver this message template to users in the selected segments that have not received it yet. However, users who have not been active for over 3 months will be excluded from all automated notifications.

Also, if a user is in the included segment and excluded segment, then leaves the excluded segment but is still in the included segment, they will get the notification.

By default, users will never receive an automated notification twice, even if they leave a segment and come back to it. If you want to change this default, you can select one of the "Deliver once unless..." options.

You can track the notification's performance from Templates.

Automated messages are sent out in batches of 10,000 notifications. This means if you are sending automated notifications to 36,000 users, you would see four distinct notifications in Sent Messages - three with 10,000 users, and the fourth with 6,000 users.

If you want to schedule recurring notifications for an exact time, please see our Zapier integration docs.

Using Automated Messages

Re-engagement Campaigns

Some OneSignal customers use automated messages to re-engage users that have lapsed in their usage of the app. Typically this is done by creating one or more automated messages that target users that have been inactive for a length of time. Below is an example of three automated messages that could be used together:

Automated Message
Segment Used

Inactive 1 day

Last Active is greater than 24 hours ago, but less than 72 hours ago

Inactive 3 days

Last Active is greater than 72 hours ago, but less than 168 hours ago

Inactive 7 days

Last Active is greater than 168 hours ago

For "Inactive 1 day" and "Inactive 3 days" automated messages, the Delivery boxes should not be checked to ensure users only receive a single message:

For "Inactive 7 days" automated message, you can check the "Hours have elapsed" box and add 168. This will send the same notification every week that the user remains in the "Inactive 7 days" segment:

Additionally, when sending more than one re-engagement message, we recommend using Message Collapsing or Message Replacement in the template so that the user will only have the latest re-engagement message (rather than a list of all previous ones).


Automated Messages


OneSignal features - Automated Message Campaigns

Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.