When you connect OneSignal to ActiveCampaign, you can use automation to send web and mobile push notifications to your site visitors and app users. You can use this integration to send timely messages when someone visits your site or prompt users to check their mobile apps.
This article will walk you through the steps for connecting OneSignal to ActiveCampaign using automation actions.
Take note
- The following is required to set up the integration:
- ActiveCampaign account with automation permissions
- OneSignal account setup and configured to send push notifications
- Setup and configuration of the web app in OneSignal
- Push notification templates (if using) in OneSignal. Platforms supported include:
- Apple iOS (APNs)
- Google Android (FCM)
- Web
- OneSignal User auth key
- OneSignal Rest API key for each web app
- OneSignal App ID
- OneSignal External ID field for each Subscription record populated with the unique identifier for ActiveCampaign (email address)
- Coming soon: Contacts captured through an ActiveCampaign form will automatically populate the OneSignal External ID field
- Note: Please contact your web or mobile app developer to configure a path to push the email address of an ActiveCampaign contact to the OneSignal External ID
- Note: OneSignal does not push the email address captured from the email or phone prompt within the Permission Prompt Setup
- This integration supports web push and mobile push notifications only. This integration does not support in-app messaging
- For web push notifications - OneSignal stopped supporting new apps from using Blogger, Bubble, Squarespace, Webflow, Weebly, Wix, HTTP sites, and website builders that don't support uploading Service Workers to a server (which are required for web push). Learn more here
- Wix Studio customers - Please review this article about uploading OneSignal's service worker file to your root directory
Watch a video
How it works
This integration is configured on the automation level. To set it up, you must create an automation that uses the OneSignal “Send push notification” action.
Once you add the action to your automation, you will walk through the OneSignal authentication and configuration steps. You can use a OneSignal template for your push notification or manually create your message in the configuration.
After you connect the integration and set the automation to “Active,” contacts who enter your automation and make it to your OneSignal action will be sent a push notification. In addition, the activity stream on the contact records will show that they entered your automation.
You can find reporting for this integration in your OneSignal account. You can also use ActiveCampaign to create an advanced search of all contacts who entered and completed your OneSignal automation.
This integration does not add tags to contacts. If you want to add tags to contacts who were sent a push notification, you must add the “Add a tag” action to your automation, following the OneSignal action.
Connect OneSignal to ActiveCampaign to send push notifications
- Ensure you have the following setup on the OneSignal side: OneSignal account configured to send push notifications, ActiveCampaign App, and Templates (recommended).
- Gather the following information from OneSignal and save it to a file for step 5 (below):
- User auth key - This is the account-level key and is located under Account & API Keys
- API key - This is the app-level API key and is located under the ActiveCampaign App > Keys & IDs for the ActiveCampaign app
- OneSignal App ID - This is the app-level API key and is located under the ActiveCampaign App > Keys & IDs for the ActiveCampaign app
- From ActiveCampaign, create or edit an automation.
- Drag the OneSignal action to your automation. It is under the “CX Apps” portion of the automation action menu.
-
Complete the following steps in the OneSignal automation action to connect the integration:
- Paste your OneSignal User Auth Key into the field provided, then click “Connect”
- Select the web app you wish to use from the dropdown menu
- Paste the web app API key
-
Select the push notification template you wish to use (recommended). You can manually create your push notification here if you do not want to use a template.
- To manually create a push notification in the automation action: enter your URL, heading (subject line), and content
- You can also use personalization tags for the following in your message: Contact, Account, Deal, Ecommerce, and Custom objects
- Click the “Finish” button
Troubleshooting
Review your Template settings to allow pushes on various devices.
- Web Push troubleshooting guide
- Mobile Push troubleshooting guide
- Common reasons why Web Push notifications are not showing on your device
- Common reasons why Mobile Push notifications are not showing on your device