SMTP-verzendingen voor transactionele e-mail
Naast de HTTP API ondersteunt Flexmail het versturen van transactionele e-mail via SMTP. Dit is handig wanneer je applicatie of platform al SMTP-ondersteuning heeft ingebouwd, zoals een CMS, een e-commerceplatform of een legacy-systeem dat e-mail via een SMTP-relay verzendt.
SMTP-verzendingen zijn inbegrepen in de transactionele module zonder extra kosten. Ze bieden dezelfde betrouwbaarheid en trackingemogelijkheden als de API, met een paar verschillen in standaardinstellingen en ondersteunde functies.
Opgelet SMTP-verzendingen zijn niet standaard ingeschakeld. Je moet expliciet toegang aanvragen. Zie "Toegang aanvragen" hieronder.
Toegang aanvragen
SMTP-toegang wordt niet automatisch ingeschakeld wanneer je de transactionele module activeert. Om SMTP-inloggegevens voor je account aan te vragen, neem contact op met Flexmail via api@flexmail.be en vermeld je account-ID in het verzoek. Je SMTP-gebruikersnaam en wachtwoord worden meegedeeld als onderdeel van het antwoord.
Opgelet
Je SMTP-inloggegevens staan los van je personal access token. De gebruikersnaam en het wachtwoord voor SMTP worden door Flexmail op aanvraag verstrekt. Gebruik je account-ID en API token niet als SMTP-inloggegevens.
Verbindingsinstellingen
Zodra je SMTP-toegang is verleend, gebruik je de volgende instellingen:
| Instelling | Waarde |
|---|---|
| Server | submission.flexmail.eu |
| Poort | 587 |
| Verbindingsbeveiliging | STARTTLS |
| Gebruikersnaam | Verstrekt door Flexmail op aanvraag |
| Wachtwoord | Verstrekt door Flexmail op aanvraag |
Aangepaste headers
SMTP-verzendingen ondersteunen verschillende optionele aangepaste headers die het gedrag van berichten en tracking bepalen. Deze werken op dezelfde manier als de opties in de HTTP API.
| Header | Beschrijving |
|---|---|
| X-Flexmail-Tag | Voeg een tag toe om berichten te categoriseren en statistieken te verzamelen. Moet in snake_case-formaat zijn (1-50 tekens, bijv. order_bevestiging). |
| X-Flexmail-Metadata-{sleutel} | Voeg aangepaste metadata toe als sleutel/waarde-paren. Vervang {sleutel} door je veldnaam in snake_case. Waarde mag 1-80 tekens bevatten. |
| X-Flexmail-Open-Tracking | Stel in op true om open-tracking in te schakelen. Standaard uitgeschakeld. |
| X-Flexmail-Link-Tracking | Stel in op true om link-tracking in te schakelen. Standaard uitgeschakeld. |
Voorbeeld:
X-Flexmail-Tag: order_confirmation X-Flexmail-Metadata-order_id: 12345 X-Flexmail-Metadata-customer_id: C-789 X-Flexmail-Open-Tracking: true X-Flexmail-Link-Tracking: true
Opgelet
Open- en link-tracking zijn standaard uitgeschakeld voor zowel SMTP-verzendingen als de HTTP API. Voeg de bijbehorende headers toe als je tracking wilt inschakelen.
Bericht-ID en webhook-correlatie
De originele Message-ID-header van je ingediende e-mail wordt automatisch opgeslagen als metadata onder de sleutel original_message_id. Hiermee kun je webhook-bezorgingsevents koppelen aan de berichten die je vanuit je eigen systeem hebt verstuurd.
SMTP versus de HTTP API
De twee methoden hebben enkele verschillen in standaardinstellingen en mogelijkheden:
| Functie | HTTP API | SMTP-verzending |
|---|---|---|
| Open-tracking | Standaard uitgeschakeld | Standaard uitgeschakeld |
| Link-tracking | Standaard uitgeschakeld | Standaard uitgeschakeld |
| Originele Message-ID | N.v.t. | Bewaard als original_message_id-metadata |
| Inline bijlagen | Ondersteund | Niet ondersteund |
| Alleen-tekst e-mail | Ondersteund | Niet ondersteund |
Ondersteunde functies
- HTML-e-mails met of zonder een plain-text multipart.
- Open- en link-tracking (via aangepaste headers).
- CC- en BCC-ontvangers.
- Bijlagen — moeten base64-gecodeerd zijn. Inline bijlagen worden niet ondersteund.
- Snelheidsbeperking per ontvanger, in overeenstemming met de API-snelheidsbeperkingen.
Vereisten
- Het Van-adres moet een geverifieerde afzender zijn in je Flexmail-account.
- Het verzendende domein moet worden geverifieerd met SPF, DKIM en DMARC, en er moet een return-path worden geconfigureerd. Deze vereisten zijn dezelfde als voor de HTTP API.
Foutafhandeling
Verzendfouten worden gemeld via een NDR (Non-Delivery Report) die naar het envelop-afzenderadres wordt gestuurd. Bounce-events en alle andere berichtevents zijn ook beschikbaar via het berichtdetails-endpoint en webhooks, op dezelfde manier als bij API-verzendingen.
Volgende stappen
- Zie "Aan de slag met de transactionele API" voor het volledige accountinstellingsproces.
- Zie "Transactionele webhooks" voor het ontvangen van realtime bezorgings- en trackingevents.
- Zie "Problemen oplossen met transactionele e-mail" als je SMTP-verbinding of bezorgbaarheid niet naar wens werkt.