> ## Documentation Index
> Fetch the complete documentation index at: https://partner-integrations.voyado.com/llms.txt
> Use this file to discover all available pages before exploring further.

# OneSignal

**With app push notifications a retailer can send messages and updates to users directly in their mobile devices. To enable this, Engage can integrate with OneSignal, which supports seamless message composition, scheduling, follow-ups, and performance analysis. This makes it a versatile tool for real-time engagement and personalized customer communication.**

This integration with OneSignal reduces complexity by moving segmentation, scheduling and automated messaging to Engage. With all outbound messaging in a single platform, you can create relevant, timely notifications that encourage app interactions and conversions.

## Setting up the integration

**Engage:** Set up your Engage account and confirm access to the Engage API. Ensure your Engage API keys are available for integration and message automation settings. Refer to Engage’s API docs for details on API authentication, permissions, and secure API key handling.

<Card title="Learn about the Engage API" href="https://developer.voyado.com/docs/api/the-engage-api" icon="https://mintcdn.com/voyado-partners/0IxEIB2Y6a--gNYY/icons/developer-link.png?fit=max&auto=format&n=0IxEIB2Y6a--gNYY&q=85&s=36f1df27b0269657d842f3301d440083" horizontal width="128" height="128" data-path="icons/developer-link.png" />

**OneSignal:** Set up an account with [<u>OneSignal</u>](https://onesignal.com/) and follow the setup instructions to integrate its push notification capabilities within your app. Consult the OneSignal documentation for technical support and configuration tips.

<Card title="See the OneSignal documentation" href="https://documentation.onesignal.com" icon="right" horizontal />

## Using the integration

The steps are:

<Steps>
  <Step title="Compose messages in OneSignal">
    Log into OneSignal to start composing messages. Include text, images, and deep links that are tailored to your audience and ensure that the push notifications align with other channels, complementing SMS and email. Each message will have a unique Id that you will then use in Engage.
  </Step>

  <Step title="Add message to Engage automation">
    Navigate to automations in Engage. Add the OneSignal-composed message to a new or existing automation flow in Engage, allowing you to automate your notifications.
  </Step>

  <Step title="Target audience and segmentation">
    Use Engage’s scheduling and targeting tools to define specific segments and find the relevant recipients. Similar to our other channels, but instead of composing the message in Engage just use the Id from OneSignal.
  </Step>

  <Step title="Monitor and analyze results">
    Now analyze your results by:

    * Tracking conversion rates, open rates, and engagement metrics directly within OneSignal
    * Using Engage to assess delivery performance, sending speed, and segment effectiveness
    * Continuously refining notification strategies based on metrics and feedback to increase open rates and customer interaction
  </Step>
</Steps>

## Use cases

Here are some common use cases:

### 1 - Event reminder for mobile users

Compose a reminder push notification in OneSignal for an upcoming sale event. Then schedule the reminder in Engage so that it reaches contacts 24 hours before the event.

### 2 - Personalized promotions

Segment customers based on past purchases and send a personalized promotion push notification. Use Engage to automate these notifications in an existing automation, enhancing relevancy by delivering tailored offers.

### 3 - Re-engagement campaigns

Identify inactive app users using Engage’s segmentation tool. Send a re-engagement push notification with a compelling incentive (such as a discount code) through an automation in Engage.

## Efficiency tips

Some tips to improve efficiency:

* **Advance scheduling:** Plan notifications well ahead of time to maintain consistent customer engagement
* **Stay updated:** Regularly check for new Engage and OneSignal features that could enhance notification capabilities
* **Monitor conversion metrics:** Use both Engage and OneSignal metrics to gauge notification success, identifying high-engagement times for scheduling

## Things to look out for

* **Configuration validation:** Verify that all settings are correctly configured in both Engage and OneSignal to avoid missed notifications or technical errors.
* **Data compliance:** Ensure adherence to acceptable use policies, particularly around data protection and user opt-in compliance.