Editing Connect OneSignal to ActiveCampaign (section)

== Connect OneSignal to ActiveCampaign ==

=== Introduction ===
The integration of OneSignal with ActiveCampaign allows businesses to communicate directly with their audience through push notifications. This feature enables users to send notifications to web browsers, mobile devices, and apps while also syncing OneSignal events back to your ActiveCampaign account. By leveraging this integration, companies can enhance customer engagement, improve re-engagement rates, and personalize user experiences, making it a valuable addition to any marketing strategy.

=== How to Access This Feature ===
To utilize the OneSignal integration, you must have:
* An ActiveCampaign account with necessary automation permissions.
* A OneSignal account configured to send push notifications.
* Access to the OneSignal User Auth Key and Rest API keys for your web app.

You can access this feature directly from your ActiveCampaign dashboard by navigating to the '''Apps''' section.

=== Step-by-Step Instructions ===

==== ActiveCampaign Configuration ====
1. Log into your ActiveCampaign account and select '''Apps''' from the left menu.
2. Use the search bar to find the OneSignal integration.
3. Click on the '''Add an account''' button.
4. In the modal window, enter your OneSignal '''User Auth Key''' and click '''Connect'''.
5. Map the incoming OneSignal fields to the corresponding fields in ActiveCampaign, ensuring to map the OneSignal '''External ID''' to the ActiveCampaign '''Contact email''' field. Click '''Finish''' to complete this step.
6. Next, click the arrow next to the '''Edit''' button, then select '''Copy Webhook URL'''. Save this URL as it is required for the OneSignal configuration.

==== OneSignal Configuration ====
1. Log into your OneSignal account, go to the '''All Apps''' section, and select the app you wish to connect.
2. From the '''Data''' menu, click on '''Event Streams'''.
3. Click '''New Event Stream'''.
4. Name your Event Stream and select events from both the '''In-App Message''' and '''Push Notification''' sections. Click '''Done'''.
5. Paste the Webhook URL copied from ActiveCampaign into the URL field.
6. Under the Headers section, add a key of '''Content-Type''' with a value of '''application/json'''.
7. In the Body section, choose '''Custom Body''' and enter the JSON code provided. This must be input exactly as required for the integration to function properly.
8. Complete the process by clicking '''Activate''' to save and enable the Event Stream.

=== Configuration Options and Settings ===
The integration requires several key configurations:
* '''User Auth Key''': This is unique to your OneSignal account and is essential for establishing a connection.
* '''Webhook URL''': Copied from ActiveCampaign, this URL is needed in OneSignal to point to the event sync.
* '''JSON Body Content''': Must be formatted correctly for the integration to pass event data successfully.

=== Best Practices and Tips ===
* Ensure that email addresses captured via ActiveCampaign forms are correctly populated in the OneSignal '''External ID''' field for successful syncing.
* Regularly check the reporting features in both ActiveCampaign and OneSignal to analyze the effectiveness of your notifications and improve your strategies.
* For troubleshooting, consult the relevant guides from OneSignal regarding device-specific issues with push notifications.
* Always keep your integration documentation updated, ensuring keys and endpoints referenced are valid and current.

=== Troubleshooting ===
If you encounter issues with push notifications, the following steps are recommended:
* Review your template settings in OneSignal to ensure they permit pushes across devices.
* Consult the OneSignal web push troubleshooting guide and mobile push troubleshooting resources for common issues.
* Verify that events you expect to trigger notifications are configured correctly both within OneSignal and ActiveCampaign.

=== FAQ ===
'''Q1: What are the requirements for integrating OneSignal with ActiveCampaign?'''
A: You need an ActiveCampaign account with automation permissions, a configured OneSignal account, and necessary API keys.

'''Q2: Can I use OneSignal without ActiveCampaign?'''
A: No, this integration specifically requires an ActiveCampaign account to function.

'''Q3: What types of notifications can I send using OneSignal?'''
A: You can send web and mobile push notifications as well as in-app messages.

'''Q4: How do I ensure my email addresses sync properly with OneSignal?'''
A: Ensure the OneSignal '''External ID''' field is accurately mapped to ActiveCampaign's '''Contact email''' field.

'''Q5: What should I do if my push notifications are not being received?'''
A: Check your configuration settings in both ActiveCampaign and OneSignal, and refer to troubleshooting guides.

'''Q6: Is there a limit on the number of notifications I can send?'''
A: There is no explicit limit set by the integration; however, please refer to OneSignal's plan details for any restrictions based on your account type.

'''Q7: Where can I find reporting for this integration?'''
A: Reporting can be accessed from your OneSignal account. You can also create an advanced search in ActiveCampaign for insights.

Through the integration of OneSignal and ActiveCampaign, users are equipped to enhance interaction strategies, leading to improved user engagement and satisfaction. Ensure you follow the outlined instructions meticulously for a successful setup.
```