Een inbound-e-mail-API ontvangt mail die naar een adres of domein van jou wordt gestuurd, parst deze en levert het als een gestructureerde HTTP POST af bij je applicatie. In plaats van een mailserver te draaien en een mailbox te pollen via IMAP, richt je de MX-records van je domein naar de provider, en elk binnenkomend bericht komt aan op je endpoint met de headers, body en bijlagen al geparseerd tot JSON.
Hoe werkt inbound e-mail?
De routering begint bij DNS. Je stelt de MX-records voor een domein of subdomein (bijvoorbeeld reply.yourapp.com) in om naar de mailservers van de inbound-provider te wijzen. Wanneer iemand een bericht stuurt naar een adres op dat domein, komt het terecht op de infrastructuur van de provider in plaats van die van jou. De provider accepteert het bericht, parst het en doet een POST-request naar een URL die je hebt geregistreerd, met de geparseerde inhoud.
Een geparseerde payload bevat doorgaans de afzender en ontvanger, het onderwerp, de platte-tekst- en HTML-body, de volledige headerset en eventuele bijlagen (vaak base64-gecodeerd of als URL beschikbaar). Je app leest die JSON en handelt ernaar, zonder SMTP- of IMAP-code om te onderhouden. Het afleveringsmechanisme is een webhook, dus dezelfde regels gelden: reageer met een snelle 2xx en verwerk het bericht asynchroon.
Waarvoor wordt het gebruikt?
Inbound e-mail maakt van ontvangen berichten applicatie-events. Veelvoorkomende patronen zijn:
- Antwoordverwerking. Stuur een notificatie vanuit
notifications@yourapp.com, en wanneer een gebruiker antwoordt, komt het antwoord binnen als een POST zodat je het kunt koppelen aan een gesprek. - Supporttickets. Mail naar
support@yourapp.comwordt een nieuw ticket, waarbij afzender en body direct in je helpdesk worden ingelezen. - Parsen naar database. Doorgestuurde bonnen of gestructureerde e-mails worden geparseerd en in een tabel geschreven, zonder handmatige invoer.
- E-mail naar actie. Een bericht naar een speciaal adres start een workflow: maak een record aan, start een taak, post naar een kanaal.
Wat is het verschil met mail versturen?
Outbound en inbound zijn aparte taken. Outbound is je app die mail aflevert bij ontvangers via SMTP of een HTTP send API. Inbound is het omgekeerde: externe afzenders die mail afleveren bij je app. Een complete e-mailintegratie doet meestal beide, notificaties versturen en de antwoorden terugontvangen, maar ze worden apart geconfigureerd en de inbound-kant is wat afhankelijk is van je MX-records.
Waarom niet gewoon een mailbox pollen via IMAP?
Je kunt een IMAP-poller op een echte mailbox draaien, maar dat brengt doorlopende kosten met zich mee. Je beheert inloggegevens, je bepaalt hoe vaak je pollt (wat latentie en inactieve verbindingen toevoegt), je parst ruwe MIME zelf en je houdt bij welke berichten je al hebt verwerkt. Een inbound API neemt het meeste daarvan weg: de provider parst de MIME, pusht elk bericht eenmalig als schone JSON en je reageert in bijna realtime. Zie SMTP vs. IMAP voor een vergelijking van de onderliggende protocollen.
Veelgestelde vragen
Welke DNS-wijzigingen heb ik nodig?
Je stelt de MX-records in voor het domein of subdomein waarop je mail wilt ontvangen, zodat ze naar je inbound-provider wijzen. Na propagatie stroomt mail naar elk adres op dat domein naar de provider, die het parst en naar je endpoint post. Een apart subdomein houdt inbound-routering gescheiden van de mail op je hoofddomein.
Hoe worden bijlagen afgehandeld?
De geparseerde payload bevat bijlagen, meestal base64-gecodeerd inline of als URL's die je apart ophaalt. Je handler decodeert of downloadt ze en slaat ze op waar je bestanden bewaart. Grotere bijlagen worden doorgaans als URL aangeboden om de payload klein te houden.
Is inbound e-mail hetzelfde als een webhook?
De aflevering gebruikt een webhook: de provider stuurt je app een HTTP POST per bericht. Het verschil is dat de payload een volledig geparseerde e-mail is in plaats van een generiek event. Behandel het als elke andere webhook door het te verifiëren, snel te reageren en asynchroon te verwerken.
Om te zien hoe Bird beide richtingen van e-mail afhandelt, begin je met het e-mailproductoverzicht en de e-mail-events-gids, die het eventafleveringsmodel beschrijft waarop je inbound-handler voortbouwt.