Realmens e-post och e-postmallar

Realmen skickar egen e-post: koder för inloggning och återställning, inbjudningar, aviseringar och fakturor. Den här sidan handlar om den e-posten: var den går ut, hur du skickar den genom realmens egen e-postserver och mallarna som varje sådant mejl görs av. E-post för dina kunder (domäner, brevlådor, webbmejl) finns i E-post.

Var realmens e-post går ut

Realmen provar i den här ordningen och använder det första som är redo:

1. En e-postkanal under Manager › Aviseringar: en påslagen leverantör som vägen mail går till, till exempel den medföljande leverantören E-post (SMTP).
2. E-postservern från installationsguiden, om en angavs där.

Ett mejl som kanalen nekar skickas aldrig på något annat sätt och försvinner aldrig i tysthet. Den som bad om det får veta att det misslyckades (en inloggningskod som inte kunde skickas säger det), och varje driftansvarig får ett meddelande per kanal och tidsfönster, som öppnar Aviseringar.

Skicka genom realmens egen e-postserver

När realmen kör e-post åt sina kunder kan dess egen e-post gå genom samma server. E-posten går då ut från en vanlig brevlåda i realmens domän, signerad och kontrollerad med domänens DKIM, SPF och DMARC som all annan.

Innan du börjar måste realmens e-postserver nås på sina e-postportar: under Nätverk › Lastbalanserare en lastbalanserare på e-postserverns app med dess portar (25, 465, 587, 993 och de andra), utgående trafik tillåten för e-postappens nätverk, och ingen nätverkspolicy som spärrar utgående SMTP för driftorganisationen. Port 25 måste vara öppen utåt hos din leverantör, och den omvända DNS-posten för lastbalanserarens adress måste peka på e-postservern.

1. Domänen. Lägg till realmens domän (till exempel moln.exempel.se) under E-post › Domäner, som driftorganisationen. Den måste vara verifierad för den organisationen. Om realmens namnserver har domänen publiceras dess MX-, SPF-, DKIM- och DMARC-poster åt dig; annars listar domänens sida dem så att du kan lägga in dem.
2. Brevlådan. Lägg till no-reply@<realmens domän> under E-post › Brevlådor. Skapa ett applösenord på dess rad med etiketten notices. Kopiera det: det visas bara en gång.
3. Kanalen. Lägg till leverantören E-post (SMTP) under Manager › Aviseringar och fyll i:

   Fält	Värde
   E-postserver	mail.<realmens domän>
   Port	587
   Kryptering	starttls
   Användarnamn	no-reply@<realmens domän>
   Lösenord	applösenordet
   Avsändaradress	no-reply@<realmens domän>
   Avsändarnamn	till exempel ditt företags namn

   
   Slå på den och slå på dess väg mail.
4. Testa. Skicka ett test via den. Logga sedan ut, be om en inloggningskod till en adress utanför realmen och kontrollera att den kom fram med godkänd SPF och DKIM.
5. Reserven. Ange samma server och användare med ett andra applösenord i installationsguidens e-poststeg, eller töm det. Lämna inte kvar ett gammalt relä där: det används så fort kanalen inte är redo.

Applösenordet sparas förseglat i leverantörens inställningar och visas aldrig igen. För att byta det skapar du ett nytt på brevlådan, klistrar in det i leverantören och återkallar sedan det gamla. Att återkalla det påverkar inget annat på brevlådan.

E-postmallar

Varje mejl som plattformen skickar är en mall: en inloggningskod, en återställning av lösenord, en inbjudan till en organisation, en inbjudan till plattformen, en avisering via e-post, den dagliga sammanfattningen, en faktura. Varje modul har med sina egna, på engelska och svenska, och du redigerar alla på ett ställe: Manager › E-postmallar.

• Listan visar varje malls titel, dess nyckel (till exempel onboarding.reset eller billing.invoice) och var texten kommer från: standardtexten, miljöns text eller en återförsäljares.
• Öppna en mall för att redigera den per språk: Ämne, Ren text och, om du vill, en HTML-version. Variablerna den får använda listas bredvid, med vad var och en innehåller, och en förhandsvisning visar mallen ifylld med exempel.
• Spara behåller din text. Återställ standard tar bort den, och den medföljande texten gäller igen. Skicka ett test till mig mejlar den till din egen adress.

Mallspråket

En variabel är dess namn inom klamrar: {link}, {code}, {org}. En pluralform väljs efter ett tal:

{days, plural, =0 {i dag} one {om # dag} other {om # dagar}}

Mer finns inte: ingen logik, inga inkluderingar, inget som körs som kod. En klammer som inte är någon av de två formerna är vanlig text, så CSS i HTML-versionen fungerar. I HTML-versionen kodas varje värde säkert. En mall som använder en variabel som mallen inte har går inte att spara.

Layout och återförsäljare

• notices.layout är ramen som varje HTML-mejl läggs i. Den måste behålla {content} och får använda {signature} (avsändarens namn och supportrader). En mall utan HTML-version skickas som ren text.
• En återförsäljare redigerar mallar för sina egna kunder på organisationens sida, i samma redigerare. Kunderna får återförsäljarens text; alla andra behåller realmens. En återförsäljare ser aldrig en annan återförsäljares mallar.
• Språk: ett mejl går ut på personens språk, annars realmens, annars engelska. För varje språk kommer återförsäljarens text först, sedan realmens, sedan standardtexten.

När en mall går sönder

Om en moduluppdatering tar bort en variabel som din text använder går texten inte längre att fylla i. Mejlet går då ut med nästa text i tur (realmens eller standardtexten), mallen markeras Trasig i redigeraren och den som sparade den får ett meddelande. Ingen missar ett mejl på grund av det. Spara eller återställ mallen för att ta bort markeringen.

Nästa steg

• E-post
• Registrering och inbjudningar