Resend stap voor stap: API-key, domeinverificatie en eerste mail
Resend is een dienst om e-mails vanuit je applicatie te versturen. Je eerste mail verstuur je in vijf minuten - domeinverificatie kost de meeste tijd.
👁 115 keer gelezen
Resend is een dienst om e-mails vanuit je applicatie te versturen: registraties, wachtwoordresets, orderbevestigingen, notificaties. Je eerste mail verstuur je in vijf minuten, en de meeste tijd kost niet de code, maar de domeinverificatie. Deze handleiding leidt je door het hele proces volgens de officiële Resend-documentatie.
Voordat je begint: toegang tot DNS
De meest voorkomende blokkade bij het starten met Resend is niet de code, maar geen toegang tot de DNS-instellingen van je domein. Controleer voordat je begint waar je domein wordt beheerd en of je daar rechten hebt om records toe te voegen. Als iemand anders je domein beheert, bijvoorbeeld een bureau of de IT-afdeling, vraag dan om toegang of bereid je voor om hen de lijst met records uit het Resend-dashboard door te geven.
Bepaal ook meteen vanaf welk adres de e-mails verstuurd worden, bijvoorbeeld notificaties@ op een verzendsubdomein.
Stap 1. API-key
Na het aanmaken van je account maak je een API-key aan in het dashboard. Je slaat de key op in een omgevingsvariabele op de server, bijvoorbeeld in het configuratiebestand van je applicatie, en niet in de code. De documentatie en handleidingen benadrukken dit sterk: een key in browsercode is publiek, en iedereen die hem uitleest kan e-mails versturen namens jouw domein.
Stap 2. Bibliotheek en eerste mail
Je installeert de officiële bibliotheek voor jouw programmeertaal, bijvoorbeeld voor Node.js via npm. Je eerste mail verstuur je met één aanroep met afzender, ontvanger, onderwerp en HTML-inhoud. Voor tests kun je versturen vanaf een testadres van Resend, zonder je domein te configureren.
Hier is een valkuil waar veel mensen intrappen: vanaf het testadres komt de mail alleen aan op het adres van je account. Verzending naar iemand anders vóór domeinverificatie eindigt in een foutmelding die op de eerste dag cryptisch lijkt.
Stap 3. Domeinverificatie
Om vanaf je eigen adres te versturen, voeg je je domein toe in het Resend-dashboard. In het tabblad met records krijg je vermeldingen om toe te voegen bij je DNS-provider: SPF- en DKIM-records en een bounce-record. Kopieer ze exact, het beste via kopiëren-plakken, want één typfout blokkeert de verificatie.
Drie praktische opmerkingen uit de documentatie:
- Resend raadt een apart verzendsubdomein aan, bijvoorbeeld send, in plaats van het hoofddomein,
- bij Cloudflare schakel je de proxy uit voor CNAME-records, anders wordt de verificatie niet afgerond,
- propagatie kan tot een dag duren, en waarschuwingen over ontbrekende records zijn in die tijd normaal.
DMARC is niet verplicht voor verificatie, maar het is wel de moeite waard om toe te voegen, omdat het de geloofwaardigheid van je e-mails verbetert.
Stap 4. Templates in React Email
Resend is gemaakt door hetzelfde team dat React Email heeft gemaakt, dus dat is de aanbevolen manier om templates te bouwen. Je schrijft een e-mail als een component, met parameters zoals de naam van de klant en de productnaam, en je geeft deze door bij het versturen. Resend converteert het automatisch naar HTML.
Stap 5. Overzicht van verzendingen
In het dashboard zie je elk verzonden bericht en de status: afgeleverd, afgewezen, gemarkeerd als spam. Bij problemen met aflevering is dit de eerste plaats waar je kijkt. Afleveringspercentages hangen ook af van de domeinconfiguratie en de regels van de ontvangende server, dus correcte DNS-records zijn essentieel.
Voorbeeld: welkomstmail in applicatie
Je applicatie moet een welkomstmail versturen na registratie. Je maakt een key aan, slaat deze op in een variabele op de server, test de verzending vanaf het testadres naar je eigen adres. Je voegt het subdomein send toe in het dashboard, plakt de records bij je DNS-provider en wacht op verificatie. Je schrijft de welkomsttemplate in React Email met de naam van de gebruiker en een link naar de eerste stappen. Na verificatie verander je de afzender naar je eigen adres.
In dit voorbeeld is de volgorde belangrijk. Eerst test vanaf het testadres naar je eigen mailbox, dan domeinverificatie, tot slot wijziging van de afzender. Zo kun je code schrijven en testen terwijl de DNS-records zich verspreiden, en het overschakelen naar je eigen adres is één wijziging in de configuratie. Het is ook verstandig om meteen de welkomstmail naar verschillende mailboxen te sturen en te controleren of deze er ook op de telefoon goed uitziet.
Meest voorkomende fouten
- API-key in browsercode.
- Verzending naar anderen testen vóór domeinverificatie.
- Typfouten in DNS-records.
- Cloudflare-proxy ingeschakeld voor verificatierecords.
Hoe beoordeel je of alles werkt
Na domeinverificatie verstuur je testmails naar verschillende mailboxen: Gmail, Outlook, een zakelijke mailbox. Controleer of ze in de inbox terechtkomen en niet in spam, en of ze er goed uitzien op de telefoon. In het Resend-dashboard zie je de status van elk bericht.
Kijk de eerste dagen na implementatie dagelijks in het dashboard. Afgewezen e-mails en spamklachten die je vroeg oppikt zijn makkelijk op te lossen, en genegeerde problemen schaden de reputatie van je domein.
Als de basis-e-mails werken, is het verstandig om een aparte template toe te voegen voor elk type bericht, in plaats van één universele. Een wachtwoordreset en een orderbevestiging hebben verschillende doelen, en aparte templates zijn makkelijker aan te passen en te testen.
More on this from HELDER
handleidingen·Geld verdienen met AI-muziek: wat zeggen de voorwaarden echt?Een betaald account betekent niet automatisch dat je mag verdienen. We checken abonnementen, downloadmethoden en uitzonderingen die je makkelijk over het hoofd ziet.