Hoe verstuur je een nieuwsbrief met Listmonk en Lettermint?

Wil je een nieuwsbrief versturen zonder afhankelijk te zijn van dure platformen? Listmonk is een gratis, open source nieuwsbrief tool die je zelf kunt hosten. Je bepaalt zelf waar je data staat, wie er toegang heeft en via welke infrastructuur je e-mails verstuurt. Koppel je Listmonk aan een Europese e-mail provider als Lettermint, dan blijft alles binnen Europa.

In deze handleiding leggen we stap voor stap uit hoe je Listmonk instelt, koppelt aan Lettermint en je eerste nieuwsbrief verstuurt.

Wat is Listmonk?

Listmonk is een gratis, open source tool voor het beheren van mailinglijsten en het versturen van nieuwsbrieven. Je installeert het op je eigen server of webhosting en hebt daarmee volledige controle over je abonneegegevens. Er zijn geen limieten op het aantal abonnees of campagnes, zoals je die misschien kent van betaalde diensten als Mailchimp of Brevo.

Listmonk biedt veel mogelijkheden die je ook bij betaalde diensten tegenkomt. Denk aan een visuele drag-and-drop e-mail editor, het filteren van abonnees, campagne statistieken en bevestiging per e-mail voordat iemand wordt toegevoegd aan je lijst (opt-in).

Omdat Listmonk zelf geen e-mails verstuurt, heb je een externe SMTP dienst nodig. En tadaa: sinds versie 6.1.0 zit Lettermint als preset in Listmonk. Je selecteert Lettermint, vult je API token in en kunt direct beginnen met versturen.

Wat heb je nodig?

De installatie van Listmonk verschilt per server en webhosting. Sommige hostingproviders bieden een one-click installatie aan, terwijl je bij andere handmatig met Docker aan de slag gaat. Daarom behandelen we de installatie van Listmonk zelf niet in dit artikel, maar wel de configuratie met Lettermint.

In deze handleiding gaan we ervan uit dat Listmonk draait en richten we ons op het configureren van Lettermint als SMTP dienst.

• Een werkende Listmonk installatie (minimaal versie 6.1.0)
• Een Lettermint account
• Een geverifieerd domein in Lettermint
• Een project met minimaal een Broadcast route
• SMTP ingeschakeld in je project (zie SMTP instellen in Lettermint)

Stap 1: Algemene instellingen configureren in Listmonk

Voordat je SMTP instelt, moet je eerst de algemene instellingen van Listmonk goed zetten. Hier stel je onder andere het afzenderadres van je nieuwsbrief in. Log in op je Listmonk dashboard en ga naar Settings → General.

Stel hier je standaard afzender in bij Default "from" email. Dit is de naam en het e-mailadres dat ontvangers zien in hun inbox. Je kunt dit opgeven in het formaat:

      Naam <e-mailadres>

    

Bijvoorbeeld: Lettermint <nieuwsbrief@example.co>

Het domein van dit e-mailadres moet toegevoegd en geverifieerd zijn in je Lettermint dashboard. Zonder geverifieerd domein worden je e-mails niet verzonden.

Stap 2: Lettermint instellen als SMTP dienst in Listmonk

Ga naar Settings → SMTP. Hier gaan we Lettermint instellen zodat Listmonk e-mails kan versturen. Zorg dat de toggle Enabled aan staat.

Onderaan de SMTP instellingen zie je een rij met presets voor bekende e-maildiensten. Klik op Lettermint. De host, poort, auth protocol en TLS worden automatisch voor je ingevuld. Je hoeft daardoor alleen nog de volgende gegevens in te vullen:

• Username: lettermint
• Password: Je API token uit je Lettermint project. Deze vind je onder de instellingen van je project in het tabblad API token.

De overige instellingen zoals Max. connections, Retries en Idle timeout kun je op de standaardwaarden laten staan.

Klik op Test connection om te controleren of de verbinding werkt. Krijg je een succesmelding? Dan is Lettermint gekoppeld.

Custom e-mail headers

Onderaan de SMTP pagina vind je een veld voor custom e-mail headers. Hiermee kun je extra headers meesturen bij elke e-mail die Listmonk verstuurt. Headers zijn onzichtbaar voor de ontvanger, maar geven e-mailprogramma's aanvullende informatie over je bericht.

Een veelgebruikte header is Reply-To. Hiermee bepaal je naar welk e-mailadres reacties worden gestuurd wanneer iemand op je nieuwsbrief antwoordt. Standaard gaat een reactie naar het afzenderadres, maar met Reply-To kun je dit aanpassen.

Vul het veld in als JSON, bijvoorbeeld:

      [
    {
        "Reply-To": "support@example.nl"
    }
]

    

Dit veld is optioneel. Heb je geen extra headers nodig? Dan kun je het leeg laten.

Stap 3: Bounce webhooks instellen

Wanneer een nieuwsbrief niet aankomt bij de ontvanger, is dat een bounce. Denk aan een e-mailadres dat niet meer bestaat of een volle inbox. Het is belangrijk dat Listmonk hiervan op de hoogte is, zodat je niet blijft mailen naar adressen die niet werken. Dat kan namelijk je verzendreputatie beschadigen, waardoor ook toekomstige nieuwsbrieven in de spamfolder belanden.

Lettermint kan deze bounce meldingen automatisch doorsturen naar Listmonk via een webhook. Om dit in te stellen begin je in Lettermint.

Webhook aanmaken in Lettermint

Ga in je Lettermint dashboard naar je project en open de broadcast route. Dit is dezelfde route die je eerder als standaard hebt ingesteld. Klik op het tabblad Webhooks en maak een nieuwe webhook aan.

Als endpoint URL vul je het adres van je Listmonk installatie in, gevolgd door /webhooks/service/lettermint. Dit pad is vast en wordt door Listmonk gebruikt om bounce meldingen van Lettermint te ontvangen.

Draait jouw Listmonk bijvoorbeeld op https://example.nl? Dan wordt de webhook URL:

      https://example.nl/webhooks/service/lettermint

    

Selecteer vervolgens de volgende events:

• Message Hard Bounces
• Message Soft Bounces
• Spam Complaint

Na het aanmaken ontvang je een webhook secret. Dit is een lange code die begint met whsec_. Kopieer deze, want die heb je zo nodig in Listmonk.

Via de knop Test Webhook in het Lettermint dashboard kun je controleren of de verbinding met Listmonk werkt voordat je e-mails gaat versturen.

Bounce instellingen in Listmonk

Ga in Listmonk naar Settings → Bounces. Schakel de volgende opties in:

1. Enable bounce processing: aan
2. Enable bounce webhooks: aan
3. Enable Lettermint: aan

Bij Lettermint Webhook Secret vul je het secret in dat je zojuist hebt gekopieerd uit je Lettermint dashboard. Klik op Save om de instellingen op te slaan.

Stap 4: Je eerste nieuwsbrief versturen

Alles is ingesteld. Listmonk stuurt nu e-mails via Lettermint en bounces worden automatisch afgehandeld. We gaan je eerste nieuwsbrief opzetten.

Lijst aanmaken

Ga in Listmonk naar Lists en klik op New. Geef je lijst een naam, bijvoorbeeld "Nieuwsbrief". Kies bij Type voor Public als je wilt dat mensen zich zelf kunnen aanmelden via een formulier op je website. Selecteer bij Opt-in de optie Double opt-in zodat nieuwe abonnees hun aanmelding eerst moeten bevestigen per e-mail.

Abonnees toevoegen

Onder Subscribers kun je handmatig abonnees toevoegen of een CSV bestand importeren. Heb je al een mailinglijst bij een andere dienst? Dan kun je deze exporteren als CSV en direct importeren in Listmonk.

Campagne aanmaken en versturen

Ga naar Campaigns en klik op New. Vul een onderwerp in en selecteer de lijst die je zojuist hebt aangemaakt.

Listmonk biedt meerdere manieren om je e-mail op te maken. De meest voorkomende zijn:

• Plain text: gewone tekst zonder opmaak
• HTML: voor wie zelf de code wil schrijven
• Visual (Drag & Drop): een visuele editor waarmee je blokken kunt slepen om je nieuwsbrief op te bouwen

Wil je hetzelfde ontwerp vaker gebruiken? Maak dan een template aan onder Campaigns → Templates. Zo hoef je niet elke keer opnieuw te beginnen en blijft je nieuwsbrief consistent.

Ziet alles er goed uit? Klik dan op Start campaign. Listmonk verstuurt je nieuwsbrief via Lettermint naar al je abonnees.

Conclusie

Listmonk in combinatie met Lettermint is een prima alternatief voor dure newsletter tools. Listmonk regelt het beheer van je abonnees en campagnes, terwijl Lettermint de aflevering van je e-mails verzorgt via Europese infrastructuur.

Wil je meer weten over e-mailbezorging en hoe je voorkomt dat je nieuwsbrieven in de spamfolder belanden? Lees dan ons artikel over waarom e-mails in spam belanden en hoe je dit voorkomt.