Hoe maak ik een koppeling met OneSignal?

Wil je je contacten op een snelle, opvallende manier bereiken – ook buiten e-mail? Met de koppeling tussen OneSignal en MailBlue kun je pushmeldingen versturen naar webbrowsers en mobiele apparaten. Perfect voor korte updates, reminders of urgente meldingen die direct gezien moeten worden.

Je regelt alles direct vanuit je automatiseringen in MailBlue – zonder te schakelen tussen verschillende systemen of tools. In dit artikel lees je hoe je de koppeling instelt, welke acties je kunt inzetten en waar je op moet letten.

Belangrijk om te weten:

Voordat je begint met koppelen, houd rekening met het volgende:

• OneSignal slaat geen e-mailadressen op die via de toestemming-popup in de browser zijn verzameld.

• Je hebt een technische koppeling nodig om e-mailadressen vanuit MailBlue goed door te geven aan OneSignal.

• Nieuwe OneSignal-apps worden niet ondersteund op platformen als Blogger, Webflow, Squarespace, Wix en HTTP-sites (wegens gebrek aan service worker-ondersteuning)

Wat heb je nodig voor de koppeling?

Zorg dat je de volgende zaken op orde hebt, zowel aan MailBlue- als OneSignal-kant:

• Een actief MailBlue-account met toegang tot automatiseringen

• Een geconfigureerd OneSignal-account

• Een webapplicatie ingesteld in OneSignal

• (Optioneel) Pushmeldingssjablonen (voor iOS, Android en/of web)

• Een API Authentication Key in OneSignal – zowel op accountniveau als appniveau. Raadpleeg de OneSignal-documentatie over API-keys.

• Een External ID-veld in OneSignal – hierin komt bijvoorbeeld het e-mailadres terecht

💡 Tip: Meldt iemand zich aan via een MailBlue-formulier? Dan wordt het e-mailadres automatisch doorgestuurd naar OneSignal. Je hoeft dit dus niet handmatig in te stellen.

Hoe kan ik de koppeling gebruiken?

De koppeling gebruik je volledig binnen je automatiseringen in MailBlue. Je kunt kiezen uit twee acties:

Gebruik “Assign a tag” als je werkt met OneSignal-segmenten. Gebruik “Send push notification” als je direct vanuit je automatisering een melding wilt verzending. 

OneSignal koppelen aan MailBlue

De koppeling stel je niet in via 'Apps' of 'Integraties', maar rechtstreeks binnen je automatisering. Wanneer je een OneSignal-actie toevoegt, wordt gevraagd om je User 'Auth key / API Authentication Key' in te voeren. Je vindt deze in OneSignal via 'Organization → Keys & IDs'.

Het kan zo zijn dat je de API Key eerst nog moet aanmaken – sla deze dan op in een extern bestand. Je krijgt het namelijk niet nogmaals te zien. 

Nadat je OneSignal met MailBlue hebt verbonden, kun je het OneSignal-account selecteren bij iedere actie binnen je automatiseringen.

Een tag doorzetten naar OneSignal

Deze actie stuurt een tag naar OneSignal, zoals type = onboarding. Op basis van deze tag kan OneSignal het contact opnemen in een segment en daar een pushmelding aan koppelen.

Je kunt de volgende stappen volgen om de actie te gebruiken:

1. Maak een segment aan in OneSignal op basis van een User Tag

2. Stel het bericht in dat je naar dit segment wilt versturen

3. Open je automatisering in MailBlue

4. Voeg de actie 'OneSignal - Assign a tag' toe, en vul de gewenste informatie in:

   • De app die je in OneSignal wilt gebruiken
   • De API Key van deze specifieke app (niet op accountniveau)
   • De data tag key die je wilt toewijzen
   • De data tag value die je wilt toewijzen
     
     Voor meer informatie, kun je de hulpdocumentatie van OneSignal raadplegen over segmentatie, in-app messaging en data tags. 
     
     
5. Klik op 'Afronden'

6. Rond de rest van je automatisering af en zet deze op 'Actief'

Wanneer een contact deze actie doorloopt, wordt het tag-sleutel/waarde-paar doorgestuurd naar OneSignal. De tag wordt automatisch aangemaakt of bijgewerkt.

Om het sleutel/waarde-paar van de tag te vinden, log je in op je OneSignal-account en ga je naar 'Doelgroep → Gebruikers'.

Een pushmelding versturen

Deze actie verstuurt direct een pushmelding naar het apparaat van je contact zodra hij of zij dit punt in de automatisering bereikt.

Je kunt de volgende stappen volgen om de actie te gebruiken:

1. Open je automatisering in MailBlue

2. Voeg de actie 'OneSignal - Assign a tag' toe, en vul de gewenste informatie in:

   • De app die je in OneSignal wilt gebruiken
   • De API Key van deze specifieke app (niet op accountniveau)
   • Het pushmelding-sjabloon die je wilt gebruiken (aanbevolen). Je kunt via de overige opties handmatig je pushmelding aanmaken als je geen sjabloon wilt gebruiken.
     
     

     🚨 Let op: MailBlue-personalisatietags werken niet met OneSignal-sjablonen.

3. Klik op 'Afronden'.

4. Rond de rest van je automatisering af en zet deze op 'Actief'

Zodra de actie wordt bereikt, ontvangt het contact direct een pushmelding. In het contactprofiel in MailBlue zie je dat het automatiseringstraject is voltooid.

Hoe kan ik inzicht krijgen in de prestaties van mijn pushmeldingen?

Bekijk de resultaten van je pushmeldingen in je OneSignal-dashboard. Wil je in MailBlue zien wie de automatisering heeft doorlopen? Gebruik dan een geavanceerde zoekopdracht op automatiseringsniveau.

💡 Tip: Wil je segmenteren op basis van contacten die deze actie hebben doorlopen? Voeg dan direct na de OneSignal-actie een extra tag toe in je automatisering.

var userEmail = document.getElementById("email").value;
OneSignalDeferred.push(async function(OneSignal) {
    await OneSignal.User.addEmail(userEmail);
    await OneSignal.login(userEmail);
});