MSGraph Email Poller

Overview

Need to poll emails from your Exchange server? This smart service can be used in a poller process and extract the data from the Microsoft Exchange server. Messages are stored in the Appian Document System, as well as the attachments. Meta data is stored in a database table for further processing.

This plug-in provides an alternative to sending emails to an Appian process model when inbound email integration is requested. Instead of the email being forwarded to Appian, this plug-in reads the emails directly from the Exchange mailbox using the MS Graph API as described below:

  • Reads the mailbox using the MS Graph API
  • Convert the email to an EML file stored as an Appian document; Item attachments (calendar invites, messages) are kept in the eml file, File attachments removed from it and stored separately in the document management system.
  • Store all email file attachments as separate Appian documents
  • Store all email metadata (subject, author, recipients, etc...) into a set of tables in the database

Key Features & Functionality

All information how to deploy, configure and use the smart service is in the 'MS Graph Mail Poller.pdf' document in the downloaded zip. Extract the files in the ZIP and follow the instructions in the document.

Anonymous
  • I don't think it is something we have taken into account. MessageId is a field that tracks the internal id of the message withing Azure which should allow for referencing in replies or forwards. I would give that a try in your responses.

  • Have you opened a support case around this? While this is a plugin, the behavior seems very unexpected.
    Do you have additional information from logs, e.g. a stack trace?

  • Hi,

    Appian restarted our server and after that for no reason we started getting this error:

    Unable to find an ACP with name [GraphEndpoint] to match. ACPs: [Mailbox, contentType, ConnectedViaProxy, ProxyURL, ProxyPort, TimeLimit, AttachmentFolder, JndiName, ExceptionFolderName, GenerateEml, KeepFileAttachmentsInEml, SaveItemAttachmentsAsDoc, SwapInlineImages].

    Can anyone help tell me how to solve this problem? the appian version on the server is 24.2 and the plugin version is the current one, 4.2.6.

  • Hi Dhananjay , Did you find an answer to this?

  • v4.2.6 Release Notes
    • Minor bug fix for log statement.
  • v4.2.5 Release Notes
    • Introduces support for digitally signed, non-encrypted emails. The plugin now processes these emails just as it does regular emails, extracting attachments and creating documents in Appian. Currently, the functionality supports digitally signed emails with S/MIME signatures. Digital signatures are preserved but not verified, enabling consistent functionality with existing workflows.
  • v4.2.4 Release Notes
    • Upgraded and applied security patch for Azure library
  • Hi, 

    One of the metadata which enables a reply to a forwarded email to link to the original email is the "References" metadata but that doesn't seem to get stored in DB. Is this something missed or intentionally avoided?

    Thanks for your support!

  • "I am working with the MS Graph Email Poller plugin to read emails and save attachments as .eml files in an Appian document folder. However, I am having difficulty locating the SCS external system key and the correct JNDI name. Could someone please guide me on how to set these up?"

  • Hi,

    Once in a while the plugin ends with and errorCount = 1 and these emails are sent to the spam folder. But, once we move again this emails to the inbox and the plugin executes again, it processes the emails without error.

    What is the cause of this?

    Thanks.