Met de OneSignal integratie kun je OneSignal pushmeldingen maken en versturen met behulp van workflows, pushmeldingen weergeven op de activiteitentijdlijnen van contactpersonen en gebruikers segmenteren op basis van betrokkenheid bij pushmeldingen.
Vereisten voor integratie
Verbind de app
- Gebruik de zoekbalk om de OneSignal integratie te vinden en te selecteren.
- Klik rechtsboven op app installeren.
- Log in op uw OneSignal account.
- Voer in het pop-upvenster je applicatie-ID en API-sleutel van je OneSignal-account in.
- Klik indien nodig op Applicatie toevoegen om een andere applicatie toe te voegen.
- Klik op App installeren.
- Je wordt doorgestuurd naar de pagina Aangesloten apps.
Koppel je OneSignal gebruiker aan je HubSpot gebruiker
De integratie vereist dat je OneSignal gebruiker wordt gekoppeld aan HubSpot contactpersonen. Gebruikers hebben twee opties om te matchen:
- Op e-mailadres: gebruikers moeten OneSignal's setEmail functie gebruiken met behulp van hun SDK om OneSignal gebruikers te koppelen aan e-mailadressen. Deze matching optie is alleen beschikbaar voor de Send OneSignal notification workflow actie.
- Door OneSignal external_user_id: gebruikers moeten de HubSpot contact eigenschap selecteren die ze willen matchen met de external_user_id in OneSignal. Om dit te doen:
- Klik op OneSignal.
- Klik op Contactmatching.
- Selecteer in het dropdown menu de HubSpot contacteigenschap die je wilt gebruiken om te matchen met de OneSignal external_user_id eigenschap. Deze matching optie is beschikbaar voor zowel de Send OneSignal notifications als de Edit OneSignal tags workflow acties.
OneSignal push notificaties automatiseren
Je kunt het verzenden van OneSignal pushberichten automatiseren met workflows.
- Klik rechtsboven op Workflow maken.
- Selecteer in het linkerpaneel Contactgebaseerd en klik rechtsboven op Volgende.
- Stel uw inschrijftriggers in.
- Klik op het + plus-pictogram om een actie toe te voegen.
- Selecteer Send OneSignal notification in het rechterpaneel.
- Klik op het Select App dropdown menu om je verbonden OneSignal apps te selecteren.
- Klik op het vervolgkeuzemenu Do you want to use an existing OneSignal Push Template or Create a New Push? en selecteer een sjabloonoptie:
- Om een bestaande sjabloon te selecteren, klik je op Use templates.
-
- Om een nieuw sjabloon te maken, klik je op Use custom configuration en vul je de verplichte velden in. Je kunt personalisatietokens gebruiken in deze velden.
- Klik op Opslaan.
- U kunt extra acties aan uw workflow toevoegen.
- Als u klaar bent met het instellen van uw workflow, klikt u rechtsboven op Controleren.
- Controleer je workflow en klik rechtsboven op Aanzetten.
De pushmelding verschijnt als een activiteit op de tijdlijn van de contactpersoon.
OneSignal tags automatiseren om in-app berichten te activeren
Gebruik workflows om in-app berichten te activeren in je OneSignal app.
- Klik rechtsboven op Workflow maken.
- Selecteer Contactgebaseerd in het linkerpaneel en klik vervolgens op Volgende in de rechterbovenhoek.
- Stel uw inschrijftriggers in.
- Klik op het + plus pictogram om een actie toe te voegen.
- Selecteer in het rechter paneel OneSignal tags bewerken.
- Klik op de Select App dropdown menu's om je verbonden OneSignal apps te selecteren.
- Voer een JSON-string in met {"key" : "value" } paren die je wilt bewerken. Leer meer over het gebruik van OneSignal data tags.
- Klik op Opslaan.
- Je kunt extra acties toevoegen aan je workflow.
- Als je klaar bent met het instellen van je workflow, klik je rechtsboven op Review.
- Controleer uw workflow en klik op Aanzetten.
Het bewerken van OneSignal tags kan ook in-app berichten in OneSignal aandrijven. Raadpleeg de handleiding van OneSignal voor stappen om dit te doen.
Gebruik HubSpot formulierverzendingen om HubSpot contactpersonen te koppelen aan OneSignal gebruikers
Om deze functionaliteit te gebruiken, moet je ervoor zorgen dat je de juiste code van je OneSignal Web Push instellingen hebt toegevoegd aan de head HTML van je pagina's.
Je hebt twee opties om e-mailadressen vast te leggen en door te geven aan OneSignal:
- Plaats het volgende globaal in je <head> ... </head> om toe te passen bij formulierverzendingen:
window.addEventListener('message', event => {
if(event.data.type === 'hsFormCallback' && event.data.eventName === 'onFormSubmit') {
OneSignal.push(function() {
OneSignal.setEmail($("input[name=email]").val())
.then(function(emailId) {
// Callback called when email have finished sending
console.log("emailId: ", emailId);
});
}
});
- Bewerk het insluit script van een van je HubSpot formulieren direct. Je moet je portaal-ID en formulier-ID van je account invoegen. Hier is een voorbeeld:
<script charset="utf-8" type="text/javascript" src="//js.hsforms.net/forms/v2.js"></script>
<script>
hbspt.forms.create({
region: "na1",
portalId: "YOUR PORTAL ID",
formId: "YOUR FORM ID",
onFormSubmit: function($form) {
OneSignal.push(function() {
OneSignal.setEmail($("input[name=email]").val())
.then(function(emailId) {
// Callback called when email have finished sending
console.log("emailId: ", emailId);
});
});
}
});
</script>