Mobiele pushnotificaties

Met mobiele pushnotificaties kun je berichten versturen naar gebruikers die zich hebben aangemeld voor het ontvangen van notificaties via een mobiele applicatie.

Mobiele pushnotificaties maken het mogelijk om gebruikers te bereiken op hun iOS- of Android-apparaat, ook wanneer de applicatie niet geopend is.

Mobiele pushnotificaties worden afgeleverd via Google Firebase Cloud Messaging (FCM). Deze dienst zorgt voor de aflevering van pushnotificaties aan iOS- en Android-apparaten en geeft voor iedere app-installatie een uniek apparaat-token uit. Copernica gebruikt deze tokens om pushnotificaties naar de juiste apparaten te versturen.

Pushnotificaties versturen

Je kunt mobiele pushnotificaties op verschillende manieren versturen:

• Naar een individueel profiel: Verstuur handmatig een notificatie naar één specifieke ontvanger.
• Naar een selectie: Verstuur een notificatie naar een groep profielen tegelijk.
• Vanuit een opvolgactie: Verstuur automatisch een notificatie als reactie op een gebeurtenis of profielactiviteit.

Apparaten registreren

Voordat Copernica een mobiele pushnotificatie kan versturen, moet het mobiele apparaat worden geregistreerd.

Wanneer een gebruiker toestemming geeft voor het ontvangen van pushnotificaties, ontvangt de mobiele applicatie een apparaat-token van Google Firebase. Dit token identificeert een specifieke app-installatie op een specifiek apparaat.

Om pushnotificaties te kunnen versturen, moet dit apparaat-token worden opgeslagen als mobiel pushabonnement op een profiel of subprofiel binnen Copernica.

Copernica ondersteunt hiervoor twee integratiemodellen.

Via een eigen backend

Bij deze methode stuurt de mobiele applicatie het apparaat-token naar je eigen backend. Omdat de backend weet welke gebruiker is ingelogd, kan deze het apparaat direct koppelen aan het juiste profiel of subprofiel in Copernica.

De registratie verloopt als volgt:

1. De gebruiker geeft in de mobiele applicatie toestemming om push-notificaties te ontvangen.
2. De applicatie ontvangt een apparaat-token van Google Firebase.
3. De applicatie stuurt dit token naar je backend.
4. De backend bepaalt welk profiel of subprofiel bij de gebruiker hoort.
5. De backend maakt via de Copernica REST API een mobiel pushabonnement aan.

Hiervoor kunnen de volgende API-methodes worden gebruikt:

• POST /profile/{id}/push/mobilesubscriptions
• POST /subprofile/{id}/push/mobilesubscriptions

Het mobiele apparaat is daarna direct gekoppeld aan het juiste profiel of subprofiel en kan direct pushnotificaties ontvangen.

Een overzicht van alle beschikbare pushnotificatie-API-methodes vind je in de REST API-documentatie voor pushnotificaties.

Rechtstreeks vanuit de applicatie

Je kan een mobiele applicatie ook rechtstreeks bij Copernica registreren, zonder dat je een eigen backend hoeft te maken:

1. De gebruiker geeft in de mobiele applicatie toestemming om push-notificaties te ontvangen.
2. De applicatie ontvangt een apparaat-token van Google Firebase.
3. De applicatie stuurt dit token naar Copernica.
4. Via een opvolgactie bepaal je bij welke profiel de aanmelding hoort.

De applicatie verstuurt hiervoor een POST request naar:

https://mobilepush.copernica.com/v1/register?access_token={CopernicaFirebaseToken}

De CopernicaFirebaseToken wordt getoond wanneer een Google Firebase-project wordt aangemaakt binnen Copernica.

Het request moet worden verstuurd als application/x-www-form-urlencoded en bevat de volgende velden:

Voorbeeld:

fcm_token=...
os_type=ios
attributes[email]=henk.dewit@copernica.com
device_model=iPhone 17

Bij een succesvolle registratie wordt de volgende response teruggegeven:

{
    "status": "success",
    "message": "Hardware device registration event triggered successfully"
}

Na registratie maakt Copernica een Mobiele pushregistratie ontvangen-event aan.

Met een opvolgactie kan dit event worden verwerkt en aan een profiel worden gekoppeld.

Een veelgebruikte configuratie is:

1. Trigger: Mobiele pushregistratie ontvangen
2. Blok: Zoek naar een profiel/subprofiel
3. Voorwaarde: e-mailadres gelijk aan het meegestuurde e-mailadres, bijvoorbeeld email is gelijk aan {$event.attributes.email}
4. Blok: Push-inschrijven

Binnen de opvolgactie zijn de volgende gegevens beschikbaar:

{$event.deviceToken}
{$event.osType}
{$event.attributes.VELDNAAM}
{$event.attributes.customerId}

Welke velden onder attributes beschikbaar zijn, hangt af van de gegevens die door de applicatie zijn meegestuurd, bijvoorbeeld {$event.attributes.email} of {$event.attributes.customerId}

Firebase-project koppelen

Voordat Copernica pushnotificaties kan versturen, moet minimaal één Google Firebase-project aan het account zijn gekoppeld.

Een Firebase-project kan worden toegevoegd via Google Firebase-projecten in de configuratie-module.

Bij het toevoegen van een project upload je een serviceaccountbestand dat vanuit Google Firebase is gegenereerd.

Je kunt dit bestand downloaden in je Firebase Console via 'Projectinstellingen -> Serviceaccounts -> Firebase Admin SDK -> Nieuwe privésleutel genereren'.

Copernica gebruikt deze gegevens om namens jouw applicatie pushnotificaties te versturen.