De nShift Notifications API ondersteunt het verzenden van e-mails vanuit de eigen e-mailadressen van klanten. Deze gids legt uit hoe u uw e-mailadressen configureert en verifieert voor het verzenden van meldingen met behulp van de functie From Email Addresses.
Secties in dit artikel:
- Overzicht
- Stap 1 – Voeg uw e-mail toe
- Stap 2 – Haal uw DNS-records op
- Stap 3 – Publiceer DNS-records
- Stap 4 – Verifieer de records
- Stap 5 – Gebruik uw e-mailadres in sjablonen
- Probleemoplossing
Overzicht
Het is noodzakelijk om drie elementen te configureren in de functie From Email Addresses:
- Afzenderadres – het e-mailadres dat wordt gebruikt om meldingen te verzenden.
- Ontvangstadres voor bounce-meldingen – het e-mailadres dat bounce-meldingen ontvangt (wanneer een e-mail niet kan worden afgeleverd).
- Ontvangstadres voor klachtmeldingen – het e-mailadres dat klachtmeldingen ontvangt (bij spam- of misbruikrapporten).
Na de configuratie genereert de functie de vereiste DNS-records (SPF en DKIM) die bij uw DNS-provider gepubliceerd moeten worden. Na DNS-verificatie kunt u het geconfigureerde e-mailadres gebruiken in uw meldingssjablonen.
Stap 1 – Voeg uw e-mail toe
- Log in op nShift Portal en ga naar Settings > Services > From email addresses.
- Klik op Add new email address en voer de e-mailadressen in die u wilt configureren.
- Klik op Submit.
Opmerking: het "Mail from address" moet een domein zijn dat u bezit en waarvoor u DNS kunt beheren.
Stap 2 – Haal uw DNS-records op
Na het invoeren van uw e-mailadressen genereert de functie twee DNS-records voor uw domein:
- SPF-record – machtigt onze mailservers om e-mails te verzenden namens uw domein.
- DKIM-record – biedt een cryptografische handtekening die uw berichten valideert.
Voorbeelduitvoer (uw waarden zullen afwijken):
SPF: v=spf1 include:mail.yourprovider.com ~all
DKIM (CNAME): selector1._domainkey.yourdomain.com → dkim.mail.yourprovider.com
Stap 3 – Publiceer DNS-records
- Log in bij uw DNS-provider (bijv. GoDaddy, Cloudflare, Route53).
- Navigeer naar de sectie DNS Management.
- Voeg de records exact toe zoals opgegeven:
- Voor SPF: voeg MX- en TXT-records toe voor uw domeinroot (@).
- Voor DKIM: voeg CNAME-records toe.
Als uw domein al een SPF-record heeft, voegt u de nieuwe include samen met de bestaande in plaats van deze te vervangen.
Stap 4 – Verifieer de records
Nadat u de DNS-records heeft gepubliceerd, keert u terug naar de functie From email addresses.
Het systeem controleert automatisch op DNS-propagatie.
Wanneer de verificatie slaagt, wordt de status bijgewerkt naar Verified.
Stap 5 – Gebruik uw e-mailadres in sjablonen
Nadat het "From Address" is geverifieerd, kunt u:
- Ga naar Track > Notifications > Templates.
- Selecteer uw geverifieerde e-mailadres uit de afzenderopties.
Dit zorgt ervoor dat alle meldingen worden verzonden vanuit uw vertrouwde domein met volledige authenticatie (SPF + DKIM).
Probleemoplossing
- DNS wordt niet geverifieerd? Het kan tot 24–48 uur duren voordat DNS-wijzigingen zijn doorgevoerd.
- SPF bestaat al? Zorg ervoor dat u slechts één SPF-record heeft; voeg meerdere vermeldingen samen op één enkele regel.
- Werkt het nog steeds niet? Controleer op typefouten in hostnamen of waarden en bevestig dat u de DNS-records heeft opgeslagen met het juiste type (TXT of CNAME).