Documentatie

SMTP API configureren

Met de SMTP API verstuur je e-mails vanuit je applicatie, mailserver of e-mailclient via SMTPeter. Hiervoor maak je SMTP-inloggegevens aan en configureer je een beveiligde SMTP-verbinding.

In dit artikel lees je hoe je de verbinding instelt, een testmail verstuurt en eventuele problemen oplost.

Voordat je begint

Om e-mail via SMTPeter te versturen, heb je het volgende nodig:

  • Een SMTPeter-account waarvan de vetting is goedgekeurd.
  • Een gevalideerd Senderdomain waarmee je e-mail mag versturen.
  • SMTP-inloggegevens voor je applicatie of e-mailclient.

Heb je nog geen gevalideerd Senderdomain? Lees dan hoe je een Senderdomain configureert en de DNS-instellingen configureert.

SMTP-inloggegevens aanmaken

Voor de SMTP-verbinding gebruik je een gebruikersnaam en wachtwoord. Deze maak je aan in het SMTPeter-dashboard.

  1. Log in op je SMTPeter-account.
  2. Ga naar Configuratie > SMTP API.
  3. Klik op Create SMTP login.
  4. Kies een gebruikersnaam en wachtwoord.
  5. Configureer de gewenste API-opties en opslaginstellingen.
  6. Klik op Genereer inloggegevens.

Je kunt per applicatie een aparte SMTP-login aanmaken. Zo kun je inloggegevens afzonderlijk beheren en functionaliteiten per applicatie instellen.

Gebruikersnaam en wachtwoord

Je kiest zelf een gebruikersnaam en wachtwoord. Gebruik een sterk wachtwoord met minimaal acht tekens, waaronder hoofdletters, kleine letters, cijfers en speciale tekens.

Met Genereer wachtwoord kun je automatisch een wachtwoord laten aanmaken.

Bewaar je SMTP-inloggegevens op een veilige plek, bijvoorbeeld in een secret manager of beveiligde configuratieomgeving. Neem wachtwoorden niet op in broncode of repositories.

Ben je het wachtwoord kwijt of vermoed je dat je inloggegevens zijn uitgelekt? Maak dan een nieuwe SMTP-login aan, werk de configuratie van je applicatie bij en trek de oude login in. Bij vermoedelijk misbruik trek je de betrokken login direct in.

Let op: voor SMTP gebruik je een gebruikersnaam en wachtwoord, voor de REST API een access token. Deze gegevens zijn niet uitwisselbaar.

API-opties

Bij het aanmaken van een SMTP-login bepaal je welke aanvullende functionaliteiten SMTPeter toepast op berichten die via deze login worden verstuurd.

De volgende opties zijn beschikbaar:

Optie Werking
Inline CSS Zet CSS-stijlen om naar inline CSS in je e-mails.
Opens-tracking Registreert het openen van e-mails via een trackingpixel.
Bounce-tracking Registreert fouten bij de aflevering van e-mails.
Click-tracking Registreert klikken op links in je e-mails.
Spampreventie Voorkomt het overschrijven van links waarvan de zichtbare tekst gelijk is aan de URL.
Host ingebedde afbeeldingen Host ingebedde afbeeldingen extern, waardoor het bericht kleiner wordt.
Volledig bericht in de afleveringsstatus-berichtgeving Voegt het volledige bericht toe aan afleveringsstatusnotificaties in plaats van alleen de headers.

Welke opties je inschakelt, hangt af van de functionaliteiten die je applicatie nodig heeft.

Als je opens-tracking, bounce-tracking of click-tracking uitschakelt, worden de bijbehorende eventwebhooks niet verstuurd.

Berichtonderdelen opslaan

Je kunt bepalen welke onderdelen van verzonden berichten SMTPeter bewaart.

Beschikbare opties zijn:

  • HTML: slaat de HTML-versie van het bericht op.
  • Tekstversie: slaat de platte tekstversie op.
  • Bijlagen: bewaart de meegestuurde bijlagen.
  • Afbeeldingen: bewaart de afbeeldingen in het bericht.

Standaard zijn HTML en tekstversie geselecteerd. Bijlagen en afbeeldingen worden standaard niet opgeslagen.

Opgeslagen berichtonderdelen kun je later via de API of het SMTPeter-dashboard terugzien.

Sla alleen berichtonderdelen op die je later nodig hebt. Zo beperk je de hoeveelheid opgeslagen gegevens, waaronder mogelijk persoonsgegevens en bijlagen.

SMTP-verbinding configureren

Nadat je de inloggegevens hebt aangemaakt, kun je de SMTP-verbinding instellen in je applicatie of e-mailclient.

Gebruik hiervoor de volgende instellingen:

Instelling Waarde
SMTP-server (hostname) mail.smtpeter.com
Poort 587
Beveiliging STARTTLS
Authenticatie Ingeschakeld
Gebruikersnaam Je SMTP-gebruikersnaam
Wachtwoord Je SMTP-wachtwoord

Poort 587 met STARTTLS is de aanbevolen configuratie voor geauthenticeerde e-mailverzending.

SMTPeter ondersteunt authenticatie via AUTH PLAIN en AUTH LOGIN. De meeste SMTP-clients ondersteunen deze methoden standaard.

Beveiligde verbinding

SMTPeter vereist een beveiligde en geauthenticeerde SMTP-verbinding.

Bij STARTTLS wordt de verbinding eerst opgezet en vervolgens met TLS beveiligd. Configureer STARTTLS als verplichte beveiliging, zodat je applicatie niet onversleuteld verdergaat wanneer de TLS-verbinding mislukt.

Zorg er ook voor dat je applicatie het TLS-certificaat van de SMTP-server controleert. Schakel certificaatvalidatie niet uit om verbindingsproblemen te omzeilen.

Alternatieve poorten

SMTPeter ondersteunt meerdere poorten voor beveiligde verbindingen.

Poort Beveiliging Toepassing
587 STARTTLS Aanbevolen standaardconfiguratie
2525 STARTTLS Alternatief als poort 587 wordt geblokkeerd
25 STARTTLS Alternatief, soms geblokkeerd door providers
465 Impliciete TLS (SMTPS) Direct versleutelde verbinding

Bij poort 465 wordt de verbinding direct met TLS beveiligd. Gebruik daarom impliciete TLS in plaats van STARTTLS wanneer je deze poort kiest.

Wordt poort 587 geblokkeerd? Dan kun je poort 2525 gebruiken.

Meer informatie vind je bij SMTP-hostname en poorten.

Voorbeeldconfiguratie

Een SMTP-configuratie kan er als volgt uitzien:

SMTP_HOST=mail.smtpeter.com
SMTP_PORT=587
SMTP_SECURITY=STARTTLS
SMTP_AUTH=true
SMTP_USERNAME=YOUR_SMTP_USERNAME
SMTP_PASSWORD=YOUR_SMTP_PASSWORD

Vervang YOUR_SMTP_USERNAME en YOUR_SMTP_PASSWORD door de inloggegevens die je in het SMTPeter-dashboard hebt aangemaakt.

Dit is één mogelijke configuratie. De namen van de instellingen verschillen per applicatie of e-mailclient. Het voorbeeld is daarom niet zonder aanpassingen in iedere applicatie te gebruiken.

Voor specifieke configuraties, bijvoorbeeld voor Gmail, Apple Mail, Thunderbird, Android of Postfix, kun je de documentatie over verzenden via de SMTP API raadplegen.

SMTP-verbinding testen

Na het configureren kun je controleren of je applicatie berichten via SMTPeter kan versturen.

  1. Verstuur vanuit je applicatie een testmail naar een e-mailadres dat je zelf kunt controleren.
  2. Controleer of je applicatie het bericht zonder SMTP-foutmelding aan SMTPeter heeft overgedragen.
  3. Controleer in het SMTPeter-dashboard of het bericht is verwerkt.
  4. Bekijk de afleverstatus om te controleren of het bericht bij de ontvangende mailserver is afgeleverd.

Als SMTPeter het bericht accepteert, is de SMTP-verbinding voor die verzending geslaagd. De aflevering kan daarna nog mislukken, bijvoorbeeld wanneer de ontvangende mailserver het bericht weigert.

Gebruik voor de test een afzenderadres waarvan het domein in SMTPeter is gevalideerd.

Problemen met de SMTP-verbinding oplossen

Lukt het niet om verbinding te maken of een testmail te versturen? Controleer dan de foutmelding van je applicatie.

Probleem Mogelijke oorzaak
Authenticatie mislukt Onjuiste gebruikersnaam of wachtwoord
Verbinding mislukt Onjuiste hostname, poort of netwerkblokkade
TLS-fout Verkeerde beveiligingsmethode of certificaatprobleem
Afzender geweigerd Afzenderdomein niet toegestaan
Bericht geweigerd Accountrestrictie of verzendbeleid

Authenticatie mislukt

Controleer of je de gebruikersnaam en het wachtwoord van je SMTP-login gebruikt.

Een REST API-token werkt niet voor SMTP-authenticatie.

Ben je het wachtwoord kwijt? Maak dan nieuwe SMTP-inloggegevens aan en vervang de oude login.

Verbinding mislukt

Controleer of je mail.smtpeter.com als hostname gebruikt en of de gekozen poort bereikbaar is.

Bij verbindingsproblemen via poort 587 kun je poort 2525 proberen. Controleer ook of je firewall of hostingprovider uitgaand SMTP-verkeer toestaat.

TLS-verbinding mislukt

Controleer of de beveiligingsmethode overeenkomt met de gekozen poort:

  • Poort 25, 587 of 2525: STARTTLS.
  • Poort 465: impliciete TLS (SMTPS).

Controleer ook of je applicatie TLS ondersteunt en het certificaat van de SMTP-server correct valideert.

Afzender of account niet toegestaan

Een werkende SMTP-verbinding betekent niet automatisch dat je account alle berichten mag versturen.

Controleer of:

  • je Senderdomain is toegevoegd en gevalideerd;
  • de benodigde DNS-records correct zijn ingesteld;
  • de vetting van je account is goedgekeurd;
  • het afzenderadres een toegestaan domein gebruikt.

Meer informatie vind je bij Senderdomain configureren en DNS-instellingen configureren.

SMTP API of REST API?

SMTPeter ondersteunt twee manieren om e-mail te versturen:

  • SMTP API: geschikt voor applicaties, mailservers en e-mailclients die al SMTP ondersteunen. Je configureert een SMTP-server en gebruikt een gebruikersnaam en wachtwoord om verbinding te maken.
  • REST API: geschikt voor applicaties die via HTTPS API-requests versturen. Je kunt hierbij verzendopties rechtstreeks in het API-request meegeven.

Gebruik je al SMTP, dan kun je deze bestaande koppeling behouden. Ontwikkel je een nieuwe integratie waarbij je meer controle over de verzendopties nodig hebt, dan kan de REST API geschikter zijn.

Lees hoe je de REST API configureert als je liever via HTTPS werkt.

Meer informatie

Wanneer SMTPeter je testmail accepteert en verwerkt, is de SMTP-verbinding gereed voor gebruik.

Je kunt daarna aanvullende functionaliteiten configureren, zoals clicktracking, impressietracking en bounceverwerking. Raadpleeg hiervoor de uitgebreide SMTP API-documentatie.