Handling Email Response Replies
  • 30 Jul 2024
  • 3 Minutes to read
  • Dark
    Light

Handling Email Response Replies

  • Dark
    Light

Article summary

Overview

Assigned Forms can process responses directly via Email through via user Email Response or hyperlink redirection. Doing so allows Assignments to be completed within the sent Email, without the need to navigate to the Decisions. 


Configure Action Definitions

The following example demonstrates how to configure an Assigned Form to allow for completion via Email.

  1. Create or use an existing Flow
  2. In this Flow, configure or add an existing assignment.
  3. Once the Assignment has been added, under EMAIL > Email Response Handling, ensure that Can Respond Via Email is enabled.
  4. Add Action Definitions to the Assignment either under Email > Email Response Handling > Email Responses in the Properties panel, or through Assignment Setup.

    Providing Action Definitions for an Assignment will dictate the accepted response options a user can submit in an email. Below is an overview of each setting when adding an Action Definition.

    Email

    SettingDescription
    Can Respond Via EmailAllows responses to be sent via email. 
    Alternative ResponsesConfigures inputs that will be used as acceptable responses for this task. 
    Case SensitiveDetermines if the responses must be case sensitive 
    Allow FilesDetermines if Files can be sent along with the response

    Data

    Setting
    Outcome NameThe Outcome Name is used to set the name for the outcome path to the Assignment if a valid response is returned.
    Action NameThe Action Name sets the action name on right clicking an Assignment to use its specified outcome
    Allow Group ActionIf enabled, allows the action to be ran on multiple selected Assignments
    Allow Single ActionIf enabled, allows the action to be ran as a right click action.
    Has Comment OptionIf enabled, allows comments to be added to an Assignment.

    User Dialog

    Setting
    Dialog TitleSets the name for the "Mail to Link" response variable for the Assignment.
    Dialog MessageThe message that appears for the "Mail to Link" response variable

  5. Under Alternative Responses, provide the desired response options to indicate "Approval". 
  6. Under DATA, provide the desired Outcome and Action Name values. Then, ensure that Allow Group Action, Allow Single Action, and Has Comment Option are enabled, and click OK. 
  7. From the Assignment Setup window, click ADD once more and provide the desired settings for a "Denial" Action; ensure that Can Respond Via Email, Allow Group Action, Allow Single Action, and Has CommentOption are all enabled, then click OK. 
  8. Click DONE to save the Assignment Setup. 

Configuring Email Handling

  1. Back in the Properties of the Assigned Form, under EMAIL > Email Response Handling, select Email Response Only from the Email Handling dropdown. 
  2. Under Email To Suggest Handling > Body, select SHOW EDITOR. From the Merge Text Editor, configure the Body as demonstrated below, replacing each value found in the brackets with data added from the Folder Tree on the left. Then, click SAVE. 
    
    To Approve this please click the link below:
    [Mail to Link For Approved Response]
    
    
    
    To Deny please click the link below:
    [Mail to Link For Denial Response]
    
    [InlineResponse]
    [ResponseID]

  3. Back in the Properties tab of the Assigned Form, select Email When Response Does Not Match > Body. From the Merge Text Editor for the Does Not Match Body content, configure the Text as follows, then click SAVE. 

    Required ID
    The ResponseID variable needs to be present for both the Email To Suggest Handling and Email When Response Does Not MatchBody Text Editors. If this ID is left out, then the Assigned Form will throw an error
    Please provide a valid response. 
    
    [ResponseID]


  4. Check Get From Email Address From Inputs and specify an email in the From Email Address field. This allows email addresses to be passed in as an input to the step, overriding the default sender address.
  5. Connect any available Outcome Paths to the End step. Then, Save the Flow.

Process Email Response Flow

  1. After selecting an Email Handling selection for an Assignment, the Process Email Response checkbox appears within Properties > EMAIL > Email Response Handling > Email Processing Flow.

  2. After enabling the Property, select EDIT PROCESS EMAIL RESPONSE FLOW.
  3. This opens a Flow Designer. Administrators can define custom Email Handling for the Assignment instead of just completing the Assignment.

    The custom Flow will run after its affiliated Scheduled Job runs; therefore, an Email Workflow Response Scheduled Job monitoring the Email Server is required for the Flow to run.



Debug

  1. Run or Debug the Flow.
  2. Navigate to the Assignee's Email Inbox and open the Emailed Form. 
  3. From the Email, click either the Approval or Denial link. 
  4. In the resulting Email Body, provide a Comment in the designated location. Then click Send.
  5. Navigate to the Inbox of the Admin to verify that the Comments were properly received.

For further information on Forms, visit the Decisions Forum.



Was this article helpful?