Loop Email

The Loop Email action An instruction within a botflow. in a botflow Automated steps that you can design for each bot that will run. begins a loop that iterates through email messages.

For each Loop Email action created or deleted, a corresponding End Loop action is also created or deleted.

Using the Loop Email action, you can:

• Set the exact number of times to repeat an email action in a botflow Automated steps that you can design for each bot that will run..
• Set an email action to repeat until instructed to end with an Exit Loop action.

Some examples of using the Loop Email action are to:

• Loop a Save Attachment action to download attachments from emails.
• Loop a Move Email action to move processed emails to another folder.
• Perform a Delete Email action to delete all unneeded emails.

Add a Loop Email action to a botflow

This example provides the steps necessary to add a Loop Email action to a Botflow.

To add a Loop Email action to a botflow:

1. Create a Credential to use your email account authentication from within the botflow.

To create a credential:

1. Click Add Item () on the Botflow Pane.
2. Select Credential.
3. Type a Name for the credential.
4. Type a unique Username.
   Note: 

   • The username cannot match the name of any other credential in the botflow.
   • For email, the username is the email address.
5. If needed, type the value of the Password and confirm it to ensure that the correct value has been submitted.
   Note: 

   • On May 30, 2022, basic access authentication for Gmail was deprecated and less secure apps are no longer supported. If you are using App Passwords to send or get email from a Gmail inbox, those passwords will continue to work. If you want to use full OAuth authentication for additional security and standardization, you can transition to it with Nintex Bot 17.10.0 or later.

   • On December 31, 2022, basic authentication for Microsoft Exchange Online was deprecated. If you want to use full OAuth authentication for additional security and standardization, you can transition to it with Nintex Bot 17.10.0 or later.

6. (Optional) Click + (plus sign) in the Additional Fields table header to add optional fields.
   1. Type a Name for the field.
   2. Type the Value to send to the application.
   3. Click OK.
7. (Optional) Select the Never save protected values with botflow check box.

Note: In compliance with companies that have a policy against saved passwords, when selected, neither the password nor any of the Additional Field values are saved in the botflow. This option is for use in an attended bot situation where the user must first enter the password and/or Additional Field values before botflow runs, either by using the Credential Prompt action or by manually setting those values.

8. (Optional) Type a Note to document special instructions or functionality.
9. Click OK to save the credential.
2. Add an email account to your botflow.

To create an email account:

1. Click Add Item () on the Botflow Pane.
2. Click Email.
• Account
  • Letter: Displays the default connection letter A specific letter used by Nintex RPA LE to communicate with an external application when a Nintex RPA LE action runs..
  • Email: Displays the email account information created in Credentials. If more than one credential is available, select the required credential from the drop-down list.
  • Send Mail As: Type an email display name for the email From field.
  • Authentication: Select an authentication method:

    • None. Users can send, but not receive, emails.

    • OAuth2. Select if you are using full OAuth authentication for Gmail. This does not require a password for login after a token has been received from the provider. In order to receive the token, allow Google to access your Nintex RPA LE account.

    • App Pasword. This requires a SMTP password for login.

    • Basic. This requires a SMTP password for login.

  • Confirm Password: Type the email authentication password.
    Note: 

    • On May 30, 2022, basic access authentication for Gmail was deprecated and less secure apps are no longer supported. If you are using App Passwords to send or get email from a Gmail inbox, those passwords will continue to work. If you want to use full OAuth authentication for additional security and standardization, you can transition to it with Nintex Bot 17.10.0 or later.

    • On December 31, 2022, basic authentication for Microsoft Exchange Online was deprecated. If you want to use full OAuth authentication for additional security and standardization, you can transition to it with Nintex Bot 17.10.0 or later.

  • Purpose: Select to:
    • Send & Receive: Both the Send Email (SMTP) settings and the Receive Email (IMAP) settings must be configured.
    • Send only: Only the Send Email (SMTP) settings must be configured.
    • Receive only: Only Receive Email (IMAP) settings must be configured.
  • Test Connection: Click to validate the email account information. If the test is successful, a test email is sent to the email address provided in the Email field.
    
• Send Email (SMTP)
  • Server: Type the SMTP server name or IP address.
  • Port: Type the required port number.
  • SSL: Select Yes to send email using SSL.
• Receive Email (IMAP)
  • Server: Type the IMAP Server name or IP address.
  • Port: Type the required port number.
  • SSL: Select Yes to receive email using SSL.
Note: 

 

If you are using full OAuth authentication for Gmail, you must enable IMAP access. In the Gmail account Settings, go to Settings > Forwarding and POP/IMAP > IMAP access > Enable IMAP. Nintex Bot uses the following Gmail OAuth authentication server settings:

SMTP server settings

Server: smtp.gmail.com

Port: 587

Authentication: TLS/STARTTLS

 

IMAP server settings

Server: imap.gmail.com

Port: 993

Authentication: SslOnConnect


3. On the Actions List, click Email and then click Loop Email from the Email list.

The Loop Email Action Builder window displays.

4. Set the Loop Email settings.

Show arrow: The Show arrow check box is selected and can't be cleared.

5. If needed, adjust the Rule settings to modify how Nintex Bot finds the application target.
6. View the action Details settings.
7. If needed, adjust the Run Switch setting to create the action without running it.

8. Optionally, add an action note.
9. Click OK to add the Loop Email action to the botflow.