B4X Requires Chilkat v11.0.0+

Process New Email by Scanning for Senders

Scan email and save application-selected emails to EML files with unique filenames. B4X

Dim success As Boolean = False

'  This example assumes the Chilkat API to have been previously unlocked.
'  See Global Unlock Sample for sample code.

Dim imap As ChilkatImap
imap.Initialize("imap")

'  Connect to an IMAP server.
'  Use TLS
imap.Ssl = True
imap.Port = 993
success = imap.Connect("imap.example.com")
If success = False Then
    Log(imap.LastErrorText)
    Return
End If


'  Login
success = imap.Login("myLogin", "myPassword")
If success = False Then
    Log(imap.LastErrorText)
    Return
End If


'  Select an IMAP mailbox
success = imap.SelectMailbox("Inbox")
If success = False Then
    Log(imap.LastErrorText)
    Return
End If


'  We can choose to fetch UIDs or sequence numbers.
Dim fetchUids As Boolean = True

'  Fetch messages from the mailbox using a search criteria.
'  This example finds NEW emails: these are emails that have the RECENT flag set, but not the SEEN flag:
Dim messageSet As ChilkatMessageSet
messageSet.Initialize
success = imap.QueryMbx("NEW", fetchUids, messageSet)
If success = False Then
    Log(imap.LastErrorText)
    Return
End If


'  This example will download headers, and then download
'  the full email for those emails sent from a contact
'  in our database.

'  When downloading headers, each email object contains
'  (obviously) the headers, but the body will be missing.
'  Also, attachments will not be included.  However, it is
'  possible to get information about the attachments
'  as well as the complete size of the email.
Dim bundle As ChilkatEmailBundle
bundle.Initialize
Dim headersOnly As Boolean = True
success = imap.FetchMsgSet(headersOnly, messageSet, bundle)
If success = False Then
    Log(imap.LastErrorText)
    Return
End If


'  Loop over the email objects...
Dim emailHeader As ChilkatEmail
emailHeader.Initialize
Dim fullEmail As ChilkatEmail
fullEmail.Initialize
Dim i As Int = 0
Dim numEmails As Int = bundle.MessageCount
Do While i < numEmails
    bundle.EmailAt(i, emailHeader)

    '  The sender's email address and name are available
    '  in the From, FromAddress, and FromName properties.
    '  If the sender is "Chilkat Support <support@chilkatsoft.com",
    '  then the From property will hold the entire string.
    '  the FromName property contains"Chilkat Support",
    '  and the FromAddress property contains "support@chilkatsoft.com";
    Log(emailHeader.From)
    Log(emailHeader.FromAddress)
    Log(emailHeader.FromName)

    '  Assume at this point your code checks to see if the sender
    '  is one in your contacts database.  If so, this is
    '  the code you would write to download the entire
    '  email and save it to a file.

    '  The ckx-imap-uid header field is added when
    '  headers are downloaded.  This makes it possible
    '  to get the UID from the email object.
    Dim uidStr As String = emailHeader.GetHeaderField("ckx-imap-uid")
    Dim uid As Int = uidStr

    success = imap.FetchEmail(False, uid, True, fullEmail)
    If success = False Then
        Log(imap.LastErrorText)
        Return
    End If


    '  You can use the GenerateFilename method to
    '  generate a unique filename...
    Dim filename As String = fullEmail.GenerateFilename

    '  SaveEml saves the entire email, including attachments.
    success = fullEmail.SaveEml(filename)

    Log("--")

    i = i + 1
Loop

'  Disconnect from the IMAP server.
success = imap.Disconnect