Koppelprofiel Email: verschil tussen versies

Uit ZaaksysteemWiki
Ga naar: navigatie, zoeken
(Instellingen)
(Pop3Mailbox)
Regel 91: Regel 91:
 
Wanneer bij de uitgaande mailconfiguratie gekozen wordt om gebruik te maken van een externe mailserver zullen antwoordmailtjes van klanten in de externe mailbox terecht komen. Deze koppeling stelt zaaksysteem in staat deze mailbox uit te lezen en de binnengekomen e-mails te verwerken alsof ze aan zaaksysteem verstuurd zijn.
 
Wanneer bij de uitgaande mailconfiguratie gekozen wordt om gebruik te maken van een externe mailserver zullen antwoordmailtjes van klanten in de externe mailbox terecht komen. Deze koppeling stelt zaaksysteem in staat deze mailbox uit te lezen en de binnengekomen e-mails te verwerken alsof ze aan zaaksysteem verstuurd zijn.
  
 +
Bij het ophalen van de mails zal zaaksysteem eerst kijken of de header van de e-mail een prefix bevat zoals geconfigureerd in de uitgaande mailkoppeling. Zo ja: Dan zal zaaksysteem deze mail als dusdanig verwerken en aan de bijbehorende zaak toevoegen. Zo nee: Dan zal zaaksysteem de mail verwerken als een mail voor de 'Inkomende mailafhandeling'.
 
=== Instellingen ===
 
=== Instellingen ===
  

Versie van 8 aug 2016 om 04:59

Algemeen

Er zijn verschillende koppelprofielen beschikbaar die afzonderlijk of in combinatie gebruikt kunnen worden voor het versturen en/of ontvangen van e-mails met zaaksysteem:



Uitgaande mailconfiguratie

Het zaaksysteem biedt de mogelijkheid om uw uitgaande email te configureren. Dat wil zeggen dat u in staat bent aan te geven welk emailadres en welke benaming u gebruikt bij uitgaande emails.

Instellingen

Met deze koppeling kunnen de volgende gegevens zaaksysteembreed ingesteld worden voor de uitgaande mail:
Titel Voorbeeld Omschrijving
Verzendadres info@gemeente.nl Het e-mailadres dat als verzendadres wordt getoond aan de ontvanger.
Verzendnaam Gemeentenaam De naam die als verzendnaam wordt getoond aan de ontvanger.
Onderwerpprefix Prefix Een prefix die voor de random string komt te staan.
Emailgrootte (in MB) 10 (aanbevolen) De ontvangende partij heeft een limiet voor de maximale grote die binnenkomende e-mails mogen hebben. Het is daarom belangrijk om de limiet voor uitgaande mails lager in te stellen dan hun binnenkomende limiet, zodat gewaarborgd is dat e-mails die (succesvol) vanuit zaaksysteem verstuurd worden ook daadwerkelijk geaccepteerd(/ontvangen) worden door de ontvangende partij.

Let op: Een bestand zal als e-mailbijlage groter zijn. Het verschilt per bestand(stype), maar de e-mailbijlage is rond de 33% groter dan het oorspronkelijke bestand. Zie voor meer informatie: Wikipedia: Email attachements - Size limits.

Let op: De maximale grote voor een e-mail die vanuit Zaaksysteem verstuurd kan worden is 20 MB, ongeacht deze instelling.

Externe mailserver gebruiken Gebruik de opgegeven (SMTP) mailserver voor uitgaande email, in plaats van de standaard-server die Zaaksysteem biedt.
Hostname van externe mailserver smtp.gmail.com De hostname van de SMTP-server die Zaaksysteem zal gebruiken voor het verzenden van email. Zaaksysteem gebruikt hiervoor het Submission-protocol (RFC 6409).
Poort van externe mailserver 587 De poort waarop de SMTP-server bereikt kan worden
Gebruikersnaam voor externe mailserver voorbeeld@gmail.com De gebruikersnaam die Zaaksysteem zal gebruiken om aan te melden bij de externe mailserver
Wachtwoorde voor externe mailserver Welkom01! Het wachtwoord dat Zaaksysteem zal gebruiken om aan te melden bij de externe mailserver

Let op: Als er specifieke verzendgegevens zijn opgegeven in een e-mailsjabloon dan krijgen die prioriteit.

Voorbeeldmail

Forward inregelen bij IT-afdeling

Wanneer u een lokaal emailadres (bijvoorbeeldiets@gemeentenaam.nl) wilt gebruiken waarop een antwoord naar het zaaksysteem gestuurd kan worden, dan dient u ook een forward in te regelen naar: iets@omgevingsnaam.api.zaaksysteem.nl. Dit zorgt ervoor dat het bericht ook daadwerkelijk bij het zaaksysteem afgeleverd wordt. Een forward van emailadressen kan door uw IT-afdeling ingeregeld worden.

SPF records

Voor wanneer enkel met het zaaksysteem platform gemaild moet worden:

gemeente.nl. IN TXT "v=spf1 ?include:spf.zaaksysteem.nl -all"

Voor wanneer er met andere mailservers gemaild moet worden:

gemeente.nl. IN TXT "v=spf1 a:mail.gemeente.nl mx mx:some.othermailer.nl ?include:spf.zaaksysteem.nl -all"

Zie voor meer informatie: Sender Policy Framework

Mail ontvangst (random string)

Als deze koppeling actief is wordt er een random string toegevoegd [Prefix 1458-ae34dc] <onderwerp>. Op deze manier kan een mail die beantwoord wordt door zaaksysteem herkend worden en als Contactmoment aan de timeline van de zaak toegevoegd worden. De mail wordt tevens als PDF-bestand toegevoegd aan het tabblad documenten, waar ook eventuele bijlagen geplaatst worden.

Het is belangrijk om te weten dat de emails die naar het zaaksysteem gestuurd worden ook gecontroleerd worden op SPAM en Virussen. Wanneer een mail niet door deze controle komt zal de informatie niet in het zaaksysteem komen.

Eerste keer inrichten

Wanneer de emailkoppeling voor het eerst ingericht wordt dan moet er een kleine wijziging in uw configuratie gemaakt worden door Mintlab. Neem dan ook contact op met Mintlab wanneer u deze koppeling voor het eerst gaan inrichten.



Pop3Mailbox

Wanneer bij de uitgaande mailconfiguratie gekozen wordt om gebruik te maken van een externe mailserver zullen antwoordmailtjes van klanten in de externe mailbox terecht komen. Deze koppeling stelt zaaksysteem in staat deze mailbox uit te lezen en de binnengekomen e-mails te verwerken alsof ze aan zaaksysteem verstuurd zijn.

Bij het ophalen van de mails zal zaaksysteem eerst kijken of de header van de e-mail een prefix bevat zoals geconfigureerd in de uitgaande mailkoppeling. Zo ja: Dan zal zaaksysteem deze mail als dusdanig verwerken en aan de bijbehorende zaak toevoegen. Zo nee: Dan zal zaaksysteem de mail verwerken als een mail voor de 'Inkomende mailafhandeling'.

Instellingen

Instellingen Voorbeeld Omschrijving
Protocol voor externe mailbox De opties zijn:
  • POP3S (POP3 over TLS)
  • POP3 + STLS (RFC2595)
  • Protocol dat gebruikt wordt om de externe mailbox te benaderen.
  • POP3S: Gebruikt het POP3-protocol over een reguliere TLS-beveiligde verbinding.
  • POP3 + STLS: Gebruikt het POP3-protocol in combinatie met STLS om de verbinding te beveiligen (RFC 2595).
  • Hostname pop.gmail.com Hostname van de mailserver waar de mailbox te vinden is.
    Poort 995 Poort waarop de mailserver te bereiken is. Standaard "110" voor POP3 en "995" voor POP3S.
    Gebruikersnaam zaaksysteemtest@gmail.com Gebruikersnaam waarmee ingelogd wordt op de mailbox.
    Wachtwoord Welkom01! Wachtwoord waarmee ingelogd wordt op de mailbox.

    Let op: De externe mailserver moet geconfigureerd zijn om POP3 toe te staan.



    Inkomende mailafhandeling

    Met deze koppeling kunnen op basis van e-mails die naar een zaaksysteemadres gestuurd worden nieuwe zaken gestart worden of bijlagen in de algemene documentintake geplaatst worden. Per emailadres/zaaktype moet een profiel aangemaakt worden welke een duidelijk herkenbare naam krijgen. Let op, het is handig als u eerst een uitgaande mailconfiguratie aanmaakt.

    Instellingen

    Instelling Voorbeeld Omschrijving
    E-mailadres vergunningen@mijn.gemeente.nl Het e-mailadres waar de klant zijn e-mails naar toe stuurt
    Type interface
  • Online omgevingsloket (OLO)
  • Documentintake
  • Zaaktype
  • Zaaktype Het zaaktype waarvan er zaken aangemaakt moeten worden.

    Forward inregelen bij IT-afdeling

    Wanneer u een lokaal emailadres (bijvoorbeeld vergunningen@mijn.gemeente.nl) wilt gebruiken waarop een antwoord naar het zaaksysteem gestuurd kan worden, dan dient u ook een forward in te regelen naar: vergunningen@omgevingsnaam.api.zaaksysteem.nl. Dit zorgt ervoor dat het bericht ook daadwerkelijk bij het zaaksysteem afgeleverd wordt. Een forward van emailadressen kan door uw IT-afdeling ingeregeld worden.

    Omgevingsloket

    Het omgevingsloket kent twee stappen van inrichten. Eerst richt je het koppelprofiel omgevingsloket in, zorg er voor dat deze koppeling werkt. Vervolgens maak je, zoals op deze pagina beschreven ook het profiel inkomende email voor het omgevingsloket aan. Wanneer de optie 'omgevingsloket' gekozen is hoeft er geen zaaktype gekozen te worden.

    Zie ook: Koppelprofiel Omgevingsloket

    Documentintake

    Wanneer de optie 'documentintake' gekozen is hoeft er geen zaaktype gekozen te worden. In dit geval worden enkel de bijlagen van de ontvangen mail in de documentintake geplaatst.

    Zaaktype

    Als een zaaktype gekozen is kunnen de kenmerken gekoppeld worden. Deze kenmerken worden dan ingevuld bij het aanmaken van de zaak.

    Titel Kenmerk type
    subject tekstveld
    from tekstveld
    body groot tekstveld

    Eerste keer inrichten

    Wanneer de emailkoppeling voor het eerst ingericht wordt dan moet er een kleine wijziging in uw configuratie gemaakt worden door Mintlab. Neem dan ook contact op met Mintlab wanneer u deze koppeling voor het eerst gaan inrichten.

    Instellingen

    Email



    Ingeplande e-mail

    Deze 'koppeling' moet aanwezig zijn voor het Inplannen van e-mails