Handling Task Assignment Via Email Response or Embedded Links

Last Updated: 08/10/2016 Introduced in Verision: 2.0

Assigned forms can process responses directly via email through (1) a user replying to an email with an answer, (2) from a user clicking a link in an email, or (3) offering both options. This means that to respond, users don’t need to open the assigned form in the Portal and click a button to respond. They can instead reply directly via one of these two email-based options and the form will take the path specified by the response.

Before creating your first flow to handle responses via email, first configure an Email Response Job. For an explanation of how to do that, please see Setting Up Email Response Job.
Now that your response job is configured, create a new flow with an assigned form.
Since we will be handling responses outside the context of the form (where normally responses would be handed via buttons on the form), we need to define the alternate paths that will be allowed out of this form. To do this, add as many outcomes as you need in the Outcomes > Action Based Outcomes section. (Note: each path will become a link you can provide as a possible response, and each Alternative Response defines a word or phrase that users can enter in their reply email to take this path).
You will see the email response options listed in the Handle via Email section of the form properties.
Here is a brief description of what each of these options do:
  • None: This option does not handle email responses so users must respond to their assignment by opening the form directly
  • EmailResponse: To respond via email, users will need to send a reply email with specified text between two tags in the email body.
  • Links: To respond via email, users will need to click response links that are provided in their assignment email.
  • Default: Allows the responses of either or both EmailResponse and Links
Now we will look at these options in detail.
When you select this option, you will see two sub sections appear: Email to Suggest Handling and Email When Response Does Not Match
First configure the Email to Suggest Handling email. This email will be sent to the user when the assignment is made and should provide them with instructions on which responses are allowed.
After describing what reply options are allowed, include the [InlineResponse] variable and the [ResponseID]. The [InlineResponse] variable will cause the following two two special lines to appear in your email: 
— Reply Below Here —
— Reply Above Here —

The [ResponseID] variable will add a unique code to the email so that the response job knows to which flow this email is in response.


When this form is assigned, the assignee will receive the email configured above and will be able to respond in line to that email using one of the approved responses.
In case a user replies with a response that is not handled (i.e. “Sure that sounds fine”), we need to configure an email that replies to them letting them know they used a response that is not handled. This can be done in the Email When Response Does Not Match email.
The links option for response allows you to include links the user can click on to provide their response. Each of the paths you configured above in the Outcomes > Action Based Outcomes section will show up as a possible link to choose from.
Since we will be using unique links to provide the response, no [ResponseID] field is necessary in the email body. We also don’t need to configure an Email When Response Does Not Match email.
In this case, the user will receive the email above and can provide their response by clicking one of the two links provided.
This option is nothing more than a combination of the above two options. In using the response type, you can build an email with both links and inline responses giving users two options on how to reply.



Additional Resources