Meldingen

Een zakelijke applicatie moet mensen waarschuwen: een opportuniteit is van fase veranderd, er is een aanvraag ter goedkeuring binnengekomen, een rapport is klaar. In Keplin gebeurt dat via twee kanalen, die in elke app bestaan en die u niet aanmaakt en niet verwijdert: het ene levert op het scherm, aan wie de app op dat moment gebruikt; het andere levert per e-mail, aan wie dat niet doet.

U zet ze aan of uit in de Instellingen van de app, sectie Meldingen:

1. Open de app.
2. Klik op het pictogram Instellingen van de app, boven aan de boomstructuur in de zijbalk.
3. Kies in de boom met instellingen, binnen de groep Applicatie, voor Meldingen.

#Meldingen in de app

Het eerste kanaal levert binnen de applicatie. Het heeft één enkele schakelaar, Kanaal actief, en het gedrag is dit:

• wie de app open heeft staan, ontvangt de melding op het moment zelf, zonder iets te herladen;
• wie dat niet heeft, ontvangt haar bij de volgende aanmelding — het bericht blijft bewaard en gaat niet verloren;
• de ongelezen berichten verschijnen in de bel van de navigatiebalk van de app.

#Meldingen per e-mail

Het tweede kanaal verstuurt e-mail, en het dient twee dingen: de meldingen die de logica van de app per e-mail verstuurt, en het wachtwoordherstel van de gebruikers van de app. Beide gaan uit via de verzendserver die direct daaronder in dezelfde sectie is ingesteld.

Vul het blok SMTP in:

Veld	Wat het is
Host	Het adres van de e-mailserver.
Poort	465 met een beveiligde verbinding, 587 voor STARTTLS.
Beveiligde verbinding (TLS)	Inschakelen voor SMTPS (poort 465); uitschakelen voor STARTTLS (poort 587).
Gebruiker en Wachtwoord	De inloggegevens voor het versturen. Het wachtwoord wordt versleuteld opgeslagen en komt nooit terug op het scherm — het leeg laten betekent "het huidige behouden".
Afzendadres (from)	De afzender die verschijnt bij wie de e-mail ontvangt.

#Een melding versturen

De meldingen vertrekken vanuit de logica van de app — vanuit een script of vanuit een stap van een workflow. In de scripts zijn er twee gereedschappen, één per kanaal (zie SDK van de scripts).

Op het scherm, met notify.send. De ontvangers zijn gebruikers van de app: users krijgt gebruikersnamen, en roles breidt uit naar alle leden van een rol.

r = notify.send(
    "Opportuniteit gewonnen",
    subtitle="Câmara Municipal de Aveiro — 18.400 €",
    body="Het voorstel is aanvaard. Het contract gaat naar de ondertekening.",
    users=["ana.rocha"],
    roles=["direcao"],
    data={"url": "/oportunidades/42"},
)
# r = {"recipients": 4, "delivered": 2}

De delivered telt wie verbonden was en de melding meteen ontving; de rest ontvangt haar zodra ze binnenkomen. De data reist met het bericht mee — dat is wat het mogelijk maakt dat klikken op de melding de persoon naar de juiste plek in de app brengt.

Per e-mail, met notify.email. Hier accepteert to vrije adressen, en users/roles worden opgelost naar het e-mailadres van de gebruikers van de app.

r = notify.email(
    "Samenvatting van de pipeline",
    to=None,
    users=None,
    roles=["direcao"],
    text="Er staan 12 opportuniteiten open, 3 sluiten deze week.",
    html=None,
)
# r = {"accepted": ["ana.rocha@exemplo.pt"], "skipped": []}

De skipped zegt wie buiten de boot viel omdat er geen e-mailadres op de fiche was ingevuld — het is de moeite waard naar die lijst te kijken wanneer iemand klaagt dat hij niets ontvangt.

#De bel in de balk van de app

De bel die de ongelezen berichten toont, verschijnt niet vanzelf: het is een menusoort die u toevoegt in de navigatie-editor van de app, met een automatische telling van de ongelezen berichten. Zij wordt beschreven in Navigatie van de app.

#Hoe lang ze bewaard blijven

De berichten stapelen zich op. Elke app bepaalt in de sectie Rotatie van registraties van de instellingen van de app hoe lang zij de geschiedenis bewaart — dezelfde sectie waar de bewaartermijn van de activiteitsregistraties wordt vastgelegd. Nul dagen betekent "voor altijd bewaren".

#Veelgestelde vragen

De persoon heeft niets op het scherm ontvangen. Controleer drie dingen, in deze volgorde: het kanaal Meldingen in de app staat actief in de instellingen van de app; de schakelaar Meldingen in real time staat aan in de Instellingen van het platform; en de persoon is aangemeld bij de app. Zonder real time gaat het bericht niet verloren — het komt alleen later aan.

Kan ik iedereen in één keer waarschuwen? Ja: geef in plaats van namen roles mee met de rol die u wilt. Wie op het moment van versturen in die rol zit, ontvangt de melding.

Verschijnen de meldingen van de ene app in de andere? Nee. De berichten en de geschiedenis horen bij de app waar ze zijn aangemaakt, en de ontvangers zijn gebruikers van die app.

Kan ik meer kanalen aanmaken dan deze twee? Nee. De kanalen liggen vast, en dat is met opzet: wat van melding tot melding verschilt, is de ontvanger en de tekst, niet de leidingen. Gebruik de rollen van de ontvangers om onderwerpen te scheiden.