E-mail lezen vanuit je app

Laatst gecontroleerd

Je app leest een mailbox via IMAP, ingelogd met een Email API-sleutel die Read mail of Change mail mag. Gebruik dit om antwoorden, binnenkomende bestellingen of supportvragen op te halen.

Voordat je begint

Maak een Email API-sleutel op de mailbox en kies wat de app nodig heeft:

  • Read mail: de app kan berichten en bijlagen opsommen, doorzoeken en downloaden. Hij verandert niets: berichten blijven ongelezen, niets wordt verplaatst of verwijderd. Opdrachten die iets zouden veranderen, doen niets of worden geweigerd.
  • Change mail: alles wat Read mail kan, plus berichten als gelezen markeren of een vlag geven, ze tussen mappen verplaatsen, ze verwijderen en concepten opslaan. Kies dit als de app moet markeren wat hij al verwerkt heeft.

Instellingen

Instelling Waarde
Server imap.veldhost.eu
Poort 993
Beveiliging SSL/TLS
Gebruikersnaam het mailboxadres
Wachtwoord de Email API-sleutel

Email API-sleutels loggen alleen in via IMAP. POP3, mailfilters (ManageSieve), agenda's en contacten accepteren ze niet.

Voorbeelden

MAILBOX is het mailboxadres en KEY de Email API-sleutel, IMAP_HOST staat voor imap.veldhost.eu en IMAP_PORT voor 993.

Python (nieuwe mail lezen en als verwerkt markeren; vraagt Change mail):

import imaplib, os, email

with imaplib.IMAP4_SSL("IMAP_HOST", IMAP_PORT) as imap:
    imap.login("MAILBOX", os.environ["EMAIL_API_KEY"])
    imap.select("INBOX")
    _, ids = imap.search(None, "UNSEEN")
    for num in ids[0].split():
        _, data = imap.fetch(num, "(RFC822)")
        message = email.message_from_bytes(data[0][1])
        print(message["From"], message["Subject"])
        imap.store(num, "+FLAGS", "\\Seen")

Met een Read mail-sleutel open je de mailbox alleen-lezen (imap.select("INBOX", readonly=True)) en houd je zelf bij wat je verwerkt hebt, bijvoorbeeld aan de hand van de UID van het bericht.

Node.js (imapflow):

const client = new ImapFlow({ host: 'IMAP_HOST', port: IMAP_PORT, secure: true,
  auth: { user: 'MAILBOX', pass: process.env.EMAIL_API_KEY } });
await client.connect();
const lock = await client.getMailboxLock('INBOX');
try {
  for await (const msg of client.fetch({ seen: false }, { envelope: true })) {
    console.log(msg.envelope.from[0].address, msg.envelope.subject);
  }
} finally { lock.release(); await client.logout(); }

PHP: elke IMAP-bibliotheek (bijvoorbeeld webklex/php-imap) met de instellingen hierboven.

Goede gewoonten

  • Kijk elke minuut of twee of er nieuwe mail is, of houd één verbinding open en gebruik IDLE. Log niet voor elk bericht opnieuw in.
  • Lezen via IMAP zit in je abonnement en wordt niet gefactureerd.
  • Download grote bijlagen één keer en bewaar ze; haal hetzelfde bericht niet steeds opnieuw op.

Gerelateerd

Kom je er niet uit? Neem contact op met support — antwoord binnen één werkdag.