KEPLIN Docs

Varsler & innstillinger Varsler

Varsler

Hvordan en app varsler dem som bruker den — kanalen på skjermen, kanalen på e-post, og bjellen i navigasjonslinjen.

En forretningsapplikasjon trenger å varsle folk: en mulighet har byttet fase, en forespørsel har kommet til godkjenning, en rapport er klar. I Keplin gjøres det gjennom to kanaler, som finnes i alle apper og verken opprettes eller slettes: den ene leverer på skjermen, til den som bruker appen i øyeblikket; den andre leverer på e-post, til den som ikke gjør det.

De slås på og av i Appinnstillinger, seksjonen Varsler:

  1. Åpne appen.
  2. Klikk på ikonet Appinnstillinger øverst i sidetreet.
  3. I innstillingstreet, under gruppen Applikasjon, velger du Varsler.

Seksjonen Varsler i appinnstillingene: de to faste kanalene — i appen og på e-post — og SMTP-en for utsending.
Seksjonen Varsler i appinnstillingene: de to faste kanalene — i appen og på e-post — og SMTP-en for utsending.

Varsler i appen

Den første kanalen leverer inne i applikasjonen. Den har én enkelt bryter, Kanalen er aktiv, og oppførselen er denne:

  • den som har appen åpen, får varselet i øyeblikket, uten å laste noe på nytt;
  • den som ikke har det, får det ved neste pålogging — meldingen blir liggende og går ikke tapt;
  • de uleste meldingene vises i bjellen i navigasjonslinjen til appen.

Nota

Den umiddelbare leveringen avhenger av bryteren Varsler i sanntid i Innstillinger for plattformen. Med den avslått går ingenting tapt: varslene lagres fortsatt og dukker opp ved neste besøk, bare uten «nå»-et.

Varsler på e-post

Den andre kanalen sender e-post, og den tjener to ting: varslene som logikken i appen sender på e-post, og gjenoppretting av passord for brukerne av appen. Begge går ut gjennom utsendingsserveren som konfigureres rett under, i samme seksjon.

Fyll ut blokken SMTP:

Felt Hva det er
Vert Adressen til e-postserveren.
Port 465 med sikker tilkobling, 587 for STARTTLS.
Sikker tilkobling (TLS) Slå på for SMTPS (port 465); av for STARTTLS (port 587).
Bruker og Passord Legitimasjonen for utsending. Passordet lagres kryptert og vises aldri igjen på skjermen — å la det stå tomt betyr «behold det som er der».
Avsenderadresse (from) Avsenderen mottakeren ser.

SMTP-blokken til e-postkanalen: server, port, sikker tilkobling, legitimasjon og avsenderadresse.
SMTP-blokken til e-postkanalen: server, port, sikker tilkobling, legitimasjon og avsenderadresse.

Atenção

Uten e-postkanalen aktiv og med SMTP-en utfylt virker ikke gjenoppretting av passord for brukerne av appen — forespørselen tas imot, men e-posten går aldri ut.

Nota

Denne e-postserveren er appens, og den er en annen enn e-posten for plattformens varsler (den konfigureres under Innstillinger og brukes til infrastrukturalarmer). Hver app kan sende gjennom serveren til sin egen kunde uten at det endrer noe i installasjonen.

Sende et varsel

Varslene går ut fra logikken i appen — fra et skript eller et trinn i en arbeidsflyt. I skriptene finnes to verktøy, ett per kanal (se SDK-en for skript).

På skjermen, med notify.send. Mottakerne er brukere av appen: users tar imot brukernavn, og roles utvides til alle medlemmene av en rolle.

r = notify.send(
    "Mulighet vunnet",
    subtitle="Câmara Municipal de Aveiro — 18.400 €",
    body="Tilbudet er akseptert. Kontrakten går videre til signering.",
    users=["ana.rocha"],
    roles=["direcao"],
    data={"url": "/oportunidades/42"},
)
# r = {"recipients": 4, "delivered": 2}

delivered teller dem som var tilkoblet og fikk det med en gang; resten får det når de logger inn. data reiser med meldingen — det er den som gjør at et klikk på varselet tar personen til rett sted i appen.

På e-post, med notify.email. Her tar to imot frie adresser, og users/roles løses opp til e-postadressen til brukerne av appen.

r = notify.email(
    "Oppsummering av pipelinen",
    to=None,
    users=None,
    roles=["direcao"],
    text="12 muligheter står åpne, 3 lukker denne uken.",
    html=None,
)
# r = {"accepted": ["ana.rocha@exemplo.pt"], "skipped": []}

skipped sier hvem som falt utenfor fordi e-postfeltet på kortet deres var tomt — den listen er verdt et blikk når noen klager over å ikke få noe.

Bjellen i applinjen

Bjellen som viser de uleste meldingene, dukker ikke opp av seg selv: den er en menytype som legges til i navigasjonseditoren til appen, med automatisk telling av de uleste. Den er beskrevet i Navigasjonen i appen.

Menyen Varsler i navigasjonseditoren — det er den som setter bjellen til varselsenteret i applinjen.
Menyen Varsler i navigasjonseditoren — det er den som setter bjellen til varselsenteret i applinjen.

Hvor lenge de oppbevares

Meldingene hoper seg opp. Hver app bestemmer hvor lenge historikken oppbevares i seksjonen Rotasjon av oppføringer i appinnstillingene — den samme der oppbevaringen av aktivitetsloggene angis. Null dager betyr «behold alltid».

Vanlige spørsmål

Personen fikk ingenting på skjermen. Sjekk tre ting, i denne rekkefølgen: kanalen Varsler i appen er aktiv i appinnstillingene; bryteren Varsler i sanntid er slått på i Innstillinger for plattformen; og personen har en åpen økt i appen. Uten sanntid går meldingen ikke tapt — den kommer bare senere.

Kan jeg varsle alle på én gang? Ja: i stedet for navn sender du roles med rollen du vil nå. Den som er i den rollen når det sendes, får varselet.

Dukker varslene fra én app opp i en annen? Nei. Meldingene og historikken hører til appen de ble laget i, og mottakerne er brukere av den appen.

Kan jeg lage flere kanaler enn disse to? Nei. Kanalene er faste, og det er med vilje: det som endrer seg fra varsel til varsel, er mottakeren og teksten, ikke rørleggingen. For å skille temaer bruker du rollene til mottakerne.