Poll Email from Microsoft Exchange EWS API

Overview

This plugin 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 plugin reads the emails directly from the Exchange mailbox using the EWS web services API.

Deployment Instructions

  • Deploy the plugin through the admin console of your Appian Cloud site or by copying the plugin zip file to the plugins folder
  • Download the component from the App Market. The zip file "EWS Mail Poller applications.zip" contains sample applications for use with the plugin
  • Use the application, scripts, or XSDs that correspond to your database
  • Configure a Third Party Credentials entry in the admin console with the following parameters:
    • username: email identifier of the mailbox to poll. This is usually the part of the email address coming before the '@' character, but depending on the Exchange server may instead be the entire email address or domain\EmailAddress
    • password: password to access the mailbox
    • proxyUsername (or proxyusername) : username of the proxy account
    • proxyPassword (or proxypassword) : password of the proxy account

Key Features & Functionality

Smart service "EWS Mail Poller To DB":

  • Reads the mailbox using the EWS web service API
  • Convert the email to an EWM file stored as an Appian document
  • Store all email attachments as Appian documents
  • Store all email metadata (subject, author, recipients, etc...) into a set of tables in the database

To use this plug-in:

  • Create a process model to invoke the plugin on a schedule basis like every few minutes
  • Configure a Secure Credential Store with the following attributes
  • Configure the smart service plugin with the required inputs including the name of the Secured Credential Store created above

By default, the emails successfully processed are moved to the folder Deleted Items and the emails that cannot be processed are moved to the folder Junk E-mails.

Anonymous
  • Hi,

    We would like if this plugin can be used to read emails from shared mailboxes.

    We have a single user(application user) with privileges to access to multiple mailboxes but we are not sure about how to use this plugin to archive our goal.

    Thank you.

  • Hi 

    I have tried to deploy the provided Application package in Appian 18.4 since the mentioned compatible version is 18.2+

    But I'm getting the error stating that the provided package was exported on the version 19.1

    Is it possible to get the package that will support for the version 18.4

    Thanks in advance

  • Sylvain, I have a follow-up question regarding the time limit configuration in the EWS Email poller. It states that


    Time Limit - Integer - No - The maximum amount of time in milliseconds to continue processing email while the mailbox is not empty. Default 60,000 (1 minute). If more email remain after the time limit, they will be processed on the next execution of this smart service. If all email is processed before the time limit is reached the node will end early. A minimum of 1 and maximum of 59 minutes can be configured.

    It appears from the description that the poller will only work for a maximum of 59 minutes and will need to be somehow re-triggered on the next execution of the smart service ? Is this true ? If yes, would we have to configure some kind of timer to do this ?

  • I will update the app market component to include the app containing the CDTs

  • Also, put in a ticket with Appian Customer premier support (ticket :485140) but the response I received was that this was outside their purview as it is a plugin.  They asked that I post a comment here.

  • Sylvain,  We have the same question as well as the documentation is missing the scripts.

  • Hi Sylvain. We have just downloaded this plugin and are wondering how we go about creating the required database tables as there isn't any mention of the actual table names or columns required? thanks

  • is this plugin having compatibility with 18.1?

  • As mentioned in the description: 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 EWS web services API.

    No need to configure Appian for inbound email.

  • Can someone provide more information on how to use this plugin? Do we still need to configure appian to be able to receive emails? OR does this plugin by-passes the need to configure appian for inbound email?